From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lars Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#15832: 24.3.50; doc of `up-list' and moving by "parens" Date: Sun, 09 Feb 2014 21:49:44 -0800 Message-ID: <87lhxj7c07.fsf@building.gnus.org> References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1392011528 10146 80.91.229.3 (10 Feb 2014 05:52:08 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 10 Feb 2014 05:52:08 +0000 (UTC) Cc: 15832@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Feb 10 06:52:16 2014 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 1WCjmx-0004iU-Pm for geb-bug-gnu-emacs@m.gmane.org; Mon, 10 Feb 2014 06:52:15 +0100 Original-Received: from localhost ([::1]:53530 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WCjmx-0007ix-FX for geb-bug-gnu-emacs@m.gmane.org; Mon, 10 Feb 2014 00:52:15 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60935) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WCjmp-0007is-7F for bug-gnu-emacs@gnu.org; Mon, 10 Feb 2014 00:52:12 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WCjmk-0000Cv-6c for bug-gnu-emacs@gnu.org; Mon, 10 Feb 2014 00:52:07 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:47859) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WCjmk-0000Cr-3L for bug-gnu-emacs@gnu.org; Mon, 10 Feb 2014 00:52:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1WCjmj-000378-N8 for bug-gnu-emacs@gnu.org; Mon, 10 Feb 2014 00:52:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 10 Feb 2014 05:52:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 15832 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 15832-submit@debbugs.gnu.org id=B15832.139201147611914 (code B ref 15832); Mon, 10 Feb 2014 05:52:01 +0000 Original-Received: (at 15832) by debbugs.gnu.org; 10 Feb 2014 05:51:16 +0000 Original-Received: from localhost ([127.0.0.1]:33645 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCjlz-000366-Hy for submit@debbugs.gnu.org; Mon, 10 Feb 2014 00:51:15 -0500 Original-Received: from hermes.netfonds.no ([80.91.224.195]:48508) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCjlw-00035w-Oe for 15832@debbugs.gnu.org; Mon, 10 Feb 2014 00:51:13 -0500 Original-Received: from [204.14.154.233] (helo=building.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1WCjlh-00074g-9Y; Mon, 10 Feb 2014 06:50:57 +0100 In-Reply-To: (Drew Adams's message of "Thu, 7 Nov 2013 20:22:45 -0800 (PST)") User-Agent: Gnus/5.13001 (Ma Gnus v0.10) Emacs/24.3.50 (gnu/linux) X-MailScanner-ID: 1WCjlh-00074g-9Y MailScanner-NULL-Check: 1392616258.67521@M0z/GZOEWxz7mvQ2x8bRmA X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x 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:85213 Archived-At: Drew Adams writes: > 1. The doc strings of `up-list' and similar commands do not make clear > that the movement is not necessarily about parentheses (in spite of the > command names). As (emacs) `Moving by Parens' takes care to say, such > commands "move over groupings delimited by parentheses (or whatever else > serves as delimiters in the language you are working with)." The > information in parentheses in this phrase is what is missing from the > doc strings. Fixed on trunk. > 2. `up-list' should be added to the list of commands mentioned in > (emacs) `Moving by Parens'. `down-list' and `backward-up-list' are > mentioned, but not `up-list'. `up-list' doesn't have a keyboard definition, which is why it's probably not documented in the Emacs manual. > 3. (elisp) `List Motion' mentions that the syntax table controls which > characters are treated like parentheses, which is good. It then > cross-references (emacs) `Moving by Parens' "for user-level commands." > > It is good to cross-reference, but what are described at (elisp) `List > Motion' *are* user-level commands, so the characterization "for > user-level commands" is confusing and misleading. The cross reference > should just say "see also". The things described in the Emacs manual here are clearly more user-levelish, so I think that's OK. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/