mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-12-20 10:23:57 +00:00
Code Issues Releases Activity

(Moving by Parens): Clarify that parens inside strings and comments are

Browse Source 
ignored, and that the commands assume the starting point isn't in a
string or comment.
This commit is contained in:
Alan Mackenzie 2008-11-26 10:27:42 +00:00
parent a5f7bbcc3f
commit 3fbb05ffe6
2 changed files with 19 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
doc/emacs/programs.texi
View File

@ -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

8
lisp/ChangeLog
View File

@ -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)