[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs/lisp ChangeLog simple.el
From: |
Chong Yidong |
Subject: |
[Emacs-diffs] emacs/lisp ChangeLog simple.el |
Date: |
Sat, 18 Jul 2009 17:39:39 +0000 |
CVSROOT: /sources/emacs
Module name: emacs
Changes by: Chong Yidong <cyd> 09/07/18 17:39:38
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&r1=1.15825&r2=1.15826
http://cvs.savannah.gnu.org/viewcvs/emacs/lisp/simple.el?cvsroot=emacs&r1=1.995&r2=1.996
Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/emacs/emacs/lisp/ChangeLog,v
retrieving revision 1.15825
retrieving revision 1.15826
diff -u -b -r1.15825 -r1.15826
--- ChangeLog 18 Jul 2009 11:59:04 -0000 1.15825
+++ ChangeLog 18 Jul 2009 17:39:35 -0000 1.15826
@@ -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-18 Eli Zaretskii <address@hidden>
* desktop.el (desktop-buffers-not-to-save): Default value is nil.
Index: simple.el
===================================================================
RCS file: /sources/emacs/emacs/lisp/simple.el,v
retrieving revision 1.995
retrieving revision 1.996
diff -u -b -r1.995 -r1.996
--- simple.el 18 Jul 2009 04:37:56 -0000 1.995
+++ simple.el 18 Jul 2009 17:39:38 -0000 1.996
@@ -3559,23 +3559,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
- [Emacs-diffs] emacs/lisp ChangeLog simple.el, Chong Yidong, 2009/07/11
- [Emacs-diffs] emacs/lisp ChangeLog simple.el, Stefan Monnier, 2009/07/14
- [Emacs-diffs] emacs/lisp ChangeLog simple.el, Chong Yidong, 2009/07/14
- [Emacs-diffs] emacs/lisp ChangeLog simple.el, Chong Yidong, 2009/07/18
- [Emacs-diffs] emacs/lisp ChangeLog simple.el,
Chong Yidong <=
- [Emacs-diffs] emacs/lisp ChangeLog simple.el, Glenn Morris, 2009/07/21
- [Emacs-diffs] emacs/lisp ChangeLog simple.el, Chong Yidong, 2009/07/30
- [Emacs-diffs] emacs/lisp ChangeLog simple.el, Chong Yidong, 2009/07/30