From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Davis Herring" Newsgroups: gmane.emacs.devel Subject: Re: Small but confusing doc error in easy-menu-define Date: Thu, 12 Apr 2007 16:55:42 -0700 (PDT) Message-ID: <48170.128.165.123.18.1176422142.squirrel@webmail.lanl.gov> 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> Reply-To: herring@lanl.gov NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain;charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Trace: sea.gmane.org 1176422155 22396 80.91.229.12 (12 Apr 2007 23:55:55 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 12 Apr 2007 23:55:55 +0000 (UTC) Cc: lekktu@gmail.com, Luc Teirlinck , monnier@iro.umontreal.ca, emacs-devel@gnu.org To: "Lennart Borgman (gmail)" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Apr 13 01:55:54 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 1Hc98o-0004dH-Rv for ged-emacs-devel@m.gmane.org; Fri, 13 Apr 2007 01:55:51 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Hc9D1-0000jT-N5 for ged-emacs-devel@m.gmane.org; Thu, 12 Apr 2007 20:00:11 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Hc9Cy-0000jO-0G for emacs-devel@gnu.org; Thu, 12 Apr 2007 20:00:08 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Hc9Cx-0000jC-01 for emacs-devel@gnu.org; Thu, 12 Apr 2007 20:00:07 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Hc9Cw-0000j9-Qk for emacs-devel@gnu.org; Thu, 12 Apr 2007 20:00:06 -0400 Original-Received: from mailwasher.lanl.gov ([192.65.95.54] helo=mailwasher-b.lanl.gov) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1Hc98j-0002Df-4g for emacs-devel@gnu.org; Thu, 12 Apr 2007 19:55:45 -0400 Original-Received: from mailrelay1.lanl.gov (mailrelay1.lanl.gov [128.165.4.101]) by mailwasher-b.lanl.gov (8.13.8/8.13.8/(ccn-5)) with ESMTP id l3CNthqY025631 for ; Thu, 12 Apr 2007 17:55:44 -0600 Original-Received: from webmail1.lanl.gov (webmail1.lanl.gov [128.165.4.106]) by mailrelay1.lanl.gov (8.13.8/8.13.8/(ccn-5)) with ESMTP id l3CNtgwQ024907; Thu, 12 Apr 2007 17:55:42 -0600 Original-Received: from webmail1.lanl.gov (localhost.localdomain [127.0.0.1]) by webmail1.lanl.gov (8.12.11.20060308/8.12.11) with ESMTP id l3CNtgoA030720; Thu, 12 Apr 2007 17:55:42 -0600 Original-Received: (from apache@localhost) by webmail1.lanl.gov (8.12.11.20060308/8.12.11/Submit) id l3CNtgxp030718; Thu, 12 Apr 2007 16:55:42 -0700 X-Authentication-Warning: webmail1.lanl.gov: apache set sender to herring@lanl.gov using -f Original-Received: from 128.165.123.18 (SquirrelMail authenticated user 196434) by webmail.lanl.gov with HTTP; Thu, 12 Apr 2007 16:55:42 -0700 (PDT) In-Reply-To: <461EB170.1030304@gmail.com> User-Agent: SquirrelMail/1.4.8-4.el3.2lanl X-Priority: 3 (Normal) Importance: Normal X-PMX-Version: 4.7.1.128075 X-detected-kernel: Linux 2.4-2.6 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:69359 Archived-At: > It is different level of abstraction, isn't it? Does not "non-nil" in > Emacs doc usually means that a symbol value is not nil? 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). Now, if you're talking about the value of the passed symbol as a variable, I think you'd need to say something to the effect of "If SYMBOL's value as a variable is non-nil, ...", but that's not what's meant. Davis -- This product is sold by volume, not by mass. If it appears too dense or too sparse, it is because mass-energy conversion has occurred during shipping.