On Thu, Jul 30, 2009 at 11:06:59AM -0700, Mark Polesky wrote:
It would be nice to have some central place that explains some
"internals" concepts. Here are examples of things that a new developer
might have to ask about, or perhaps spend a long time disentangling:
grob
prob
smob
output-def
callback
simple-closure
It would be nice to have a LilyPond-specific glossary, that users could
also use. For example, a user might get "glyph" and "stencil" confused.
I still get "command" "keyword" "identifier" and "variable" confused.
I still don't know the difference between "parser" and "lexer". You get
the idea.
I like this idea.
Having a list in an NR appendix would be just fine with me.
However, it would be difficult to auto-generate a lot of this
documentation, because not all of it is defined in LilyPond's
internals:
grob - LilyPond
prob - LilyPond
smob - Guile
output-def - LilyPond
callback - Programming concept
simple-closure - Programming concept
etc...
Thanks,
Patrick