emacs-devel
[Top][All Lists]
Advanced

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

Re: Leading * in docstrings of defcustoms.


From: Chong Yidong
Subject: Re: Leading * in docstrings of defcustoms.
Date: Mon, 24 Nov 2008 15:36:43 -0500
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (gnu/linux)

"Drew Adams" <address@hidden> writes:

> If you do remove `*' from defcustoms, please also update the manuals
> accordingly.

They should already be omitted, or strongly deprecated, in the manuals.
For example, the Variable Definitions node in the Lisp manual says

  There is no need to start [the docstring] with a `*', because
  `defcustom' automatically marks `option' as a "user option"

If you find a spot in the manual that still follows the old convention,
please let us know.

> Why is it that `*' should be removed from defcustoms? Is it simply
> because they don't need it?

Yes.




reply via email to

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