Re: [Bug-AUCTeX] font-latex-user-keyword-classes doc

[David Kastrup]

Ralf Angeli <address@hidden> writes:

> * David Kastrup (2007-10-03) writes:
>
>> Hm? Just explaining the available semantics by referring to the actual
>> values is not actually doing anything different.  While I agree that
>> one can use such a customize-only explanation in the manual, I think
>> that the DOC string for a variable should help with understanding the
>> code, not just the customization.
>
> The doc string shows up in the customization buffer.  And that's where I
> wanted to have a description for the user, not the developer.  I could
> perhaps as a compromise add the developer-aimed documentation as a
> comment to the defcustom code.

It is not going to help the developer using C-h v when looking at the
code using the variable.  Nobody is interested in the source code of
the defcustom or would think of looking there for the relevant
information.

-- 
David Kastrup, Kriemhildstr. 15, 44793 Bochum