From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.bugs Subject: bug#9482: specific manual text suggestion Date: Fri, 16 Sep 2011 10:14:39 -0400 Message-ID: References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1316182536 11814 80.91.229.12 (16 Sep 2011 14:15:36 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 16 Sep 2011 14:15:36 +0000 (UTC) Cc: 9482-done@debbugs.gnu.org To: Le Wang Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Sep 16 16:15:32 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1R4ZCW-0008N0-5T for geb-bug-gnu-emacs@m.gmane.org; Fri, 16 Sep 2011 16:15:32 +0200 Original-Received: from localhost ([::1]:42204 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1R4ZCV-0001eX-H8 for geb-bug-gnu-emacs@m.gmane.org; Fri, 16 Sep 2011 10:15:31 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:38139) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1R4ZCN-0001eM-VO for bug-gnu-emacs@gnu.org; Fri, 16 Sep 2011 10:15:29 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1R4ZCJ-0002gH-Kl for bug-gnu-emacs@gnu.org; Fri, 16 Sep 2011 10:15:23 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:38449) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1R4ZCJ-0002gA-DL for bug-gnu-emacs@gnu.org; Fri, 16 Sep 2011 10:15:19 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1R4ZGt-0007oT-8s for bug-gnu-emacs@gnu.org; Fri, 16 Sep 2011 10:20:03 -0400 Resent-From: Stefan Monnier Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Fri, 16 Sep 2011 14:20:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 9482 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Mail-Followup-To: 9482@debbugs.gnu.org, monnier@iro.umontreal.ca Original-Received: via spool by 9482-done@debbugs.gnu.org id=D9482.131618276729983 (code D ref 9482); Fri, 16 Sep 2011 14:20:02 +0000 Original-Received: (at 9482-done) by debbugs.gnu.org; 16 Sep 2011 14:19:27 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1R4ZGJ-0007nY-Cv for submit@debbugs.gnu.org; Fri, 16 Sep 2011 10:19:27 -0400 Original-Received: from ironport2-out.teksavvy.com ([206.248.154.181] helo=ironport2-out.pppoe.ca) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1R4ZGH-0007nR-EY for 9482-done@debbugs.gnu.org; Fri, 16 Sep 2011 10:19:26 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: AjEFAJ9Yc05FpYYd/2dsb2JhbABBpV6BfHiBUwEBBAFWIwULCw4mEhQYDSSICrRlhngEoE6ERA X-IronPort-AV: E=Sophos;i="4.68,393,1312171200"; d="scan'208";a="136705561" Original-Received: from 69-165-134-29.dsl.teksavvy.com (HELO pastel.home) ([69.165.134.29]) by ironport2-out.pppoe.ca with ESMTP/TLS/ADH-AES256-SHA; 16 Sep 2011 10:14:40 -0400 Original-Received: by pastel.home (Postfix, from userid 20848) id BA3AE58F87; Fri, 16 Sep 2011 10:14:39 -0400 (EDT) In-Reply-To: (Le Wang's message of "Tue, 13 Sep 2011 21:25:28 +0800") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Fri, 16 Sep 2011 10:20:03 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:51223 Archived-At: > My terminology may be not quite right, but if I read something like > this, the difference would be much clearer. Thanks for your sample text. I tweaked it a bit to make it hopefully even more explicit, see patch below. Stefan --- src/eval.c 2011-09-09 01:06:52 +0000 +++ src/eval.c 2011-09-16 14:09:39 +0000 @@ -475,6 +475,14 @@ DEFUN ("quote", Fquote, Squote, 1, UNEVALLED, 0, doc: /* Return the argument, without evaluating it. `(quote x)' yields `x'. +Warning: `quote' does not construct its return value, but just returns +the value that was pre-constructed by the Lisp reader (see info node +`(elisp)Printed Representation'). +This means that '(a . b) is not identical to (cons 'a 'b): the former +does not cons. Quoting should be reserved for constants that will +never be modified by side-effects, unless you like self-modifying +code. See the common pitfall in info node `(elisp)Rearrangement' for +an example of unexpected results when a quoted object is modified. usage: (quote ARG) */) (Lisp_Object args) {