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#15832: 24.3.50; doc of `up-list' and moving by "parens" Date: Thu, 7 Nov 2013 20:22:45 -0800 (PST) Message-ID: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1383884665 3840 80.91.229.3 (8 Nov 2013 04:24:25 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 8 Nov 2013 04:24:25 +0000 (UTC) To: 15832@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Nov 08 05:24:28 2013 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 1VedcR-0006nq-JD for geb-bug-gnu-emacs@m.gmane.org; Fri, 08 Nov 2013 05:24:27 +0100 Original-Received: from localhost ([::1]:43794 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VedcQ-0007pj-VW for geb-bug-gnu-emacs@m.gmane.org; Thu, 07 Nov 2013 23:24:26 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38710) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VedcD-0007oj-W0 for bug-gnu-emacs@gnu.org; Thu, 07 Nov 2013 23:24:24 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Vedc2-0005P5-NI for bug-gnu-emacs@gnu.org; Thu, 07 Nov 2013 23:24:13 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:54693) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vedc2-0005P1-Jb for bug-gnu-emacs@gnu.org; Thu, 07 Nov 2013 23:24:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1Vedc2-0003q0-E7 for bug-gnu-emacs@gnu.org; Thu, 07 Nov 2013 23:24:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 08 Nov 2013 04:24:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 15832 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.138388460814705 (code B ref -1); Fri, 08 Nov 2013 04:24:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 8 Nov 2013 04:23:28 +0000 Original-Received: from localhost ([127.0.0.1]:40479 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VedbT-0003p6-Oz for submit@debbugs.gnu.org; Thu, 07 Nov 2013 23:23:28 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:36900) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1VedbQ-0003os-KQ for submit@debbugs.gnu.org; Thu, 07 Nov 2013 23:23:25 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VedbA-0005JJ-U4 for submit@debbugs.gnu.org; Thu, 07 Nov 2013 23:23:19 -0500 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:56556) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VedbA-0005JD-R8 for submit@debbugs.gnu.org; Thu, 07 Nov 2013 23:23:08 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38532) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vedb2-0007cO-70 for bug-gnu-emacs@gnu.org; Thu, 07 Nov 2013 23:23:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Vedat-0005Fk-HU for bug-gnu-emacs@gnu.org; Thu, 07 Nov 2013 23:23:00 -0500 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:51285) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Vedat-0005Fc-Ak for bug-gnu-emacs@gnu.org; Thu, 07 Nov 2013 23:22:51 -0500 Original-Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by aserp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id rA84Mlm2008506 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Fri, 8 Nov 2013 04:22:49 GMT Original-Received: from userz7021.oracle.com (userz7021.oracle.com [156.151.31.85]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id rA84Mk2I018162 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Fri, 8 Nov 2013 04:22:47 GMT Original-Received: from abhmt110.oracle.com (abhmt110.oracle.com [141.146.116.62]) by userz7021.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id rA84MkNC018154 for ; Fri, 8 Nov 2013 04:22:46 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6680.5000 (x86)] X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). 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:80123 Archived-At: 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. 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'. Emacs Lisp is a big part of Emacs, yet the only place where `up-list' is mentioned in the Emacs manual is in node `Tex Editing', where it is described as "moving forward past the close brace." `Moving by Parens' is a reasonable place to mention `up-list'. 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". In GNU Emacs 24.3.50.1 (i686-pc-mingw32) of 2013-10-19 on LEG570 Bzr revision: 114715 rgm@gnu.org-20131019023520-s8mwtib7xcx9e05w Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --enable-checking 'CFLAGS=3D-O0 -g3' CPPFLAGS=3D-DGLYPH_DEBUG= =3D1'