]> code.delx.au - gnu-emacs/commitdiff
Update `blink-matching-paren' in the manual
authorDmitry Gutov <dgutov@yandex.ru>
Sat, 15 Mar 2014 03:07:06 +0000 (05:07 +0200)
committerDmitry Gutov <dgutov@yandex.ru>
Sat, 15 Mar 2014 03:07:06 +0000 (05:07 +0200)
* 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.

doc/emacs/ChangeLog
doc/emacs/programs.texi
doc/lispref/ChangeLog
doc/lispref/display.texi
etc/NEWS

index 6a57c9fbc8956cf37d81482e88cc5bd5f6f83878..bef70ec718186261d1072396f24aadccadb5b000 100644 (file)
@@ -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
index 1cbf61970c01a6312b4ab2742a342e80ff876e24..8cc2f713c4b319117f896261c794ae31652790c7 100644 (file)
@@ -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
index 047a7c6f3b701aa599423224b8fc8c7d62ca3456..13b96b4ba5e60f15cb89c112459811880ae87e56 100644 (file)
@@ -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
index 5037f0c9032a3970fe194575207833ef82ec0087..27f002fe5fe3c69646dff6e39af9cc441963c74d 100644 (file)
@@ -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.
 
index 9a69873e0f23e9f8cc6471f185a1c47205b90858..78b2df2ecc41ddbbd467ceda62d1f24d18116df8 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.