From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Chong Yidong Newsgroups: gmane.emacs.bugs Subject: bug#12383: [Patch] Clarify the distinction between "syntax codes" and the cons cells that contain them Date: Sat, 08 Sep 2012 22:25:15 +0800 Message-ID: <87392soalw.fsf@gnu.org> References: <87627p4a50.fsf@nbtrap.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1347114345 7837 80.91.229.3 (8 Sep 2012 14:25:45 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 8 Sep 2012 14:25:45 +0000 (UTC) Cc: 12383@debbugs.gnu.org To: Nathan Trapuzzano Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Sep 08 16:25:47 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 1TALyk-0006pJ-Pl for geb-bug-gnu-emacs@m.gmane.org; Sat, 08 Sep 2012 16:25:46 +0200 Original-Received: from localhost ([::1]:48735 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TALyh-0003gY-Ca for geb-bug-gnu-emacs@m.gmane.org; Sat, 08 Sep 2012 10:25:43 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:47457) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TALyd-0003g1-UD for bug-gnu-emacs@gnu.org; Sat, 08 Sep 2012 10:25:40 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TALyd-0000yq-11 for bug-gnu-emacs@gnu.org; Sat, 08 Sep 2012 10:25:39 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:39131) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TALyc-0000yg-Tr for bug-gnu-emacs@gnu.org; Sat, 08 Sep 2012 10:25:38 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1TALz0-0002Hb-Ce for bug-gnu-emacs@gnu.org; Sat, 08 Sep 2012 10:26:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Chong Yidong Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 08 Sep 2012 14:26:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 12383 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 12383-submit@debbugs.gnu.org id=B12383.13471143508745 (code B ref 12383); Sat, 08 Sep 2012 14:26:02 +0000 Original-Received: (at 12383) by debbugs.gnu.org; 8 Sep 2012 14:25:50 +0000 Original-Received: from localhost ([127.0.0.1]:48673 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TALyn-0002H0-Oe for submit@debbugs.gnu.org; Sat, 08 Sep 2012 10:25:50 -0400 Original-Received: from mail-iy0-f172.google.com ([209.85.210.172]:57338) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TALyk-0002Gs-FK for 12383@debbugs.gnu.org; Sat, 08 Sep 2012 10:25:47 -0400 Original-Received: by iabz21 with SMTP id z21so472898iab.3 for <12383@debbugs.gnu.org>; Sat, 08 Sep 2012 07:25:22 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-type; bh=Y1PkZ3jY9ASbkFh53y7/nevlGPPCGDOhSGk138EheeY=; b=uN4WHsJpLOHAviEPQ+ZqmMrFhJ1pE5GCNwiO/OUrTCQGv18Xqie/BE6ekLMkEYmZly bTIRDrqafCqcEAyI8GP4eIL0M6ipMgJG7s/UN0f8IWtCdb2YVIV5NdrOQ+ECKIG9Hnp+ 0pZLk+GXgscd02sHbwHB8NdE2fKhVbbu57SXo0AZjBpGQwA4aY+/74HtgTQx4vN1MIPA DJg4jLcwYDjNElqe2ndr6T9Phq9KTbG9IHnTzU5I1RT4MJSsI/R/IkCFxTll4G/m5owq aNBOnYK2ATwC9GE5C85+zCHaKCqiohMauskQlrCtkcApPcKUiCS0TJMu7FYsbvPWDkb2 RGdA== Original-Received: by 10.50.15.133 with SMTP id x5mr1936824igc.26.1347114322103; Sat, 08 Sep 2012 07:25:22 -0700 (PDT) Original-Received: from ulysses (cm162.gamma80.maxonline.com.sg. [202.156.80.162]) by mx.google.com with ESMTPS id hz10sm2868452igc.12.2012.09.08.07.25.17 (version=SSLv3 cipher=OTHER); Sat, 08 Sep 2012 07:25:20 -0700 (PDT) In-Reply-To: <87627p4a50.fsf@nbtrap.com> (Nathan Trapuzzano's message of "Fri, 07 Sep 2012 20:43:23 -0400") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.2.50 (gnu/linux) 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 (newer, 2) 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:63939 Archived-At: Nathan Trapuzzano writes: > The lispref info node on "Syntax Table Internals" uses "syntax code" > interchangeably to refer to both the car of syntax table elements and > the elements (cons cells) themselves. This is confusing, for example, > because the function "syntax-class" throws a wrong-type-argument error > if its argument is the bare integer syntax code instead of a cons > cell. I propose the following minor changes: Thank you for the suggestion. It is on the right track, but I think the fix needs to go further. We need a new terminology for the cons cells stored in the syntax table. I think a good name is "raw syntax descriptors", and I've amended the manual and docstrings accordingly.