(The Mark): Document temporary Transient Mark mode.

diff --git a/lispref/markers.texi b/lispref/markers.texi
index 31d6796af58be400d107d0c2d9601caf6efc9110..3353d7805ae16e4f78f5da57eef77a4820ba0865 100644 (file)
--- a/lispref/markers.texi
+++ b/lispref/markers.texi
@@ -554,6 +554,12 @@ This variable if non-@code{nil} enables Transient Mark mode, in which
 every buffer-modifying primitive sets @code{deactivate-mark}.  The
 consequence of this is that commands that modify the buffer normally
 make the mark inactive.
+
+Lisp programs can set @code{transient-mark-mode} to @code{only} to
+enable Transient Mark mode for the following command only.  During
+that following command, the value of transient-mark-mode is
+@code{identity}.  If it is still @code{identity} at the end of the
+command, it changes to nil.
 @end defopt
 
 @defopt mark-even-if-inactive