# HG changeset patch # User Miles Bader # Date 1001988670 0 # Node ID ed97ba5c9ba84d3fccf878bcfdf4cf62c070de70 # Parent 30754f5e966500b40a885f16a00a407f027cf686 (Property Search): Correct descriptions of `next-char-property-change' and `previous-char-property-change'. Add entries for `next-single-char-property-change' and `previous-single-char-property-change'. Make operand names a bit more consistent. diff -r 30754f5e9665 -r ed97ba5c9ba8 lispref/text.texi --- a/lispref/text.texi Tue Oct 02 01:53:10 2001 +0000 +++ b/lispref/text.texi Tue Oct 02 02:11:10 2001 +0000 @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2000 +@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2000, 2001 @c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/text @@ -2550,16 +2550,37 @@ @var{limit} equals @var{pos}. @end defun -@defun next-char-property-change position &optional limit +@defun next-char-property-change pos &optional limit This is like @code{next-property-change} except that it considers -overlay properties as well as text properties. There is no @var{object} -operand because this function operates only on the current buffer. It -returns the next address at which either kind of property changes. +overlay properties as well as text properties, and if no change is +found before the end of the buffer, it returns the maximum buffer +position rather than @code{nil} (in this sense, it resembles the +corresponding overlay function @code{next-overlay-change}, rather than +@code{next-property-change}). There is no @var{object} operand +because this function operates only on the current buffer. It returns +the next address at which either kind of property changes. +@end defun + +@defun previous-char-property-change pos &optional limit +This is like @code{next-char-property-change}, but scans back from +@var{pos} instead of forward, and returns the minimum buffer +position if no change is found. @end defun -@defun previous-char-property-change position &optional limit -This is like @code{next-char-property-change}, but scans back from -@var{position} instead of forward. +@defun next-single-char-property-change pos prop &optional object limit +This is like @code{next-single-property-change} except that it +considers overlay properties as well as text properties, and if no +change is found before the end of the @var{object}, it returns the +maximum valid position in @var{object} rather than @code{nil}. Unlike +@code{next-char-property-change}, this function @emph{does} have an +@var{object} operand; if @var{object} is not a buffer, only +text-properties are considered. +@end defun + +@defun previous-single-char-property-change pos prop &optional object limit +This is like @code{next-single-char-property-change}, but scans back +from @var{pos} instead of forward, and returns the minimum valid +position in @var{object} if no change is found. @end defun @defun text-property-any start end prop value &optional object