; 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 f0d5f9fc20534fdb7b1d706e0adaec270c987ed6..4ff71a3575d8b2288c2da0a1b4e47f32a3e6ed82 100644 (file)
--- 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 258fa499b7934fe420c91c0a7b2f89878322fb7a..3bdc497f18afed03b87a7b184ab0cd4f14e563e0 100644 (file)
--- 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 1495b2e0ad18cbe9378498125ea8ca9fb34c2f61..0787e6390cf256105fe350b8cdfa73c828fbe29c 100644 (file)
--- 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