From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: Small but confusing doc error in easy-menu-define Date: Fri, 13 Apr 2007 08:37:22 -0400 Message-ID: References: <461D5C8A.3010704@gmail.com> <461E898B.5010005@gmail.com> <461E9163.8000300@gmail.com> <200704122009.l3CK9vbq021082@jane.dms.auburn.edu> <461E943E.2020801@gmail.com> <47609.128.165.123.18.1176414391.squirrel@webmail.lanl.gov> <461EB170.1030304@gmail.com> <48170.128.165.123.18.1176422142.squirrel@webmail.lanl.gov> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1176467882 15893 80.91.229.12 (13 Apr 2007 12:38:02 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 13 Apr 2007 12:38:02 +0000 (UTC) Cc: lekktu@gmail.com, "Lennart Borgman \(gmail\)" , Luc Teirlinck , emacs-devel@gnu.org To: herring@lanl.gov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Apr 13 14:37:59 2007 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1HcL2M-0007dy-NP for ged-emacs-devel@m.gmane.org; Fri, 13 Apr 2007 14:37:58 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HcL6d-0006cW-0T for ged-emacs-devel@m.gmane.org; Fri, 13 Apr 2007 08:42:23 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1HcL69-0006Qd-0r for emacs-devel@gnu.org; Fri, 13 Apr 2007 08:41:53 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1HcL67-0006Pz-F6 for emacs-devel@gnu.org; Fri, 13 Apr 2007 08:41:52 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HcL67-0006Pr-6a for emacs-devel@gnu.org; Fri, 13 Apr 2007 08:41:51 -0400 Original-Received: from tomts16.bellnexxia.net ([209.226.175.4] helo=tomts16-srv.bellnexxia.net) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1HcL1p-0001uk-Nh for emacs-devel@gnu.org; Fri, 13 Apr 2007 08:37:26 -0400 Original-Received: from pastel.home ([70.55.146.182]) by tomts16-srv.bellnexxia.net (InterMail vM.5.01.06.13 201-253-122-130-113-20050324) with ESMTP id <20070413123723.GMRF1673.tomts16-srv.bellnexxia.net@pastel.home> for ; Fri, 13 Apr 2007 08:37:23 -0400 Original-Received: by pastel.home (Postfix, from userid 20848) id 2A7A67F71; Fri, 13 Apr 2007 08:37:22 -0400 (EDT) In-Reply-To: <48170.128.165.123.18.1176422142.squirrel@webmail.lanl.gov> (Davis Herring's message of "Thu\, 12 Apr 2007 16\:55\:42 -0700 \(PDT\)") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.0.96 (gnu/linux) X-detected-kernel: Solaris 8 (1) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:69390 Archived-At: > Yes, yes it does. In this case, it means that the symbol named "symbol" > (described, as per usual, as SYMBOL in the doc string), which is bound to > the appropriate argument value when the function is called, has a value > that is not nil (and, by implication of the symbol's name ("symbol"), is > some other symbol instead). I think it's a much better idea to distinguish variables from symbols. SYMBOL is a variable whose value should be a symbol. Symbols have several different fields, including a "value" field, a "function" field and a "property-list" field. Stefan