From debbugs-submit-bounces@debbugs.gnu.org Mon Feb 19 15:45:05 2018 Received: (at submit) by debbugs.gnu.org; 19 Feb 2018 20:45:05 +0000 Received: from localhost ([127.0.0.1]:51711 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ensJ7-0001r3-4V for submit@debbugs.gnu.org; Mon, 19 Feb 2018 15:45:05 -0500 Received: from eggs.gnu.org ([208.118.235.92]:60134) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ensJ5-0001qJ-Dd for submit@debbugs.gnu.org; Mon, 19 Feb 2018 15:45:03 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ensIz-0001L1-D8 for submit@debbugs.gnu.org; Mon, 19 Feb 2018 15:44:58 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:49607) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1ensIz-0001Km-9J for submit@debbugs.gnu.org; Mon, 19 Feb 2018 15:44:57 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:51098) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ensIy-0007Ap-7H for bug-gnu-emacs@gnu.org; Mon, 19 Feb 2018 15:44:57 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ensIt-0001HZ-Eb for bug-gnu-emacs@gnu.org; Mon, 19 Feb 2018 15:44:54 -0500 Received: from colin.muc.de ([193.149.48.1]:19721 helo=mail.muc.de) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1ensIt-0001Gl-2N for bug-gnu-emacs@gnu.org; Mon, 19 Feb 2018 15:44:51 -0500 Received: (qmail 18500 invoked by uid 3782); 19 Feb 2018 20:44:48 -0000 Received: from acm.muc.de (p548C778D.dip0.t-ipconnect.de [84.140.119.141]) by colin.muc.de (tmda-ofmipd) with ESMTP; Mon, 19 Feb 2018 21:44:48 +0100 Received: (qmail 19153 invoked by uid 1000); 19 Feb 2018 20:32:33 -0000 Date: Mon, 19 Feb 2018 20:32:33 +0000 To: bug-gnu-emacs@gnu.org Subject: Elisp manual doesn't say how to get a raw syntax descriptor of a character. Message-ID: <20180219203233.GB5688@ACM> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.7.2 (2016-11-26) X-Delivery-Agent: TMDA/1.1.12 (Macallan) From: Alan Mackenzie X-Primary-Address: acm@muc.de X-detected-operating-system: by eggs.gnu.org: FreeBSD 9.x [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.3 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.3 (----) 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). From debbugs-submit-bounces@debbugs.gnu.org Tue Feb 20 13:58:02 2018 Received: (at 30538) by debbugs.gnu.org; 20 Feb 2018 18:58:02 +0000 Received: from localhost ([127.0.0.1]:53193 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eoD73-0001ub-Nk for submit@debbugs.gnu.org; Tue, 20 Feb 2018 13:58:01 -0500 Received: from eggs.gnu.org ([208.118.235.92]:50081) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eoD72-0001uG-2Z for 30538@debbugs.gnu.org; Tue, 20 Feb 2018 13:58:00 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eoD6s-0003Cy-Lm for 30538@debbugs.gnu.org; Tue, 20 Feb 2018 13:57:54 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50,T_RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:59686) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eoD6s-0003Cn-IJ; Tue, 20 Feb 2018 13:57:50 -0500 Received: from [176.228.60.248] (port=3823 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1eoD6p-00050j-1n; Tue, 20 Feb 2018 13:57:50 -0500 Date: Tue, 20 Feb 2018 20:57:58 +0200 Message-Id: <83woz77akp.fsf@gnu.org> From: Eli Zaretskii To: Alan Mackenzie In-reply-to: <20180219203233.GB5688@ACM> (message from Alan Mackenzie on Mon, 19 Feb 2018 20:32:33 +0000) Subject: Re: bug#30538: Elisp manual doesn't say how to get a raw syntax descriptor of a character. References: <20180219203233.GB5688@ACM> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 30538 Cc: 30538@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) > Date: Mon, 19 Feb 2018 20:32:33 +0000 > From: Alan Mackenzie > > 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. Thanks. From debbugs-submit-bounces@debbugs.gnu.org Thu Feb 22 13:56:07 2018 Received: (at 30538-done) by debbugs.gnu.org; 22 Feb 2018 18:56:07 +0000 Received: from localhost ([127.0.0.1]:56834 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eow2J-0005zK-7a for submit@debbugs.gnu.org; Thu, 22 Feb 2018 13:56:07 -0500 Received: from colin.muc.de ([193.149.48.1]:18128 helo=mail.muc.de) by debbugs.gnu.org with smtp (Exim 4.84_2) (envelope-from ) id 1eow2H-0005zB-Ib for 30538-done@debbugs.gnu.org; Thu, 22 Feb 2018 13:56:06 -0500 Received: (qmail 93375 invoked by uid 3782); 22 Feb 2018 18:56:04 -0000 Received: from acm.muc.de (p548C7841.dip0.t-ipconnect.de [84.140.120.65]) by colin.muc.de (tmda-ofmipd) with ESMTP; Thu, 22 Feb 2018 19:56:03 +0100 Received: (qmail 6511 invoked by uid 1000); 22 Feb 2018 18:43:09 -0000 Date: Thu, 22 Feb 2018 18:43:09 +0000 To: Eli Zaretskii Subject: Re: bug#30538: Elisp manual doesn't say how to get a raw syntax descriptor of a character. Message-ID: <20180222184309.GB6482@ACM> References: <20180219203233.GB5688@ACM> <83woz77akp.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <83woz77akp.fsf@gnu.org> User-Agent: Mutt/1.7.2 (2016-11-26) X-Delivery-Agent: TMDA/1.1.12 (Macallan) From: Alan Mackenzie X-Primary-Address: acm@muc.de X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 30538-done Cc: 30538-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.0 (/) 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 > > 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). From unknown Sun Jun 15 08:48:36 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Fri, 23 Mar 2018 11:24:03 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator