GNU bug report logs - #9711
24.0.50; doc string of defcustom

Previous Next

Package: emacs;

Reported by: "Drew Adams" <drew.adams <at> oracle.com>

Date: Sun, 9 Oct 2011 20:03:01 UTC

Severity: minor

Found in version 24.0.50

Done: Chong Yidong <cyd <at> gnu.org>

Bug is archived. No further changes may be made.

Full log

Message #8 received at 9711 <at> debbugs.gnu.org (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <9711 <at> debbugs.gnu.org>
Subject: RE: bug#9711: 24.0.50; doc string of defcustom
Date: Sun, 9 Oct 2011 13:16:25 -0700

In addition, this seems wrong:

"Neither SYMBOL nor VALUE need to be quoted."

Huh?  VALUE is evaluated.  What is meant by this statement?

Evaluate this, and you get a `void-variable' error for `jjjjjj'.

(defcustom foo jjjjjj "kkkkkkk" :type sexp)

That doc-string statement is bogus, AFAICT.

The Elisp manual is OK: it says "you should not quote OPTION" (which corresponds
to SYMBOL in the doc string), and it says "Evaluating the `defcustom' form
evaluates STANDARD" (which corresponds to VALUE in the doc string).

Aside from making the grammar INcorrect (it was correct before) by changing
"needs" to "need", the bogus statement "Neither SYMBOL nor VALUE need to be
quoted." is unchanged from Emacs 20.
This bug report was last modified 13 years and 103 days ago.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.