Hi Carl,

If I understand correctly, the program reference already contains
the complete list of user-settable properties for each grob.

Not in a single page.

you can't say that the default value of property "foo" is "bar". It might
be "bar" when applied to the "grackle" grob, and "baz" when applied to
the "frobozz" grob.

But that's precisely my point!  =\

Q.  What is the default X-offset value of a LyricText grob?
A.  Not easy to find!  ;-)

Because there is no (easy) way of finding these values, it requires more trial-and-error on the part of the user.

Thus, there is only one internal documentation
point for "size", not one point for each grob that uses size.

Yes, but these values are (i.e., must be) set for each grob *somewhere* (in .ly or .scm or .cc files), right? And if they're intentionally left "unset", what does that really mean? That (e.g.) an Accidental doesn't have a minimum-X-extent?

If feasible (i.e., scriptable, so it's automatically done at make- docs time), we should offer users a single page (for each grob) which includes ALL settable properties and their default values (for that grob).

Now, if it's not technically feasible, I'm happy to end this thread...
I've just never been told that it's not feasible.  =)

Cheers,
Kieren.


_______________________________________________
lilypond-devel mailing list
[email protected]
http://lists.gnu.org/mailman/listinfo/lilypond-devel

Reply via email to