summaryrefslogtreecommitdiff
path: root/doc/lispref/markers.texi
diff options
context:
space:
mode:
authorXue Fuqiao <xfq.free@gmail.com>2013-08-15 16:27:22 +0800
committerXue Fuqiao <xfq.free@gmail.com>2013-08-15 16:27:22 +0800
commit7cbbcaa0dd337d39939d65f58b45f50f4480ce09 (patch)
treef817d1fabde0273e3f2d4cb26b62bba17acab420 /doc/lispref/markers.texi
parent8e5c7e6f4ee3598ea329f6a83c6d4d118cef7589 (diff)
downloademacs-7cbbcaa0dd337d39939d65f58b45f50f4480ce09.tar.gz
emacs-7cbbcaa0dd337d39939d65f58b45f50f4480ce09.tar.bz2
emacs-7cbbcaa0dd337d39939d65f58b45f50f4480ce09.zip
* doc/lispref/markers.texi (The Region): Add/move indexes.
Diffstat (limited to 'doc/lispref/markers.texi')
-rw-r--r--doc/lispref/markers.texi5
1 files changed, 4 insertions, 1 deletions
diff --git a/doc/lispref/markers.texi b/doc/lispref/markers.texi
index 05c3fc56fd4..712e5f99b63 100644
--- a/doc/lispref/markers.texi
+++ b/doc/lispref/markers.texi
@@ -387,7 +387,6 @@ This is another name for @code{set-marker}.
@section The Mark
@cindex mark, the
@c @cindex the mark?
-@cindex mark ring
Each buffer has a special marker, which is designated @dfn{the
mark}. When a buffer is newly created, this marker exists but does
@@ -426,6 +425,7 @@ the mark is active. This is the main motivation for using Transient
Mark mode. (Another is that this enables highlighting of the region
when the mark is active. @xref{Display}.)
+@cindex mark ring
In addition to the mark, each buffer has a @dfn{mark ring} which is a
list of markers containing previous values of the mark. When editing
commands change the mark, they should normally save the old value of the
@@ -671,6 +671,7 @@ integer). This is the position of either point or the mark, whichever is
larger.
@end defun
+@c FIXME: Mention it in tips.texi?
Instead of using @code{region-beginning} and @code{region-end}, a
command designed to operate on a region should normally use
@code{interactive} with the @samp{r} specification to find the
@@ -683,6 +684,8 @@ mark is active, and there is a valid region in the buffer. This
function is intended to be used by commands that operate on the
region, instead of on text near point, when the mark is active.
+@cindex empty region
+@vindex use-empty-active-region
A region is valid if it has a non-zero size, or if the user option
@code{use-empty-active-region} is non-@code{nil} (by default, it is
@code{nil}). The function @code{region-active-p} is similar to