GNU bug report logs - #30538
Elisp manual doesn't say how to get a raw syntax descriptor of a character.

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Alan Mackenzie <acm <at> muc.de>
Subject: bug#30538: closed (Re: bug#30538: Elisp manual doesn't say how to
 get a raw syntax descriptor of a character.)
Date: Thu, 22 Feb 2018 18:57:02 +0000

[Message part 1 (text/plain, inline)]

Your bug report

#30538: Elisp manual doesn't say how to get a raw syntax descriptor of a character.

which was filed against the emacs package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to 30538 <at> debbugs.gnu.org.

-- 
30538: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=30538
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Alan Mackenzie <acm <at> muc.de>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 30538-done <at> debbugs.gnu.org
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

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 <acm <at> muc.de>

> > 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).

[Message part 3 (message/rfc822, inline)]

From: Alan Mackenzie <acm <at> muc.de>
To: bug-gnu-emacs <at> gnu.org
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

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 non-@code{nil}, 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).

Previous Next

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