[Emacs-diffs] emacs/doc/emacs programs.texi

[Alan Mackenzie]

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