procyberian/emacs
2
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
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 (defcustom blink-matching-paren t
"Non-nil means show matching open-paren when close-paren is inserted. "Non-nil means show matching open-paren when close-paren is inserted.
In addition, if the opening paren is not visible on screen, show If this is non-nil, then when you type a closing delimiter, such as a
its position in the echo area. closing parenthesis or brace, Emacs briefly indicates the location
of the matching opening delimiter.
The valid values are: The valid values are:
nil Disable. t Highlight the matching open-paren if it is visible
non-nil Highlight the opening paren. in the window, otherwise show the text with matching
`jump' Briefly move cursor to its position. open-paren in the echo area. This is the default.
`jump-offscreen' Briefly move cursor to its position, `jump' If the matching open-paren is visible in the window,
even if the opening paren is not on screen." 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 :type '(choice
(const :tag "Disable" nil) (const :tag "Disable" nil)
(const :tag "Highlight" t) (const :tag "Highlight open-paren if visible" t)
(const :tag "Move cursor" jump) (const :tag "Move cursor to open-paren if visible" jump)
(const :tag "Move cursor, even if off screen" jump-offscreen)) (const :tag "Move cursor even if it's off screen" jump-offscreen))
:group 'paren-blinking) :group 'paren-blinking)
(defcustom blink-matching-paren-on-screen t (defcustom blink-matching-paren-on-screen t