Update `blink-matching-paren' in the manual

* doc/emacs/programs.texi (Matching): Update WRT to the new
`blink-matchin-paren' behavior.

* doc/lispref/display.texi (Blinking): Update WRT to the new
`blink-matchin-paren' behavior.

4 files changed, 24 insertions, 13 deletions

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index 6a57c9fbc89..bef70ec7181 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,8 @@
+2014-03-15  Dmitry Gutov  <dgutov@yandex.ru>
+
+        * programs.texi (Matching): Update WRT to the new
+        `blink-matchin-paren' behavior.
+
 2014-03-13  Paul Eggert  <eggert@cs.ucla.edu>
 
         * mule.texi (International, Language Environments): Update
diff --git a/doc/emacs/programs.texi b/doc/emacs/programs.texi
index 1cbf61970c0..8cc2f713c4b 100644
--- a/doc/emacs/programs.texi
+++ b/doc/emacs/programs.texi
@@ -813,13 +813,13 @@ as in @samp{[x)}---a warning message is displayed in the echo area.
 @itemize @bullet
 @item
 @code{blink-matching-paren} turns the feature on or off: @code{nil}
-disables it, but the default is @code{t} to enable it.
+disables it, but the default is @code{t} to enable it.  Set it to
+@code{jump} to make indication work through cursor movement.
 
 @item
-@code{blink-matching-delay} says how many seconds to leave the cursor
-on the matching opening delimiter, before bringing it back to the real
-location of point.  This may be an integer or floating-point number;
-the default is 1.
+@code{blink-matching-delay} says how many seconds to keep indicating
+the matching opening delimiter.  This may be an integer or
+floating-point number; the default is 1.
 
 @item
 @code{blink-matching-paren-distance} specifies how many characters
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 047a7c6f3b7..13b96b4ba5e 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2014-03-15  Dmitry Gutov  <dgutov@yandex.ru>
+
+        * display.texi (Blinking): Update WRT to the new
+        `blink-matchin-paren' behavior.
+
 2014-03-14  Martin Rudalics  <rudalics@gmx.at>
 
         * display.texi (Temporary Displays): Say that
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 5037f0c9032..27f002fe5fe 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -5957,18 +5957,19 @@ parenthesis before giving up.
 @end defopt
 
 @defopt blink-matching-delay
-This variable specifies the number of seconds for the cursor to remain
-at the matching parenthesis.  A fraction of a second often gives
-good results, but the default is 1, which works on all systems.
+This variable specifies the number of seconds to keep indicating the
+matching parenthesis.  A fraction of a second often gives good
+results, but the default is 1, which works on all systems.
 @end defopt
 
 @deffn Command blink-matching-open
 This function is the default value of @code{blink-paren-function}.  It
-assumes that point follows a character with close parenthesis syntax and
-moves the cursor momentarily to the matching opening character.  If that
-character is not already on the screen, it displays the character's
-context in the echo area.  To avoid long delays, this function does not
-search farther than @code{blink-matching-paren-distance} characters.
+assumes that point follows a character with close parenthesis syntax
+and applies the appropriate effect momentarily to the matching opening
+character.  If that character is not already on the screen, it
+displays the character's context in the echo area.  To avoid long
+delays, this function does not search farther than
+@code{blink-matching-paren-distance} characters.
 
 Here is an example of calling this function explicitly.