From be2bd2c2da0ff97863ed966a3bd68c2f8fd9373f Mon Sep 17 00:00:00 2001 From: "Richard M. Stallman" Date: Sun, 27 Feb 2005 00:02:17 +0000 Subject: [PATCH] (The Mark): Clarify. --- lispref/markers.texi | 22 +++++++++++----------- 1 file 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 -- 2.39.2