# HG changeset patch # User Miles Bader # Date 1006691909 0 # Node ID 794e4afabce0e3501076c6ddcda9f80dada62f34 # Parent 400c9b70d5f1c1bee5d281067d4a0d1b00a8d4b7 (Fields): Describe new `limit' arg in field-beginning/field-end. diff -r 400c9b70d5f1 -r 794e4afabce0 lispref/text.texi --- a/lispref/text.texi Sun Nov 25 11:36:17 2001 +0000 +++ b/lispref/text.texi Sun Nov 25 12:38:29 2001 +0000 @@ -3185,7 +3185,7 @@ 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 @@ 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 @@ 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