[Emacs-diffs] /srv/bzr/emacs/trunk r107524: lispref/markers.texi small addition

[Glenn Morris]

------------------------------------------------------------
revno: 107524
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Tue 2012-03-06 23:37:36 -0800
message:
  lispref/markers.texi small addition
  
  * doc/lispref/markers.texi (The Region):
  Briefly mention use-empty-active-region and region-active-p.
modified:
  doc/lispref/ChangeLog
  doc/lispref/markers.texi

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-03-07 05:36:33 +0000
+++ b/doc/lispref/ChangeLog     2012-03-07 07:37:36 +0000
@@ -1,3 +1,8 @@
+2012-03-07  Glenn Morris  <address@hidden>
+
+       * markers.texi (The Region):
+       Briefly mention use-empty-active-region and region-active-p.
+
 2012-03-07  Chong Yidong  <address@hidden>
 
        * text.texi (Buffer Contents): Don't duplicate explanation of

=== modified file 'doc/lispref/markers.texi'
--- a/doc/lispref/markers.texi  2012-03-07 05:36:33 +0000
+++ b/doc/lispref/markers.texi  2012-03-07 07:37:36 +0000
@@ -58,8 +58,6 @@
 relocate them if necessary.  This slows processing in a buffer with a
 large number of markers.  For this reason, it is a good idea to make a
 marker point nowhere if you are sure you don't need it any more.
-Unreferenced markers are garbage collected eventually, but until then
-will continue to use time if they do point somewhere.
 
 @cindex markers as numbers
   Because it is common to perform arithmetic operations on a marker
@@ -636,6 +634,9 @@
 @code{push-mark} discards an old mark when it adds a new one.
 @end defopt
 
address@hidden There is also global-mark-ring-max, but this chapter explicitly
address@hidden does not talk about the global mark.
+
 @node The Region
 @section The Region
 @cindex region (between point and mark)
@@ -673,4 +674,12 @@
 mark is active, and there is a valid region in the buffer.  This
 function is intended to be used by commands that operate on the
 region, instead of on text near point, when the mark is active.
+
+A region is valid if it has a non-zero size, or if the user option
address@hidden is address@hidden (by default, it is
address@hidden).  The function @code{region-active-p} is similar to
address@hidden, but considers all regions as valid.  In most
+cases, you should not use @code{region-active-p}, since if the region
+is empty it is often more appropriate to operate on point.
 @end defun
+