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#10833: 24.0.93; Docstring of `scan-lists' Date: Fri, 17 Feb 2012 22:01:11 +0800 Message-ID: <877gzlmue0.fsf@gnu.org> References: <8762f6kwrx.fsf@web.de> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1329487349 1619 80.91.229.3 (17 Feb 2012 14:02:29 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 17 Feb 2012 14:02:29 +0000 (UTC) Cc: 10833@debbugs.gnu.org To: michael_heerdegen@web.de Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Feb 17 15:02:28 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 1RyOOI-0004Il-LP for geb-bug-gnu-emacs@m.gmane.org; Fri, 17 Feb 2012 15:02:27 +0100 Original-Received: from localhost ([::1]:35253 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RyOOI-0007cG-9o for geb-bug-gnu-emacs@m.gmane.org; Fri, 17 Feb 2012 09:02:26 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]:38328) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RyOO6-0007bi-Qm for bug-gnu-emacs@gnu.org; Fri, 17 Feb 2012 09:02:24 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RyOO1-0004CZ-6h for bug-gnu-emacs@gnu.org; Fri, 17 Feb 2012 09:02:14 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:39905) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RyOO1-0004CU-59 for bug-gnu-emacs@gnu.org; Fri, 17 Feb 2012 09:02:09 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1RyOPq-00042E-Gz for bug-gnu-emacs@gnu.org; Fri, 17 Feb 2012 09:04:02 -0500 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: Fri, 17 Feb 2012 14:04:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 10833 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 10833-submit@debbugs.gnu.org id=B10833.132948740415448 (code B ref 10833); Fri, 17 Feb 2012 14:04:02 +0000 Original-Received: (at 10833) by debbugs.gnu.org; 17 Feb 2012 14:03:24 +0000 Original-Received: from localhost ([127.0.0.1]:43525 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RyOP9-00040z-3Y for submit@debbugs.gnu.org; Fri, 17 Feb 2012 09:03:23 -0500 Original-Received: from fencepost.gnu.org ([140.186.70.10]:50048 ident=Debian-exim) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RyOP4-00040o-Pa for 10833@debbugs.gnu.org; Fri, 17 Feb 2012 09:03:16 -0500 Original-Received: from bb121-6-68-155.singnet.com.sg ([121.6.68.155]:56311 helo=furball) by fencepost.gnu.org with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1RyONE-0001kO-98; Fri, 17 Feb 2012 09:01:20 -0500 In-Reply-To: <8762f6kwrx.fsf@web.de> (Michael Heerdegen's message of "Fri, 17 Feb 2012 03:40:18 +0100") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.93 (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:56966 Archived-At: Michael Heerdegen writes: > 1. The docstring of `scan-lists' needs to explain what "scanning" means. > > 2. This sentence is strange: > > "If the beginning or end of (the accessible part of) the buffer is reached > and the depth is wrong, an error is signaled." > > What does "the depth is wrong" mean? (I guess it's meant "the depth > is not zero", at least the manual says that.) > > 3. See #10659 - Did you also adopt the docstring of `scan-lists'? I've edited the docstring and the manual to make it clearer what the scanner actually does. Thanks.