Re: [PATCH] Docs: IR: Move 'details to user grob property list

[Patrick McCarty]

On Fri, Apr 3, 2009 at 12:21 PM, Carl D. Sorensen <address@hidden> wrote:
>
> On 4/2/09 5:31 PM, "Patrick McCarty" <address@hidden> wrote:
>
>> Hello,
>>
>> This patch moves the 'details property from the internal to the user
>> grob property list.
>
> I believe that moving 'details from internal to user won't have the effect
> we want.  I believe that internal properties are set by the grob, rather
> than being read from the context.  So I think that even if the user sets
> them in the input file, the value will be overwritten during the
> calculation.

It depends on whether the internal property is a *real* internal
property (unable to be modified by the user), or if it's documented
incorrectly in the Internals Reference.  I believe the latter is the
case with 'details.

>> Occasionally, someone recommends tweaking a subproperty of 'details,
>> so it is helpful to see the default settings documented in the
>> Internals Reference.
>
> Unfortunately, there are different 'details lists for different grobs,
> so there's not a generic set of defaults that we can list, if I understand
> correctly.

If 'details is moved to the list of user grob properties, then every
grob containing default settings for 'details will have the
appropriate values listed in the Internals Reference.  After `make
web', here are two pages that benefit from this change:

http://uoregon.edu/~pmccarty/texi2html/Stem.html
http://uoregon.edu/~pmccarty/texi2html/Slur.html

Currently, if someone wants to find the default values for 'details,
they have to search through scm/define-grobs.scm.


Thanks,
Patrick