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#10661: 24.0.93; (elisp) `Parser State' - "we plan to change" Date: Mon, 30 Jan 2012 09:59:52 -0800 Message-ID: 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 1327946465 9719 80.91.229.3 (30 Jan 2012 18:01:05 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 30 Jan 2012 18:01:05 +0000 (UTC) To: 10661@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jan 30 19:01:04 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 1RrvXI-0007DP-Ex for geb-bug-gnu-emacs@m.gmane.org; Mon, 30 Jan 2012 19:01:00 +0100 Original-Received: from localhost ([::1]:38830 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RrvXH-0007JP-Vp for geb-bug-gnu-emacs@m.gmane.org; Mon, 30 Jan 2012 13:00:59 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:45487) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RrvXF-0007JI-Rl for bug-gnu-emacs@gnu.org; Mon, 30 Jan 2012 13:00:58 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RrvX9-0002id-L5 for bug-gnu-emacs@gnu.org; Mon, 30 Jan 2012 13:00:57 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:41860) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RrvX9-0002iR-JM for bug-gnu-emacs@gnu.org; Mon, 30 Jan 2012 13:00:51 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1RrvXJ-0008Sw-Up for bug-gnu-emacs@gnu.org; Mon, 30 Jan 2012 13:01: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: Mon, 30 Jan 2012 18:01:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 10661 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.132794643232503 (code B ref -1); Mon, 30 Jan 2012 18:01:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 30 Jan 2012 18:00:32 +0000 Original-Received: from localhost ([127.0.0.1]:45483 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RrvWo-0008SB-SB for submit@debbugs.gnu.org; Mon, 30 Jan 2012 13:00:31 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:36256) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RrvWl-0008Rw-K8 for submit@debbugs.gnu.org; Mon, 30 Jan 2012 13:00:28 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RrvWR-0002MH-Ic for submit@debbugs.gnu.org; Mon, 30 Jan 2012 13:00:11 -0500 Original-Received: from lists.gnu.org ([140.186.70.17]:58968) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RrvWR-0002M8-91 for submit@debbugs.gnu.org; Mon, 30 Jan 2012 13:00:07 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:45031) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RrvWP-0006lH-HG for bug-gnu-emacs@gnu.org; Mon, 30 Jan 2012 13:00:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RrvWJ-0002Gc-B0 for bug-gnu-emacs@gnu.org; Mon, 30 Jan 2012 13:00:04 -0500 Original-Received: from rcsinet15.oracle.com ([148.87.113.117]:30797) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RrvWJ-0002GV-2F for bug-gnu-emacs@gnu.org; Mon, 30 Jan 2012 12:59:59 -0500 Original-Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by rcsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id q0UHxu4n007320 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Mon, 30 Jan 2012 17:59:57 GMT Original-Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q0UHxtUe022447 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Mon, 30 Jan 2012 17:59:56 GMT Original-Received: from abhmt106.oracle.com (abhmt106.oracle.com [141.146.116.58]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q0UHxrcj003189 for ; Mon, 30 Jan 2012 11:59:55 -0600 Original-Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Mon, 30 Jan 2012 09:59:53 -0800 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AczfePdTGZDxNSVPQwmA5or3TapyRg== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-CT-RefId: str=0001.0A090204.4F26DA9D.00E4,ss=1,re=0.000,fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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:56232 Archived-At: The end of this node says: "We have provided this access function rather than document how the data is represented in the state, because we plan to change the representation in the future." That's been there since at least Emacs 22. The reason given should be changed. Perhaps just say that the data structure used is subject to change (IOW _might_ be changed at some point), but you can rely on this function, etc. In general, it's not a great idea to proclaim anything about what you will do or plan to do. Instead, say what you recommend and perhaps state that what's not explicitly recommended is not something users should depend on. In GNU Emacs 24.0.93.1 (i386-mingw-nt5.1.2600) of 2012-01-29 on MARVIN Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.6) --no-opt --cflags -ID:/devel/emacs/libs/libXpm-3.5.8/include -ID:/devel/emacs/libs/libXpm-3.5.8/src -ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include -ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include -ID:/devel/emacs/libs/giflib-4.1.4-1/include -ID:/devel/emacs/libs/jpeg-6b-4/include -ID:/devel/emacs/libs/tiff-3.8.2-1/include -ID:/devel/emacs/libs/gnutls-3.0.9/include --ldflags -LD:/devel/emacs/libs/gnutls-3.0.9/lib'