[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: regression tests

From: Kieren MacMillan
Subject: Re: regression tests
Date: Tue, 11 Sep 2007 13:16:18 -0400

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.  =)


reply via email to

[Prev in Thread] Current Thread [Next in Thread]