; Add more detail to exchange-point-and-mark docstring
authorSean Whitton <spwhitton@spwhitton.name>
Wed, 12 Mar 2025 03:56:13 +0000 (11:56 +0800)
committerEshel Yaron <me@eshelyaron.com>
Wed, 12 Mar 2025 19:04:28 +0000 (20:04 +0100)
It didn't mention that exchange-point-and-mark-highlight-region
affects C-u C-x C-x too.

(cherry picked from commit cd1defc441fc7694aaa0adac617edf790d8444d6)

lisp/simple.el

index e513362426ced172ae40df22629f0b05a6a0a3d3..f6b8e4427bca06a88cb33abe4c8721dca6904f97 100644 (file)
@@ -7295,10 +7295,15 @@ This variable has no effect when Transient Mark mode is off."
 This command works even when the mark is not active, and it reactivates
 the mark unless `exchange-point-and-mark-highlight-region' is nil.
 
-If Transient Mark mode is on, a prefix ARG deactivates the mark
-if it is active, and otherwise avoids reactivating it.  If
-Transient Mark mode is off, a prefix ARG enables Transient Mark
-mode temporarily."
+If Transient Mark mode is on, a prefix ARG deactivates the mark if it is
+active, and otherwise avoids reactivating it.  However, if
+`exchange-point-and-mark-highlight-region' is nil, then using a prefix
+argument does reactivate the mark; effectively, when Transient Mark mode
+is on, setting `exchange-point-and-mark-highlight-region' to nil swaps
+the meanings of the presence and absence of a prefix argument.
+
+If Transient Mark mode is off, a prefix ARG enables Transient Mark mode
+temporarily."
   (interactive "P")
   (let ((omark (mark t))
         (region-was-active (region-active-p))