(Fields): Describe new `limit' arg in field-beginning/field-end.

diff --git a/lispref/ChangeLog b/lispref/ChangeLog
index d0ab7b221bc4b64b9f6b87258ff0d4372311a39c..606e30d23a5db0d7c6cb46afe16336f1448aa48b 100644 (file)
--- a/lispref/ChangeLog
+++ b/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2001-11-25  Miles Bader  <miles@gnu.org>
+
+       * text.texi (Fields): Describe new `limit' arg in
+       field-beginning/field-end.
+
 2001-11-17  Eli Zaretskii  <eliz@is.elta.co.il>
 
        * permute-index: Don't depend on csh-specific features.  Replace

diff --git a/lispref/text.texi b/lispref/text.texi
index 1c417f29481604533e2bd59c4317b3aaeb5b6976..5f5b33f81776f4923e0fa99c06f08a7c931c1988 100644 (file)
--- a/lispref/text.texi
+++ b/lispref/text.texi
@@ -3185,7 +3185,7 @@ to an empty field whose beginning and end are both at @var{pos}.
   In all of these functions, if @var{pos} is omitted or @code{nil}, the
 value of point is used by default.
 
-@defun field-beginning &optional pos escape-from-edge
+@defun field-beginning &optional pos escape-from-edge limit
 @tindex field-beginning
 This function returns the beginning of the field specified by @var{pos}.
 
@@ -3194,9 +3194,13 @@ If @var{pos} is at the beginning of its field, and
 always the beginning of the preceding field that @emph{ends} at @var{pos},
 regardless of the stickiness of the @code{field} properties around
 @var{pos}.
+
+If @var{limit} is non-@code{nil}, it is a buffer position; if the
+beginning of the field is before @var{limit}, then @var{limit} will be
+returned instead.
 @end defun
 
-@defun field-end &optional pos escape-from-edge
+@defun field-end &optional pos escape-from-edge limit
 @tindex field-end
 This function returns the end of the field specified by @var{pos}.
 
@@ -3204,6 +3208,10 @@ If @var{pos} is at the end of its field, and @var{escape-from-edge} is
 non-@code{nil}, then the return value is always the end of the following
 field that @emph{begins} at @var{pos}, regardless of the stickiness of
 the @code{field} properties around @var{pos}.
+
+If @var{limit} is non-@code{nil}, it is a buffer position; if the end
+of the field is after @var{limit}, then @var{limit} will be returned
+instead.
 @end defun
 
 @defun field-string &optional pos