From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Lennart Borgman (gmail)" Newsgroups: gmane.emacs.devel Subject: Re: Small but confusing doc error in easy-menu-define Date: Fri, 13 Apr 2007 00:23:44 +0200 Message-ID: <461EB170.1030304@gmail.com> 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> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1176416633 29738 80.91.229.12 (12 Apr 2007 22:23:53 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 12 Apr 2007 22:23:53 +0000 (UTC) Cc: lekktu@gmail.com, Luc Teirlinck , monnier@iro.umontreal.ca, 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 00:23:49 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 1Hc7hl-0006xt-D2 for ged-emacs-devel@m.gmane.org; Fri, 13 Apr 2007 00:23:49 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Hc7lx-0000MS-Oz for ged-emacs-devel@m.gmane.org; Thu, 12 Apr 2007 18:28:09 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Hc7lu-0000MM-Pt for emacs-devel@gnu.org; Thu, 12 Apr 2007 18:28:06 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Hc7ls-0000MA-7e for emacs-devel@gnu.org; Thu, 12 Apr 2007 18:28:05 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Hc7ls-0000M7-2U for emacs-devel@gnu.org; Thu, 12 Apr 2007 18:28:04 -0400 Original-Received: from ch-smtp02.sth.basefarm.net ([80.76.149.213]) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Hc7he-0000FM-QM for emacs-devel@gnu.org; Thu, 12 Apr 2007 18:23:43 -0400 Original-Received: from c83-254-145-24.bredband.comhem.se ([83.254.145.24]:60867 helo=[127.0.0.1]) by ch-smtp02.sth.basefarm.net with esmtp (Exim 4.63) (envelope-from ) id 1Hc7hZ-0001Cn-7W; Fri, 13 Apr 2007 00:23:38 +0200 User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.0.10) Gecko/20070221 Thunderbird/1.5.0.10 Mnenhy/0.7.5.666 In-Reply-To: <47609.128.165.123.18.1176414391.squirrel@webmail.lanl.gov> X-Antivirus: avast! (VPS 000733-0, 2007-04-11), Outbound message X-Antivirus-Status: Clean X-Scan-Result: No virus found in message 1Hc7hZ-0001Cn-7W. X-Scan-Signature: ch-smtp02.sth.basefarm.net 1Hc7hZ-0001Cn-7W d655ce20755af84f3c3115ec4fd1fc38 X-detected-kernel: Linux 2.6? (barebone, rare!) 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:69357 Archived-At: Davis Herring wrote: > The current documentation reads: > >> "If SYMBOL is non-nil, store the menu keymap in the value of symbol, >> and define symbol as a function to pop up the menu, with doc as its >> doc string." > > Lennart suggested: > >> "SYMBOL should be a symbol. If it is not the symbol nil ..." > > Obviously "If it is not the symbol nil" is the same as "If it is non-nil", > so we have the equivalent of "If SYMBOL (which should be a symbol) is > non-nil, ...". I fail to see the point in merely adding that an argument > named SYMBOL should be, um, a symbol. 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?