From 480d4f5784c64a3d379a3ebfe302612a7f63a77d Mon Sep 17 00:00:00 2001 From: Dmitry Gutov Date: Sat, 15 Mar 2014 05:07:06 +0200 Subject: [PATCH] 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. --- doc/emacs/ChangeLog | 5 +++++ doc/emacs/programs.texi | 10 +++++----- doc/lispref/ChangeLog | 5 +++++ doc/lispref/display.texi | 17 +++++++++-------- etc/NEWS | 1 + 5 files changed, 25 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 + + * programs.texi (Matching): Update WRT to the new + `blink-matchin-paren' behavior. + 2014-03-13 Paul Eggert * 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 + + * display.texi (Blinking): Update WRT to the new + `blink-matchin-paren' behavior. + 2014-03-14 Martin Rudalics * 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. diff --git a/etc/NEWS b/etc/NEWS index 9a69873e0f2..78b2df2ecc4 100644 --- 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. -- 2.39.2