From: Eli Zaretskii Date: Wed, 13 Jan 2016 18:36:11 +0000 (+0200) Subject: Updater documentation of 'looking-back' X-Git-Tag: emacs-25.0.90~176 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=53fb7e6e5da541e0b5f6b203f567cb5900185e21;p=emacs.git Updater documentation of 'looking-back' * doc/lispref/searching.texi (Regexp Search): Update documentation of 'looking-back'. Fix markup. --- diff --git a/doc/lispref/searching.texi b/doc/lispref/searching.texi index 5ff7ef1cf66..1243d720bc3 100644 --- a/doc/lispref/searching.texi +++ b/doc/lispref/searching.texi @@ -1151,16 +1151,17 @@ comes back" twice. @end example @end defun -@defun looking-back regexp &optional limit greedy +@defun looking-back regexp limit &optional greedy This function returns @code{t} if @var{regexp} matches the text immediately before point (i.e., ending at point), and @code{nil} otherwise. Because regular expression matching works only going forward, this is implemented by searching backwards from point for a match that ends at point. That can be quite slow if it has to search a long distance. -You can bound the time required by specifying @var{limit}, which says -not to search before @var{limit}. In this case, the match that is -found must begin at or after @var{limit}. Here's an example: +You can bound the time required by specifying a non-@code{nil} value +for @var{limit}, which says not to search before @var{limit}. In this +case, the match that is found must begin at or after @var{limit}. +Here's an example: @example @group @@ -1178,9 +1179,9 @@ comes back" twice. If @var{greedy} is non-@code{nil}, this function extends the match backwards as far as possible, stopping when a single additional -previous character cannot be part of a match for regexp. When the -match is extended, its starting position is allowed to occur before -@var{limit}. +previous character cannot be part of a match for @var{regexp}. When +the match is extended, its starting position is allowed to occur +before @var{limit}. @c http://debbugs.gnu.org/5689 As a general recommendation, try to avoid using @code{looking-back} diff --git a/etc/NEWS b/etc/NEWS index c51136faf63..7cea0c88da1 100644 --- a/etc/NEWS +++ b/etc/NEWS @@ -1353,7 +1353,9 @@ Previously, the default value of `nil' implied using `read'. ** New hook `pre-redisplay-functions'. It is a bit easier to use than `pre-redisplay-function'. ++++ ** The second arg of `looking-back' should always be provided explicitly. +Previously, it was an optional argument, now it's mandatory. ** Obsolete text properties `intangible', `point-entered', and `point-left'. Replaced by properties `cursor-intangible' and `cursor-sensor-functions',