procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Improve documentation and customization of 'blink-matching-paren'

Browse source 
* lisp/simple.el (blink-matching-paren): Fix the wording of the
doc string and the descriptions in the value menu.  (Bug#51032)
This commit is contained in:
Eli Zaretskii 2021-10-07 12:33:29 +03:00
parent 1100fffcd3
commit 160e62a23c
1 changed files with 18 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

28
lisp/simple.el
View file

@ -8419,21 +8419,29 @@ presented."
(defcustom blink-matching-paren t
"Non-nil means show matching open-paren when close-paren is inserted.
In addition, if the opening paren is not visible on screen, show
its position in the echo area.
If this is non-nil, then when you type a closing delimiter, such as a
closing parenthesis or brace, Emacs briefly indicates the location
of the matching opening delimiter.
The valid values are:
nil Disable.
non-nil Highlight the opening paren.
`jump' Briefly move cursor to its position.
`jump-offscreen' Briefly move cursor to its position,
even if the opening paren is not on screen."
t Highlight the matching open-paren if it is visible
in the window, otherwise show the text with matching
open-paren in the echo area. This is the default.
`jump' If the matching open-paren is visible in the window,
briefly move cursor to its position; otherwise show
the text with matching open-paren in the echo area.
`jump-offscreen' Briefly move cursor to the matching open-paren
even if it is not visible in the window.
nil Don't show the matching open-paren.
Any other non-nil value is handled the same as t."
:type '(choice
(const :tag "Disable" nil)
(const :tag "Highlight" t)
(const :tag "Move cursor" jump)
(const :tag "Move cursor, even if off screen" jump-offscreen))
(const :tag "Highlight open-paren if visible" t)
(const :tag "Move cursor to open-paren if visible" jump)
(const :tag "Move cursor even if it's off screen" jump-offscreen))
:group 'paren-blinking)
(defcustom blink-matching-paren-on-screen t