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.
This commit is contained in:
Dmitry Gutov 2014-03-15 05:07:06 +02:00
parent 881033454a
commit 480d4f5784
5 changed files with 25 additions and 13 deletions

View 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

View 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

View 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

View 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.

View file

@ -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.