diff options
author | Richard M. Stallman <rms@gnu.org> | 2005-02-27 00:02:17 +0000 |
---|---|---|
committer | Richard M. Stallman <rms@gnu.org> | 2005-02-27 00:02:17 +0000 |
commit | be2bd2c2da0ff97863ed966a3bd68c2f8fd9373f (patch) | |
tree | 739908d4966e68e021c6f838c9b3c506def99620 /lispref/markers.texi | |
parent | ffa11b51731ae0797126095196fe3c6cc1067f03 (diff) | |
download | emacs-be2bd2c2da0ff97863ed966a3bd68c2f8fd9373f.tar.gz |
(The Mark): Clarify.
Diffstat (limited to 'lispref/markers.texi')
-rw-r--r-- | lispref/markers.texi | 22 |
1 files changed, 11 insertions, 11 deletions
diff --git a/lispref/markers.texi b/lispref/markers.texi index 859edb0b6b8..31d6796af58 100644 --- a/lispref/markers.texi +++ b/lispref/markers.texi @@ -394,17 +394,17 @@ This is another name for @code{set-marker}. @cindex mark ring One special marker in each buffer is designated @dfn{the mark}. It -records a position for the user for the sake of commands such as -@code{kill-region} and @code{indent-rigidly}. Lisp programs should set -the mark only to values that have a potential use to the user, and never -for their own internal purposes. For example, the @code{replace-regexp} -command sets the mark to the value of point before doing any -replacements, because this enables the user to move back there -conveniently after the replace is finished. - - Many commands are designed so that when called interactively they -operate on the text between point and the mark. If you are writing such -a command, don't examine the mark directly; instead, use +specifies a position to bound a range of text for commands such as +@code{kill-region} and @code{indent-rigidly}. Lisp programs should +set the mark only to values that have a potential use to the user, and +never for their own internal purposes. For example, the +@code{replace-regexp} command sets the mark to the value of point +before doing any replacements, because this enables the user to move +back there conveniently after the replace is finished. + + Many commands are designed to operate on the text between point and +the mark when called interactively. If you are writing such a +command, don't examine the mark directly; instead, use @code{interactive} with the @samp{r} specification. This provides the values of point and the mark as arguments to the command in an interactive call, but permits other Lisp programs to specify arguments |