[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs/doc/emacs programs.texi
From: |
Alan Mackenzie |
Subject: |
[Emacs-diffs] emacs/doc/emacs programs.texi |
Date: |
Wed, 26 Nov 2008 10:25:07 +0000 |
CVSROOT: /cvsroot/emacs
Module name: emacs
Changes by: Alan Mackenzie <acmacm> 08/11/26 10:25:07
Modified files:
doc/emacs : programs.texi
Log message:
(Moving by Parens): Clarify that parens inside strings and comments are
ignored, and that the commands assume the starting point isn't in a
string or comment.
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/emacs/programs.texi?cvsroot=emacs&r1=1.5&r2=1.6
Patches:
Index: programs.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/emacs/programs.texi,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -b -r1.5 -r1.6
--- programs.texi 1 Nov 2008 23:39:36 -0000 1.5
+++ programs.texi 26 Nov 2008 10:25:06 -0000 1.6
@@ -765,14 +765,21 @@
@cindex matching parenthesis and braces, moving to
@cindex braces, moving across
@cindex list commands
+
The Emacs commands for handling parenthetical groupings see nothing
except parentheses (or whatever characters must balance in the
-language you are working with), and the escape characters that might
-be used to quote those. They are mainly intended for editing
+language you are working with). They ignore strings and comments
+(including any parentheses within them) and ignore parentheses quoted
+by an escape character. They are mainly intended for editing
programs, but can be useful for editing any text that has parentheses.
They are sometimes called ``list'' commands because in Lisp these
groupings are lists.
+These commands assume that the starting point is not inside a string
+or a comment. Sometimes you can invoke them usefully from one of
+these places (for example, when you have a parenthesised clause in a
+comment) but this is unreliable.
+
@table @kbd
@item C-M-n
Move forward over a parenthetical group (@code{forward-list}).
@@ -789,9 +796,8 @@
@findex forward-list
@findex backward-list
The ``list'' commands @kbd{C-M-n} (@code{forward-list}) and
address@hidden (@code{backward-list}) move over one (or @var{n})
-parenthetical groupings, skipping blithely over any amount of text
-that doesn't include meaningful parentheses (symbols, strings, etc.).
address@hidden (@code{backward-list}) move forward or backward over one
+(or @var{n}) parenthetical groupings.
@kindex C-M-u
@findex backward-up-list
- [Emacs-diffs] emacs/doc/emacs programs.texi,
Alan Mackenzie <=