From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Bill Wohler Newsgroups: gmane.emacs.devel,gmane.mail.mh-e.devel Subject: Re: MH-E manual update Date: Sat, 11 Mar 2006 15:34:14 -0800 Organization: Newt Software Message-ID: <13957.1142120054@olgas.newt.com> References: <27306.1134088031@olgas.newt.com> <871wxfnisy.fsf@olgas.newt.com> <9353.1142107690@olgas.newt.com> <200603112135.k2BLZJE22058@raven.dms.auburn.edu> <11886.1142116037@olgas.newt.com> <200603112308.k2BN8CO23003@raven.dms.auburn.edu> NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1142120088 10120 80.91.229.2 (11 Mar 2006 23:34:48 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 11 Mar 2006 23:34:48 +0000 (UTC) Cc: eliz@gnu.org, mh-e-devel@lists.sourceforge.net, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Mar 12 00:34:46 2006 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1FIDbc-0001lU-GA for ged-emacs-devel@m.gmane.org; Sun, 12 Mar 2006 00:34:41 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FIDbc-0001iP-0e for ged-emacs-devel@m.gmane.org; Sat, 11 Mar 2006 18:34:40 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1FIDbP-0001iA-JU for emacs-devel@gnu.org; Sat, 11 Mar 2006 18:34:27 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1FIDbM-0001hy-KP for emacs-devel@gnu.org; Sat, 11 Mar 2006 18:34:26 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FIDbM-0001hv-EE for emacs-devel@gnu.org; Sat, 11 Mar 2006 18:34:24 -0500 Original-Received: from [207.69.195.72] (helo=pop-sarus.atl.sa.earthlink.net) by monty-python.gnu.org with esmtp (Exim 4.52) id 1FIDev-00020D-Bo; Sat, 11 Mar 2006 18:38:05 -0500 Original-Received: from h-68-165-5-58.snvacaid.dynamic.covad.net ([68.165.5.58] helo=olgas.newt.com) by pop-sarus.atl.sa.earthlink.net with esmtp (Exim 3.36 #10) id 1FIDbC-0002l5-00; Sat, 11 Mar 2006 18:34:14 -0500 Original-Received: by olgas.newt.com (Postfix, from userid 1000) id 451F11707E; Sat, 11 Mar 2006 15:34:14 -0800 (PST) Original-Received: from olgas.newt.com (localhost [127.0.0.1]) by olgas.newt.com (Postfix) with ESMTP id 42D7C16FA9; Sat, 11 Mar 2006 15:34:14 -0800 (PST) Original-To: Luc Teirlinck In-reply-to: <200603112308.k2BN8CO23003@raven.dms.auburn.edu> Comments: In-reply-to Luc Teirlinck message dated "Sat, 11 Mar 2006 17:08:12 -0600." X-Mailer: MH-E 7.93+cvs; nmh 1.1; GNU Emacs 22.0.50.14 X-Image-URL: http://www.newt.com/wohler/images/bill-diving.png Mail-Followup-To: emacs-devel@gnu.org, mh-e-devel@lists.sourceforge.net 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:51499 gmane.mail.mh-e.devel:11947 Archived-At: Luc Teirlinck wrote: > Bill Wohler wrote: > > In (texinfo) code: > > Thus, you should use `@code' for an expression in a program, for the > name of a variable or function used in a program, or for a keyword in a > programming language. > > If we are in agreement, this paragraph should be amended to say "for the > name *or value* of a variable or function" since it would be > inconsistent and complicate usage to use @code for string values and > @samp for other values. > > It already says: "you should use `@code' for an expression in a program". > Strings in a program are expressions, be it constant ones. One writes: > "The standard value of this variable is @code{nil}", not @samp{nil}. > > ...with three exceptions in strings.texi and text.texi. A quick grep in > the Elisp manual didn't reveal any @samp{.*} (without quotes) that > looked like they might be a variable's value. > > I changed those three to use @code, since they were inconsistent with > the vast majority of similar cases. > > If we are in agreement, can someone who has the Texinfo manual checked > out make the clarification in the @code section? > > Karl Berry maintains that manual, but I am not immediately sure that a > change is called for, for the reasons explained above. Agreed. I'll fix these in the MH-E manual. -- Bill Wohler http://www.newt.com/wohler/ GnuPG ID:610BD9AD Maintainer of comp.mail.mh FAQ and MH-E. Vote Libertarian! If you're passed on the right, you're in the wrong lane.