[Top][All Lists]

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

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

From: David Kastrup
Subject: Re: [Bug-AUCTeX] font-latex-user-keyword-classes doc
Date: Wed, 03 Oct 2007 12:28:29 +0200
User-agent: Gnus/5.11 (Gnus v5.11) Emacs/22.1.50 (gnu/linux)

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

David Kastrup, Kriemhildstr. 15, 44793 Bochum

reply via email to

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