changeset 99994:178782cd97e1

Explain why region-active-p is often not the best function to use.
author Chong Yidong <cyd@stupidchicken.com>
date Thu, 27 Nov 2008 17:08:44 +0000
parents 26f94bce1bab
children 6f62aec59b3d
files etc/NEWS
diffstat 1 files changed, 4 insertions(+), 3 deletions(-) [+]
line wrap: on
line diff
--- a/etc/NEWS	Thu Nov 27 17:07:25 2008 +0000
+++ b/etc/NEWS	Thu Nov 27 17:08:44 2008 +0000
@@ -1244,9 +1244,10 @@
 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