From b2c50d7cf36b8df931be0864f586cdf272886b11 Mon Sep 17 00:00:00 2001 From: Stefan Kangas Date: Tue, 5 Oct 2021 23:11:31 +0200 Subject: [PATCH] Clarify docstring of blink-matching-paren * lisp/simple.el (blink-matching-paren): Clarify docstring. (Bug#51032) --- lisp/simple.el | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/lisp/simple.el b/lisp/simple.el index 369541516333..459fc6794436 100644 --- a/lisp/simple.el +++ b/lisp/simple.el @@ -8419,11 +8419,16 @@ presented." (defcustom blink-matching-paren t "Non-nil means show matching open-paren when close-paren is inserted. -If t, highlight the paren. If `jump', briefly move cursor to its -position. If `jump-offscreen', move cursor there even if the -position is off screen. With any other non-nil value, the -off-screen position of the opening paren will be shown in the -echo area." +In addition, if the opening paren is not visible on screen, show +its position in the echo area. + +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." :type '(choice (const :tag "Disable" nil) (const :tag "Highlight" t)