Improve discoverability of 'read-buffer-completion-ignore-case'

* lisp/window.el (switch-to-buffer)
(switch-to-buffer-other-window, switch-to-buffer-other-frame):
Mention 'read-buffer' in the doc string.  (Bug#29389)

* doc/emacs/buffers.texi (Select Buffer): Add a cross-reference to
where 'read-buffer-completion-ignore-case' is documented.
This commit is contained in:
Eli Zaretskii 2017-11-24 15:58:00 +02:00
parent eea4e9194c
commit 8a2b204e64
2 changed files with 17 additions and 13 deletions

View file

@ -98,7 +98,8 @@ related commands, use @dfn{permissive completion with confirmation} for
minibuffer completion: if you type @key{RET} immediately after minibuffer completion: if you type @key{RET} immediately after
completing up to a nonexistent buffer name, Emacs prints completing up to a nonexistent buffer name, Emacs prints
@samp{[Confirm]} and you must type a second @key{RET} to submit that @samp{[Confirm]} and you must type a second @key{RET} to submit that
buffer name. @xref{Completion Exit}, for details. buffer name. @xref{Completion Exit}, for details. For other
completion options and features, see @ref{Completion Options}.
If you specify a buffer that does not exist, @kbd{C-x b} creates a If you specify a buffer that does not exist, @kbd{C-x b} creates a
new, empty buffer that is not visiting any file, and selects it for new, empty buffer that is not visiting any file, and selects it for

View file

@ -7655,10 +7655,11 @@ another window. In interactive use, if the selected window is
strongly dedicated to its buffer, the value of the option strongly dedicated to its buffer, the value of the option
`switch-to-buffer-in-dedicated-window' specifies how to proceed. `switch-to-buffer-in-dedicated-window' specifies how to proceed.
If called interactively, read the buffer name using the If called interactively, read the buffer name using `read-buffer'.
minibuffer. The variable `confirm-nonexistent-file-or-buffer' The variable `confirm-nonexistent-file-or-buffer' determines
determines whether to request confirmation before creating a new whether to request confirmation before creating a new buffer.
buffer. See `read-buffer' for features related to input and completion
of buffer names.
BUFFER-OR-NAME may be a buffer, a string (a buffer name), or nil. BUFFER-OR-NAME may be a buffer, a string (a buffer name), or nil.
If BUFFER-OR-NAME is a string that does not identify an existing If BUFFER-OR-NAME is a string that does not identify an existing
@ -7735,10 +7736,11 @@ Return the buffer switched to."
BUFFER-OR-NAME may be a buffer, a string (a buffer name), or BUFFER-OR-NAME may be a buffer, a string (a buffer name), or
nil. Return the buffer switched to. nil. Return the buffer switched to.
If called interactively, prompt for the buffer name using the If called interactively, read the buffer name using `read-buffer'.
minibuffer. The variable `confirm-nonexistent-file-or-buffer' The variable `confirm-nonexistent-file-or-buffer' determines
determines whether to request confirmation before creating a new whether to request confirmation before creating a new buffer.
buffer. See `read-buffer' for features related to input and completion
of buffer names.
If BUFFER-OR-NAME is a string and does not identify an existing If BUFFER-OR-NAME is a string and does not identify an existing
buffer, create a new buffer with that name. If BUFFER-OR-NAME is buffer, create a new buffer with that name. If BUFFER-OR-NAME is
@ -7759,10 +7761,11 @@ documentation for additional customization information."
BUFFER-OR-NAME may be a buffer, a string (a buffer name), or BUFFER-OR-NAME may be a buffer, a string (a buffer name), or
nil. Return the buffer switched to. nil. Return the buffer switched to.
If called interactively, prompt for the buffer name using the If called interactively, read the buffer name using `read-buffer'.
minibuffer. The variable `confirm-nonexistent-file-or-buffer' The variable `confirm-nonexistent-file-or-buffer' determines
determines whether to request confirmation before creating a new whether to request confirmation before creating a new buffer.
buffer. See `read-buffer' for features related to input and completion
of buffer names.
If BUFFER-OR-NAME is a string and does not identify an existing If BUFFER-OR-NAME is a string and does not identify an existing
buffer, create a new buffer with that name. If BUFFER-OR-NAME is buffer, create a new buffer with that name. If BUFFER-OR-NAME is