From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#13292: 24.3.50; wrong sytax description in (elisp) Case Tables Date: Sat, 29 Dec 2012 10:30:17 +0200 Message-ID: <83txr5l0py.fsf@gnu.org> References: <83a9sym8q8.fsf@gnu.org> <83623mm3lh.fsf@gnu.org> <851ue9ofyk.fsf@iznogoud.viz> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1356769868 5650 80.91.229.3 (29 Dec 2012 08:31:08 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 29 Dec 2012 08:31:08 +0000 (UTC) Cc: 13292@debbugs.gnu.org To: Wolfgang Jenkner Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Dec 29 09:31:24 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1TorpD-000404-Ka for geb-bug-gnu-emacs@m.gmane.org; Sat, 29 Dec 2012 09:31:23 +0100 Original-Received: from localhost ([::1]:51917 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Toroy-0001V3-VQ for geb-bug-gnu-emacs@m.gmane.org; Sat, 29 Dec 2012 03:31:08 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:57048) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Torow-0001Uy-Ll for bug-gnu-emacs@gnu.org; Sat, 29 Dec 2012 03:31:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Torov-0001x2-Dj for bug-gnu-emacs@gnu.org; Sat, 29 Dec 2012 03:31:06 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:53549) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Torov-0001wy-9u for bug-gnu-emacs@gnu.org; Sat, 29 Dec 2012 03:31:05 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1Torpp-0005Lu-WE for bug-gnu-emacs@gnu.org; Sat, 29 Dec 2012 03:32:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 29 Dec 2012 08:32:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 13292 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 13292-submit@debbugs.gnu.org id=B13292.135676988320524 (code B ref 13292); Sat, 29 Dec 2012 08:32:01 +0000 Original-Received: (at 13292) by debbugs.gnu.org; 29 Dec 2012 08:31:23 +0000 Original-Received: from localhost ([127.0.0.1]:35567 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TorpC-0005Kz-OL for submit@debbugs.gnu.org; Sat, 29 Dec 2012 03:31:23 -0500 Original-Received: from mtaout20.012.net.il ([80.179.55.166]:58903) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Torp9-0005Kq-Ri for 13292@debbugs.gnu.org; Sat, 29 Dec 2012 03:31:21 -0500 Original-Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0MFS00J009U24400@a-mtaout20.012.net.il> for 13292@debbugs.gnu.org; Sat, 29 Dec 2012 10:30:09 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MFS00I12AA8WJB0@a-mtaout20.012.net.il>; Sat, 29 Dec 2012 10:30:09 +0200 (IST) In-reply-to: <851ue9ofyk.fsf@iznogoud.viz> X-012-Sender: halo1@inter.net.il X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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:69143 Archived-At: > From: Wolfgang Jenkner > Cc: eliz@gnu.org, drew.adams@oracle.com > Date: Sat, 29 Dec 2012 01:21:05 +0100 > > On Fri, Dec 28 2012, Eli Zaretskii wrote: > > >> From: "Drew Adams" > [...] > >> In that case, there are bugs in the other direction, in other nodes of the > >> manual - nodes that use uppercase for parameters. > >> > >> For example: > >> > >> `A Sample Function Description' - `count-loop' > >> `Syntax Table Functions' - `with-syntax-table' > >> `Using Lexical Binding' - `special-variable-p' > >> `Syntax Table Internals' - `string-to-syntax' > >> `Declare Form' - `declare' > >> > >> Note that `A Sample Function Description' is the very place where we explain the > >> syntax convention and give an example of it. Not a good place to set a bad > >> example. > > > > It's not bad. This is done on purpose, see the Texinfo sources, which > > use @var in this case. > > But other "imaginary" example definitions in intro.texi don't use @var. > Nor does any "real" @defspec in doc/lispref use that. The Texinfo manual is ambiguous wrt this issue. It allows using @var in some cases. The result in print is a slightly different typeface; in contrast, the result in the Info output is VERY different. However, since the references to the arguments in the text _always_ use @var, so are rendered in CAPS in Info, I consider this bug report a rather petty and even an overly-pedantic one. > Also, in contrast to the makeinfo program, texinfo-format-region would > produce > > -- Special form: count-loop (VAR [FROM TO [INC]]) BODY... > > in both cases, with or without @var. Perhaps, that's the reason that > nobody noticed at the time? I doubt that, as no one uses texinfo-format-region anymore, since it doesn't support so many Texinfo features introduced in recent years. > So is there anything wrong with Drew's revised suggestion (as > I understand it)? See above. That said, I don't want to argue anymore, so I installed your changes on the emacs-24 branch; thanks.