From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#10663: 24.0.93; (elisp) `Position Parse' belongs after `Parser State' Date: Thu, 16 Feb 2012 08:33:02 -0800 Message-ID: References: <87fweanbwj.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1329410083 9825 80.91.229.3 (16 Feb 2012 16:34:43 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 16 Feb 2012 16:34:43 +0000 (UTC) Cc: 10663@debbugs.gnu.org To: "'Chong Yidong'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Feb 16 17:34:37 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Ry4Hv-0003fc-QJ for geb-bug-gnu-emacs@m.gmane.org; Thu, 16 Feb 2012 17:34:31 +0100 Original-Received: from localhost ([::1]:59222 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ry4Hv-0005as-BN for geb-bug-gnu-emacs@m.gmane.org; Thu, 16 Feb 2012 11:34:31 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:52676) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ry4Hk-0005aQ-0C for bug-gnu-emacs@gnu.org; Thu, 16 Feb 2012 11:34:29 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Ry4He-0006hq-52 for bug-gnu-emacs@gnu.org; Thu, 16 Feb 2012 11:34:19 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:39122) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ry4He-0006gv-2m for bug-gnu-emacs@gnu.org; Thu, 16 Feb 2012 11:34:14 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1Ry4JN-00064j-Om for bug-gnu-emacs@gnu.org; Thu, 16 Feb 2012 11:36:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 16 Feb 2012 16:36:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 10663 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 10663-submit@debbugs.gnu.org id=B10663.132941010423289 (code B ref 10663); Thu, 16 Feb 2012 16:36:01 +0000 Original-Received: (at 10663) by debbugs.gnu.org; 16 Feb 2012 16:35:04 +0000 Original-Received: from localhost ([127.0.0.1]:42745 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Ry4IR-00063Z-JT for submit@debbugs.gnu.org; Thu, 16 Feb 2012 11:35:04 -0500 Original-Received: from rcsinet15.oracle.com ([148.87.113.117]:51584) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Ry4IO-000633-MB for 10663@debbugs.gnu.org; Thu, 16 Feb 2012 11:35:01 -0500 Original-Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by rcsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q1GGX5ua001040 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 16 Feb 2012 16:33:05 GMT Original-Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q1GGX4iJ002904 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Thu, 16 Feb 2012 16:33:04 GMT Original-Received: from abhmt109.oracle.com (abhmt109.oracle.com [141.146.116.61]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q1GGX3wD011572; Thu, 16 Feb 2012 10:33:03 -0600 Original-Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Thu, 16 Feb 2012 08:33:03 -0800 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <87fweanbwj.fsf@gnu.org> Thread-Index: AczsrzPWpqQrrka6QG23xzuFw1YNRAAF4Uuw X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-CT-RefId: str=0001.0A090204.4F3D2FC2.005F,ss=1,re=0.000,fgs=0 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:56940 Archived-At: > > The subject line says it all. To understand `Position > > Parse' you should have read `Parser State' to know what > > the parser state is all about. > > After re-reading the chapter, I disagree. The current order reads > better. It provides the motivation for caring about the parser state > first, then describes how the parser state is actually represented. > Closing the bug. 1. On second thought, I think you are right. At that point, a reader need not know any details about the parser state. Thanks for checking/re-reading. 2. But a reader might well wonder what the text here is talking about when it mentions "parser state" without any description, however brief. A forward cross reference here to the node that tells readers what "parser state" is would help. (Too bad we can't simply make the words "parser state" here be such a link.) 3. Another minor improvement to consider: be consistent about the "state" terminology. This node uses both "parse state" (in the heading) and "parser state". Presumably these terms refer to the same state. FYI, the term "parse state" is used only once in this section of the book (in this heading), and only once in another section: node `Syntactic Font Lock'. Elsewhere, "parser state" seems to be the preferred term - including (a) as a node name, (b) as an index entry, and (c) within double quotes as a defined term.