procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Updater documentation of 'looking-back'

Browse source 
* doc/lispref/searching.texi (Regexp Search): Update documentation
of 'looking-back'.  Fix markup.
This commit is contained in:
Eli Zaretskii 2016-01-13 20:36:11 +02:00
parent 3db8ce4fbd
commit 53fb7e6e5d
2 changed files with 10 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

15
doc/lispref/searching.texi
View file

@ -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}

2
etc/NEWS
View file

@ -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',