summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorLars Ingebrigtsen <larsi@gnus.org>2022-09-02 14:23:15 +0200
committerLars Ingebrigtsen <larsi@gnus.org>2022-09-02 14:23:15 +0200
commit9474ac1b61935b198a2cf252e7b0ec9cfa70344e (patch)
tree5b73249386403dfca67cdbde52ec4310c9590790 /doc
parent3de942542a2618100de13554aaf05a8158017fef (diff)
downloademacs-9474ac1b61935b198a2cf252e7b0ec9cfa70344e.tar.gz
Default show-paren-mode to off in special-mode buffers
* doc/emacs/programs.texi (Matching): Mention the new user option. * doc/misc/efaq.texi (Matching parentheses): Adjust text to the current state of affairs. * lisp/paren.el (show-paren-function): New user option (bug#50894). (show-paren-mode): Mention it. (show-paren-function): Use it.
Diffstat (limited to 'doc')
-rw-r--r--doc/emacs/programs.texi14
-rw-r--r--doc/misc/efaq.texi11
2 files changed, 11 insertions, 14 deletions
diff --git a/doc/emacs/programs.texi b/doc/emacs/programs.texi
index 795aabee743..b87c659483a 100644
--- a/doc/emacs/programs.texi
+++ b/doc/emacs/programs.texi
@@ -834,10 +834,16 @@ of automatic matching. Whenever point is before an opening delimiter
or after a closing delimiter, the delimiter, its matching delimiter,
and optionally the text between them are highlighted. To toggle Show
Paren mode globally, type @kbd{M-x show-paren-mode}. To toggle it
-only in the current buffer, type @kbd{M-x show-paren-local-mode}. To
-customize it, type @w{@kbd{M-x customize-group @key{RET} paren-showing}}.
-The customizable options which control the operation of this mode
-include:
+only in the current buffer, type @kbd{M-x show-paren-local-mode}.
+
+@vindex show-paren-predicate
+ By default, this mode is switched on in all buffers that are meant
+for editing, but is not enabled in buffers that show data. This is
+controlled by the @code{show-paren-predicate} user option.
+
+ To customize the mode, type @w{@kbd{M-x customize-group @key{RET}
+paren-showing}}. The customizable options which control the operation
+of this mode include:
@itemize @bullet
@item
diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi
index 43fa0054346..8ec23a529df 100644
--- a/doc/misc/efaq.texi
+++ b/doc/misc/efaq.texi
@@ -2364,16 +2364,7 @@ new paragraph. There are many packages available to deal with this
@cindex Pairs of parentheses, highlighting
@cindex Matching parentheses
-Call @code{show-paren-mode} in your init file (@pxref{Setting up a
-customization file}):
-
-@lisp
-(show-paren-mode 1)
-@end lisp
-
-You can also enable this mode by selecting the @samp{Paren Match
-Highlighting} option from the @samp{Options} menu of the Emacs menu bar
-at the top of any Emacs frame.
+By default, @code{show-paren-mode} is enabled in all editing buffers.
Alternatives to this mode include: