From unknown Mon Jun 23 06:01:18 2025 X-Loop: help-debbugs@gnu.org Subject: bug#10661: 24.0.93; (elisp) `Parser State' - "we plan to change" 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: To: 10661@debbugs.gnu.org X-Debbugs-Original-To: Received: via spool by submit@debbugs.gnu.org id=B.132794643232503 (code B ref -1); Mon, 30 Jan 2012 18:01:01 +0000 Received: (at submit) by debbugs.gnu.org; 30 Jan 2012 18:00:32 +0000 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 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 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 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_HI, T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.2 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 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 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 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 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 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 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 Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Mon, 30 Jan 2012 09:59:53 -0800 From: "Drew Adams" Date: Mon, 30 Jan 2012 09:59:52 -0800 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit 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-Received-From: 140.186.70.17 X-Spam-Score: -4.2 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.2 (----) 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' From unknown Mon Jun 23 06:01:18 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.428 (Entity 5.428) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: "Drew Adams" Subject: bug#10661: closed (Re: bug#10661: 24.0.93; (elisp) `Parser State' - "we plan to change") Message-ID: References: <87d3a08jox.fsf@gnu.org> X-Gnu-PR-Message: they-closed 10661 X-Gnu-PR-Package: emacs Reply-To: 10661@debbugs.gnu.org Date: Tue, 31 Jan 2012 06:35:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1327991702-11863-1" This is a multi-part message in MIME format... ------------=_1327991702-11863-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #10661: 24.0.93; (elisp) `Parser State' - "we plan to change" 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 10661@debbugs.gnu.org. --=20 10661: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D10661 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1327991702-11863-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 10661-done) by debbugs.gnu.org; 31 Jan 2012 06:34:14 +0000 Received: from localhost ([127.0.0.1]:46204 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Rs7ID-00034N-7e for submit@debbugs.gnu.org; Tue, 31 Jan 2012 01:34:14 -0500 Received: from fencepost.gnu.org ([140.186.70.10]:41422 ident=Debian-exim) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Rs7IA-00034G-Ov for 10661-done@debbugs.gnu.org; Tue, 31 Jan 2012 01:34:11 -0500 Received: from [155.69.16.255] (port=15797 helo=furball) by fencepost.gnu.org with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1Rs7Hw-000176-9N; Tue, 31 Jan 2012 01:33:57 -0500 From: Chong Yidong To: "Drew Adams" Subject: Re: bug#10661: 24.0.93; (elisp) `Parser State' - "we plan to change" References: Date: Tue, 31 Jan 2012 14:33:50 +0800 In-Reply-To: (Drew Adams's message of "Mon, 30 Jan 2012 09:59:52 -0800") Message-ID: <87d3a08jox.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.93 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -4.2 (----) X-Debbugs-Envelope-To: 10661-done Cc: 10661-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.2 (----) "Drew Adams" writes: > 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. Removed, thanks. ------------=_1327991702-11863-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 30 Jan 2012 18:00:32 +0000 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 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 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 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_HI, T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.2 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 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 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 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 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 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 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 Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Mon, 30 Jan 2012 09:59:53 -0800 From: "Drew Adams" To: Subject: 24.0.93; (elisp) `Parser State' - "we plan to change" Date: Mon, 30 Jan 2012 09:59:52 -0800 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit 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-Received-From: 140.186.70.17 X-Spam-Score: -4.2 (----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.2 (----) 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' ------------=_1327991702-11863-1--