Refine documentation of `looking-back'.

* lisp/subr.el (looking-back): Do not recommend using looking-back.  (bug#5689)
* doc/lispref/searching.texi (Regexp Search): Refine.

2 files changed, 11 insertions, 7 deletions

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 2fa3fc13e31..4a55b17127d 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,7 @@
+2013-09-29  Xue Fuqiao  <xfq.free@gmail.com>
+
+        * searching.texi (Regexp Search): Refine.
+
 2013-09-22  Xue Fuqiao  <xfq.free@gmail.com>
 
         * nonascii.texi (Default Coding Systems): Typo fix.
diff --git a/doc/lispref/searching.texi b/doc/lispref/searching.texi
index 386d5bdde4c..993c2b26772 100644
--- a/doc/lispref/searching.texi
+++ b/doc/lispref/searching.texi
@@ -1146,13 +1146,7 @@ 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}.
-
-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}.
+found must begin at or after @var{limit}.  Here's an example:
 
 @example
 @group
@@ -1168,6 +1162,12 @@ comes back" twice.
 @end group
 @end example
 
+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}.
+
 @c http://debbugs.gnu.org/5689
 As a general recommendation, try to avoid using @code{looking-back}
 wherever possible, since it is slow.  For this reason, there are no