GNU bug report logs - #13292
24.3.50; wrong sytax description in (elisp) Case Tables

Previous Next

Full log

Message #23 received at 13292-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 13292-done <at> debbugs.gnu.org
Subject: Re: bug#13292: 24.3.50; wrong sytax description in (elisp) Case Tables
Date: Fri, 28 Dec 2012 20:30:34 +0200

> From: "Drew Adams" <drew.adams <at> oracle.com>
> Cc: <13292 <at> debbugs.gnu.org>
> Date: Fri, 28 Dec 2012 08:57:28 -0800
> 
> > > The parameters should be uppercase everywhere.
> > 
> > They never were.  This is how Info works.
> > Closing.
> 
> 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.

> Reopening.  There is clearly some cleanup to be done.

Reclosing.  Please stop this ridicule.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.