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

commands act on the region when mark is active.

2 files changed, 14 insertions, 1 deletions

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 7368ee003fe..f0931c7fd15 100644
--- 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 36780f1a0b2..4a35844758d 100644
--- 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)