[debbugs-tracker] bug#30538: closed (Elisp manual doesn't say how to get a raw syntax descriptor of a character.)

[GNU bug Tracking System]

Your message dated Thu, 22 Feb 2018 18:43:09 +0000
with message-id <address@hidden>
and subject line Re: bug#30538: Elisp manual doesn't say how to get a raw 
syntax descriptor of a character.
has caused the debbugs.gnu.org bug report #30538,
regarding Elisp manual doesn't say how to get a raw syntax descriptor of a 
character.
to be marked as done.

(If you believe you have received this mail in error, please contact
address@hidden)


-- 
30538: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=30538
GNU Bug Tracking System
Contact address@hidden with problems
> --- Begin Message ---
>
>
>
> Subject: 
>
> Elisp manual doesn't say how to get a raw syntax descriptor of a character.
>
>
>
>
> Date: 
>
> Mon, 19 Feb 2018 20:32:33 +0000
>
>
>
>
> User-agent: 
>
> Mutt/1.7.2 (2016-11-26)
>
>
>
>
> Hello, Emacs.
>
> The title says it all.  Actually, in the early part of the Elisp manual,
> it does say that `aref' works on char-tables.  And around the syntax part
> of the manual, much later, it says that syntax tables are char-tables.
>
> This makes it far too much work for somebody to find out what to do.
> Therefore I suggest the following amendment, for Emacs-26:
>
>
>
> diff --git a/doc/lispref/syntax.texi b/doc/lispref/syntax.texi
> index b37f2b22b8..585ecf760d 100644
> --- a/doc/lispref/syntax.texi
> +++ b/doc/lispref/syntax.texi
> @@ -972,6 +972,9 @@ Syntax Table Internals
>  below.  @var{matching-char}, if address@hidden, specifies a matching
>  character (similar to the second character in a syntax descriptor).
>  
> +Use @code{aref} (@pxref{Array Functions}) to get the raw syntax
> +descriptor of a character, e.g. @code{(aref (syntax-table) ch)}.
> +
>    Here are the syntax codes corresponding to the various syntax
>  classes:
>  
>
>
> -- 
> Alan Mackenzie (Nuremberg, Germany).
>
>
>
> --- End Message ---
> --- Begin Message ---
>
>
>
> Subject: 
>
> Re: bug#30538: Elisp manual doesn't say how to get a raw syntax descriptor of a character.
>
>
>
>
> Date: 
>
> Thu, 22 Feb 2018 18:43:09 +0000
>
>
>
>
> User-agent: 
>
> Mutt/1.7.2 (2016-11-26)
>
>
>
>
> Hello, Eli.
>
> On Tue, Feb 20, 2018 at 20:57:58 +0200, Eli Zaretskii wrote:
> > > Date: Mon, 19 Feb 2018 20:32:33 +0000
> > > From: Alan Mackenzie <address@hidden>
>
> > > The title says it all.  Actually, in the early part of the Elisp manual,
> > > it does say that `aref' works on char-tables.  And around the syntax part
> > > of the manual, much later, it says that syntax tables are char-tables.
>
> > > This makes it far too much work for somebody to find out what to do.
> > > Therefore I suggest the following amendment, for Emacs-26:
>
> > OK, but:
>
> >   . this should have an appropriate index entry, to allow finding this
> >     stuff easily
> >   . please take the code snipped in @w{..}, to avoid splitting it
> >     between lines.
>
> I've committed the patch (with the amendments you've requested) and am
> closing the bug.
>
> > Thanks.
>
> -- 
> Alan Mackenzie (Nuremberg, Germany).
>
>
> --- End Message ---