[Emacs-diffs] Changes to emacs/doc/lispref/markers.texi,v

[Eli Zaretskii]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Eli Zaretskii <eliz>    08/10/15 16:48:07

Index: markers.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/lispref/markers.texi,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -b -r1.3 -r1.4
--- markers.texi        8 Jan 2008 20:45:49 -0000       1.3
+++ markers.texi        15 Oct 2008 16:48:06 -0000      1.4
@@ -555,11 +555,15 @@
 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 @code{transient-mark-mode} is
address@hidden  If it is still @code{identity} at the end of the
-command, it changes to @code{nil}.
+Lisp programs can set @code{transient-mark-mode} to address@hidden,
address@hidden values to enable Transient Mark mode temporarily.  If the
+value is @code{lambda}, Transient Mark Mode is automatically turned
+off after any action, such as buffer modification, that would normally
+deactivate the mark.  If the value is @address@hidden(only . @var{oldval})}},
+then @code{transient-mark-mode} is set to the value @var{oldval} after
+any subsequent command that moves point and is not shift-translated
+(@pxref{Key Sequence Input, shift-translation}), or after any other
+action that would normally deactivate the mark.
 @end defopt
 
 @defopt mark-even-if-inactive
@@ -626,6 +630,20 @@
 @code{push-mark} discards an old mark when it adds a new one.
 @end defopt
 
address@hidden handle-shift-selection &optional deactivate
+This function checks whether the current command was invoked via shift
+translation (@pxref{Key Sequence Input, shift-translation}), and if
+so, sets the mark and temporarily activates the region, unless the
+region is already temporarily activated in this way.  If the command
+was invoked without shift translation, or if the optional argument
address@hidden is non-nil, the function deactivates the mark.  This
+function is called whenever a command with a @samp{^} character in its
address@hidden spec (@pxref{Interactive Codes, ^}) is invoked
+while @code{shift-select-mode} (@pxref{Shift Selection,,, emacs, The
+GNU Emacs Manual}) is address@hidden
+
address@hidden defun
+
 @node The Region
 @section The Region
 @cindex region (between point and mark)