[Emacs-diffs] emacs/lisp ChangeLog simple.el [EMACS_23_1_RC]

[Chong Yidong]

CVSROOT:        /sources/emacs
Module name:    emacs
Branch:         EMACS_23_1_RC
Changes by:     Chong Yidong <cyd>      09/07/18 17:38:25

Modified files:
        lisp           : ChangeLog simple.el 

Log message:
        * simple.el (region-active-p, use-region-p): Doc fix (Bug#3873).

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/lisp/ChangeLog?cvsroot=emacs&only_with_tag=EMACS_23_1_RC&r1=1.15702.2.33&r2=1.15702.2.34
http://cvs.savannah.gnu.org/viewcvs/emacs/lisp/simple.el?cvsroot=emacs&only_with_tag=EMACS_23_1_RC&r1=1.988.2.1&r2=1.988.2.2

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/emacs/emacs/lisp/ChangeLog,v
retrieving revision 1.15702.2.33
retrieving revision 1.15702.2.34
diff -u -b -r1.15702.2.33 -r1.15702.2.34
--- ChangeLog   17 Jul 2009 12:24:25 -0000      1.15702.2.33
+++ ChangeLog   18 Jul 2009 17:38:17 -0000      1.15702.2.34
@@ -1,3 +1,7 @@
+2009-07-18  Chong Yidong  <address@hidden>
+
+       * simple.el (region-active-p, use-region-p): Doc fix (Bug#3873).
+
 2009-07-17  Kenichi Handa  <address@hidden>
 
        * case-table.el (describe-buffer-case-table): Fix for the case

Index: simple.el
===================================================================
RCS file: /sources/emacs/emacs/lisp/simple.el,v
retrieving revision 1.988.2.1
retrieving revision 1.988.2.2
diff -u -b -r1.988.2.1 -r1.988.2.2
--- simple.el   14 Jul 2009 14:22:51 -0000      1.988.2.1
+++ simple.el   18 Jul 2009 17:38:24 -0000      1.988.2.2
@@ -3532,23 +3532,25 @@
 (defun use-region-p ()
   "Return t if the region is active and it is appropriate to act on it.
 This is used by commands that act specially on the region under
-Transient Mark mode.  It returns t if and only if Transient Mark
-mode is enabled, the mark is active, and the region is non-empty.
-If `use-empty-active-region' is non-nil, it returns t even if the
-region is empty.
+Transient Mark mode.
 
-For some commands, it may be appropriate to disregard the value
-of `use-empty-active-region'; in that case, use `region-active-p'."
+The return value is t provided Transient Mark mode is enabled and
+the mark is active; and, when `use-empty-active-region' is
+non-nil, provided the region is empty.  Otherwise, the return
+value is nil.
+
+For some commands, it may be appropriate to ignore the value of
+`use-empty-active-region'; in that case, use `region-active-p'."
   (and (region-active-p)
        (or use-empty-active-region (> (region-end) (region-beginning)))))
 
 (defun region-active-p ()
   "Return t if Transient Mark mode is enabled and the mark is active.
 
-Most commands that act on the region if it is active and
-Transient Mark mode is enabled, and on the text near point
-otherwise, should use `use-region-p' instead.  That function
-checks the value of `use-empty-active-region' as well."
+Some commands act specially on the region when Transient Mark
+mode is enabled.  Usually, such commands should use
+`use-region-p' instead of this function, because `use-region-p'
+also checks the value of `use-empty-active-region'."
   (and transient-mark-mode mark-active))
 
 (defvar mark-ring nil