From: Chong Yidong <cyd@stupidchicken.com>
Date: Thu, 27 Nov 2008 17:08:44 +0000 (+0000)
Subject: Explain why region-active-p is often not the best function to use.
X-Git-Tag: emacs-pretest-23.0.90~1468
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=71b605b87e9b6b07283820065f6ad5cfad46393e;p=emacs.git

Explain why region-active-p is often not the best function to use.
---

diff --git a/etc/NEWS b/etc/NEWS
index ed5271fa651..8c25bc1ddd4 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1244,9 +1244,10 @@ interactive forms to subroutines.
 an active region that they should operate on.
 
 *** `region-active-p' returns non-nil when Transient Mark mode is
-enabled and there is an active region.  This is NOT the best function
-to use to test whether a command should operate on the region instead
-of the usual behavior -- for that, use `use-region-p'.
+enabled and the mark is active.  Most commands that act specially on
+the active region in Transient Mark mode should use `use-region-p'
+instead of `region-active-p', because `use-region-p' obeys the new
+user option `use-empty-active-region' (see Editing Changes, above).
 
 +++
 *** If a command sets `transient-mark-mode' to (only . OLDVAL), that