summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/emacs/programs.texi16
-rw-r--r--lisp/ChangeLog8
2 files changed, 19 insertions, 5 deletions
diff --git a/doc/emacs/programs.texi b/doc/emacs/programs.texi
index c48d564b589..f42434a3cb7 100644
--- a/doc/emacs/programs.texi
+++ b/doc/emacs/programs.texi
@@ -765,14 +765,21 @@ single expression in C mode, because of the parentheses.
@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 @@ Move down in parenthesis structure (@code{down-list}).
@findex forward-list
@findex backward-list
The ``list'' commands @kbd{C-M-n} (@code{forward-list}) and
-@kbd{C-M-p} (@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.).
+@kbd{C-M-p} (@code{backward-list}) move forward or backward over one
+(or @var{n}) parenthetical groupings.
@kindex C-M-u
@findex backward-up-list
diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 3e91fc98918..f5772568c98 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,11 @@
+2008-11-25 Alan Mackenzie <acm@muc.de>
+
+ * emacs-lisp/lisp.el (forward-sexp, backward-sexp, mark-sexp)
+ (forward-list, backward-list, down-list, backward-up-list)
+ (up-list, kill-sexp, backward-kill-sexp, kill-backward-up-list)
+ (insert-pair, insert-parentheses): State that the command assumes
+ that point is not in a string or comment.
+
2008-11-26 Michael Albinus <michael.albinus@gmx.de>
* net/dbus.el (dbus-string-to-byte-array)