GNU bug report logs - #9482
Documentation bug: Emacs Lisp Manual should say quoting does not cons explicitly in quoting section. related to bug#9469

Previous Next

Package: emacs;

Reported by: Le Wang <l26wang <at> gmail.com>

Date: Mon, 12 Sep 2011 15:06:01 UTC

Severity: minor

Done: Stefan Monnier <monnier <at> iro.umontreal.ca>

Bug is archived. No further changes may be made.

Full log


View this message in rfc822 format

From: Le Wang <l26wang <at> gmail.com>
To: Stefan Monnier <monnier <at> iro.umontreal.ca>
Cc: 9482 <at> debbugs.gnu.org
Subject: bug#9482: specific manual text suggestion
Date: Tue, 13 Sep 2011 21:25:28 +0800
Hi Stefan,

As I mentioned in this bug.  The manual already has an example of this
trap in the nconc section.  Maybe just a pointer to it.

So my suggestion for specific text would be:

"WARNING: '(a . b) is not short-hand for (cons 'a 'b).  The former
does not cons.  Quoting should be reserved for constants that will
*NEVER* change.  See <link>nconc</link> for example of unexpected
results when a quoted object is modified."

My terminology may be not quite right, but if I read something like
this, the difference would be much clearer.

-- 
Le




This bug report was last modified 13 years and 250 days ago.

Previous Next


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