changeset 102683:de29c03d601c

(handle-shift-selection): Doc fix. (Bug#2738)

--- a/lisp/simple.el	Sat Mar 21 15:53:29 2009 +0000
+++ b/lisp/simple.el	Sat Mar 21 18:29:25 2009 +0000
@@ -3747,18 +3747,21 @@
     nil))
 
 (defun handle-shift-selection (&optional deactivate)
-  "Check for shift translation, and operate on the mark accordingly.
+  "Activate or deactivate the mark depending on whether the
+current command was invoked through ``shift translation.''
+
+\(See `this-command-keys-shift-translated' for the meaning of
+shift translation.)
+
 This is called whenever a command with a `^' character in its
 `interactive' spec is invoked while `shift-select-mode' is
 non-nil.
 
-If the command was invoked through shift-translation, set the
+If the command was invoked through shift translation, set the
 mark and activate the region temporarily, unless it was already
-set in this way.  If the command was invoked without
-shift-translation and a region is temporarily active, deactivate
-the mark.
-
-With optional arg DEACTIVATE, only perform region deactivation."
+set in this way.  If the command was invoked without shift
+translation, or if the optional argument DEACTIVATE is non-nil,
+deactivate the mark if the region is temporarily active."
   (cond ((and this-command-keys-shift-translated
 	      (null deactivate))
 	 (unless (and mark-active