From: Eli Zaretskii <eliz@gnu.org>
Date: Thu, 12 May 2022 06:29:53 +0000 (+0300)
Subject: ; Improve documentation of 'switch-to-prev-buffer-skip-regexp'
X-Git-Tag: emacs-29.0.90~1910^2~768
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=36e84d228965b08c9a1e95e8e661bd50df4713be;p=emacs.git

; Improve documentation of 'switch-to-prev-buffer-skip-regexp'

* lisp/window.el (switch-to-prev-buffer-skip-regexp):
* etc/NEWS:
* doc/lispref/windows.texi (Window History): Improve wording of
the documentation of 'switch-to-prev-buffer-skip-regexp'.
(Bug#19070)
---

diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index f0d5f9fc205..4ff71a3575d 100644
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -4174,9 +4174,9 @@ these functions can switch to.
 @end defopt
 
 @defopt switch-to-prev-buffer-skip-regexp
-This user option should be either a regular expression, or a list of
-regular expressions, and buffers that have names that match this
-option will be ignored by @code{switch-to-prev-buffer} and
+This user option should be either a regular expression or a list of
+regular expressions.  Buffers whose names match one of those regular
+expressions will be ignored by @code{switch-to-prev-buffer} and
 @code{switch-to-next-buffer} (except when there's no other buffer to
 switch to).
 @end defopt
diff --git a/etc/NEWS b/etc/NEWS
index 258fa499b79..3bdc497f18a 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -258,8 +258,8 @@ startup.  Previously, these functions ignored
 
 +++
 *** New user option 'switch-to-prev-buffer-skip-regexp'.
-This should be a regexp or a list of regexps, and buffers with names
-matching this will be ignored by 'switch-to-prev-buffer' and
+This should be a regexp or a list of regexps; buffers whose names
+match those regexps will be ignored by 'switch-to-prev-buffer' and
 'switch-to-next-buffer'.
 
 ** Menus
diff --git a/lisp/window.el b/lisp/window.el
index 1495b2e0ad1..0787e6390cf 100644
--- a/lisp/window.el
+++ b/lisp/window.el
@@ -4592,10 +4592,10 @@ Also see `switch-to-prev-buffer-skip-regexp'."
   :group 'windows)
 
 (defcustom switch-to-prev-buffer-skip-regexp nil
-  "Regexp matching buffers that should be skipped by `switch-to-prev-buffer'.
-This also affects `switch-to-next-buffer'.
-
-This can either be a regexp or a list of regexps.
+  "Buffers that `switch-to-prev-buffer' and `switch-to-next-buffer' should skip.
+The value can either be a regexp or a list of regexps.  Buffers whose
+names match these regexps are skipped by `switch-to-prev-buffer'
+and `switch-to-next-buffer'.
 
 Also see `switch-to-prev-buffer-skip'."
   :type '(choice regexp