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.

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index 6a57c9f..bef70ec 100644 (file)
--- 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 1cbf619..8cc2f71 100644 (file)
--- 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 047a7c6..13b96b4 100644 (file)
--- 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 5037f0c..27f002f 100644 (file)
--- 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.
 

diff --git a/etc/NEWS b/etc/NEWS
index 9a69873..78b2df2 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -423,6 +423,7 @@ macros in registers.
 This searches the region for identical lines, and removes all but one
 copy of each repeated line.  The lines need not be sorted.
 
++++
 ** `blink-matching-paren' now only highlights the matching open-paren
 by default, instead of moving cursor.  Set this variable to `jump' to
 enable the old behavior.