1
0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2025-01-18 18:05:07 +00:00

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

This commit is contained in:
Chong Yidong 2008-11-27 17:08:44 +00:00
parent 58b356e9b5
commit 71b605b87e

View File

@ -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