mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-07 06:50:23 -08:00
Code Issues Projects Releases Wiki Activity

; Improve documentation of isearch ion minibuffer

Browse source 
* doc/emacs/mini.texi (Minibuffer History):
* doc/emacs/search.texi (Repeat Isearch, Isearch Minibuffer):
Improve wording, cross-references, and indexing.  (Bug#79395)
This commit is contained in:
Eli Zaretskii 2025-09-08 14:55:43 +03:00
parent 6544372764
commit e65ebdf329
2 changed files with 26 additions and 21 deletions
Download patch file Download diff file Expand all files Collapse all files

4
doc/emacs/mini.texi
View file

@ -887,8 +887,8 @@ though they are invoked from the minibuffer. An upper-case letter in
the regular expression makes the search case-sensitive (@pxref{Lax the regular expression makes the search case-sensitive (@pxref{Lax
Search}). Search}).
You can also search through the history using an incremental search. You can also search through the minibuffer history using incremental
@xref{Isearch Minibuffer}. search (@kbd{C-s} and @code{C-r}). @xref{Isearch Minibuffer}.
Emacs keeps separate history lists for several different kinds of Emacs keeps separate history lists for several different kinds of
arguments. For example, there is a list for file names, used by all arguments. For example, there is a list for file names, used by all

43
doc/emacs/search.texi
View file

@ -160,8 +160,8 @@ matches that begin after it.
@node Repeat Isearch @node Repeat Isearch
@subsection Repeating Incremental Search @subsection Repeating Incremental Search
@kindex C-s @r{(Incremental Search)} @kindex C-s @r{(repeating incremental search)}
@kindex C-r @r{(Incremental Search)} @kindex C-r @r{(repeating incremental search)}
@findex isearch-repeat-forward @findex isearch-repeat-forward
@findex isearch-repeat-backward @findex isearch-repeat-backward
Suppose you search forward for @samp{FOO} and find a match, but not Suppose you search forward for @samp{FOO} and find a match, but not
@ -660,26 +660,31 @@ but it applies only for certain motion command that have the
@node Isearch Minibuffer @node Isearch Minibuffer
@subsection Searching the Minibuffer @subsection Searching the Minibuffer
@cindex minibuffer history, searching @cindex minibuffer history, searching
@cindex incremental search in minibuffer history
If you start an incremental search while the minibuffer is active, @kindex C-s @r{in minibuffer}
Emacs searches the contents of the minibuffer. Unlike searching an @kindex C-r @r{in minibuffer}
ordinary buffer, the search string is not shown in the echo area, If you start an incremental search while the minibuffer is active, Emacs
because that is used to display the minibuffer. searches the contents of the minibuffer, as in any other buffer. Unlike
searching an ordinary buffer, the search string is not shown in the echo
area, because that is used to display the minibuffer.
If an incremental search fails in the minibuffer, it tries searching If an incremental search in the minibuffer fails to find a match, it
the minibuffer history. @xref{Minibuffer History}. You can visualize tries searching the minibuffer history. @xref{Minibuffer History}.
the minibuffer and its history as a series of pages, with the Emacs pretends that the minibuffer and its history are a series of
earliest history element on the first page and the current minibuffer pages, with the earliest history element on the first page and the
on the last page. A forward search, @kbd{C-s}, searches forward to current minibuffer on the last page. A forward search, @kbd{C-s},
later pages; a reverse search, @kbd{C-r}, searches backwards to searches forward to later pages; a reverse search, @kbd{C-r}, searches
earlier pages. Like in ordinary buffer search, a failing search can backwards to earlier pages. Like in ordinary buffer search, a failing
wrap around, going from the last page to the first page or vice versa. search can wrap around, going from the last page to the first page or
vice versa.
When the current match is on a history element, that history element When an incremental search in the minibuffer finds a match that is part
is pulled into the minibuffer. If you exit the incremental search of a history element, that history element is pulled into the minibuffer
normally (e.g., by typing @key{RET}), it remains in the minibuffer and displayed. If you exit the incremental search normally (e.g., by
afterwards. Canceling the search, with @kbd{C-g}, restores the typing @key{RET}), it remains in the minibuffer afterwards. Canceling
contents of the minibuffer when you began the search. the search, with @kbd{C-g}, restores the contents of the minibuffer to
what it was when you began the search.
@node Nonincremental Search @node Nonincremental Search
@section Nonincremental Search @section Nonincremental Search