bug#1299: lispref - searching.texi: Updating of looking-back arguments and return values in the example

bug#1299: lispref - searching.texi: Updating of looking-back arguments and return values in the example

[Seweryn Kokot]

[-- Attachment #1: Type: text/plain, Size: 287 bytes --]

Please describe exactly what actions triggered the bug
and the precise symptoms of the bug:

See the diff attached. Note that I copied the explanation for greedy
argument of `looking-back' function. Because I'm not a native speaker
so probably this paragraph requires some rephrasing. 


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: searching.diff --]
[-- Type: text/x-diff, Size: 1193 bytes --]

diff -ud /home/sewi/emacs_cvs/emacs/doc/lispref/searching.texi /home/sewi/emacs_cvs/emacs/doc/lispref/searching_cor.texi
--- /home/sewi/zrodla/elisp_files/emacs_cvs/emacs/doc/lispref/searching.texi	2008-11-02 19:39:21.000000000 +0100
+++ /home/sewi/zrodla/elisp_files/emacs_cvs/emacs/doc/lispref/searching_cor.texi	2008-11-02 19:54:10.000000000 +0100
@@ -1094,7 +1094,7 @@
 @end example
 @end defun
 
-@defun looking-back regexp &optional limit
+@defun looking-back regexp &optional limit greedy
 This function returns @code{t} if @var{regexp} matches text before
 point, ending at point, and @code{nil} otherwise.
 
@@ -1105,6 +1105,10 @@
 not to search before @var{limit}.  In this case, the match that is
 found must begin at or after @var{limit}.
 
+If greedy is non-nil, extend the match backwards as far as possible,
+stopping when a single additional previous character cannot be part
+of a match for regexp.
+
 @example
 @group
 ---------- Buffer: foo ----------
@@ -1408,7 +1412,7 @@
   (re-search-forward "The \\(cat \\)")
   (match-beginning 0)
   (match-beginning 1))
-    @result{} (9 9 13)
+    @result{} (17 9 13)
 @end group
 
 @group

Diff finished.  Sun Nov  2 19:54:17 2008

[-- Attachment #3: Type: text/plain, Size: 28 bytes --]


-- 
regards,
Seweryn Kokot

bug#1299: lispref - searching.texi: Updating of looking-back arguments and return values in the example

[martin rudalics]

 > See the diff attached. Note that I copied the explanation for greedy
 > argument of `looking-back' function. Because I'm not a native speaker
 > so probably this paragraph requires some rephrasing.

FWIW, it might not harm to also resolve the contradiction that REGEXP
can match _before_ LIMIT when GREEDY is non-nil (in the manual _and_ the
doc-string).

martin