(transient-mark-mode): Document the fact that many

commands act on the region when mark is active.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 7368ee003fe86832898f8bacc4b170ae29e59f91..f0931c7fd153bc31088b73c40f91cba501ccaad7 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,8 @@
+2001-01-27  Eli Zaretskii  <eliz@is.elta.co.il>
+
+       * simple.el (transient-mark-mode): Document the fact that many
+       commands act on the region when mark is active.
+
 2001-01-27  Kenichi Handa  <handa@etl.go.jp>
 
        * international/quail.el (quail-setup-completion-buf): Make the

diff --git a/lisp/simple.el b/lisp/simple.el
index 36780f1a0b20d767f4ec2457416197487803573a..4a35844758d67221a9e37c78ce039ca90ae78fb1 100644 (file)
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -2334,7 +2334,15 @@ In Transient Mark mode, when the mark is active, the region is highlighted.
 Changing the buffer \"deactivates\" the mark.
 So do certain other operations that set the mark
 but whose main purpose is something else--for example,
-incremental search, \\[beginning-of-buffer], and \\[end-of-buffer]."
+incremental search, \\[beginning-of-buffer], and \\[end-of-buffer].
+
+Many commands change their behavior when Transient Mark mode is in effect
+and the mark is active, by acting on the region instead of their usual
+default part of the buffer's text.  Examples of such command include
+\\[comment-dwim], \\[flush-lines], \\[ispell], \\[keep-lines],
+\\[query-replace], \\[query-replace-regexp], and \\[undo].  Invoke
+\\[apropos-documentation] and type \"transient\" at the prompt, to see
+the documentation of commands which are sensitive to the Transient Mark mode."
   (interactive "P")
   (setq transient-mark-mode
        (if (null arg)