From 3fbb05ffe611d6c376413ff0bf544a08bfcdb829 Mon Sep 17 00:00:00 2001 From: Alan Mackenzie Date: Wed, 26 Nov 2008 10:27:42 +0000 Subject: [PATCH] (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. --- doc/emacs/programs.texi | 16 +++++++++++----- lisp/ChangeLog | 8 ++++++++ 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 + + * 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 * net/dbus.el (dbus-string-to-byte-array) -- 2.39.2