From b2c50d7cf36b8df931be0864f586cdf272886b11 Mon Sep 17 00:00:00 2001
From: Stefan Kangas <stefan@marxist.se>
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 36954151633..459fc679443 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)
--
2.39.5