mirror of
https://github.com/masscollaborationlabs/emacs.git
synced 2025-07-06 12:19:37 +00:00
Add index entries for more isearch commands/bindings (Bug#32990)
* doc/emacs/search.texi (Basic Isearch): Index isearch-exit, isearch-abort, isearch-cancel, isearch-repeat-forward, isearch-repeat-backward and their bindings. (Repeat Isearch): Index isearch-ring-advance, isearch-ring-retreat and isearch-edit-string. (Special Isearch): Index isearch-quote-char, isearch-char-by-name and their bindings. Index isearch-query-replace and isearch-query-replace-regexp, and the latter's binding. Explain what isearch-query-replace-regexp does. Index isearch-complete. (Word Search): Index isearch-toggle-word.
This commit is contained in:
parent
de2818432a
commit
10e0fd8ca9
1 changed files with 73 additions and 42 deletions
|
@ -114,24 +114,30 @@ Isearch}, for more about dealing with unsuccessful search.
|
||||||
|
|
||||||
@cindex exit incremental search
|
@cindex exit incremental search
|
||||||
@cindex incremental search, exiting
|
@cindex incremental search, exiting
|
||||||
|
@findex isearch-exit
|
||||||
|
@kindex RET @r{(Incremental search)}
|
||||||
When you are satisfied with the place you have reached, type
|
When you are satisfied with the place you have reached, type
|
||||||
@key{RET}. This stops searching, leaving the cursor where the search
|
@key{RET} (@code{isearch-exit}). This stops searching, leaving the
|
||||||
brought it. Also, any command not specially meaningful in searches
|
cursor where the search brought it. Also, any command not specially
|
||||||
stops the searching and is then executed. Thus, typing @kbd{C-a}
|
meaningful in searches stops the searching and is then executed.
|
||||||
exits the search and then moves to the beginning of the line; typing
|
Thus, typing @kbd{C-a} exits the search and then moves to the
|
||||||
one of the arrow keys exits the search and performs the respective
|
beginning of the line; typing one of the arrow keys exits the search
|
||||||
movement command; etc. @key{RET} is necessary only if the next
|
and performs the respective movement command; etc. @key{RET} is
|
||||||
command you want to type is a printing character, @key{DEL},
|
necessary only if the next command you want to type is a printing
|
||||||
@key{RET}, or another character that is special within searches
|
character, @key{DEL}, @key{RET}, or another character that is special
|
||||||
(@kbd{C-q}, @kbd{C-w}, @kbd{C-r}, @kbd{C-s}, @kbd{C-y}, @kbd{M-y},
|
within searches (@kbd{C-q}, @kbd{C-w}, @kbd{C-r}, @kbd{C-s},
|
||||||
@kbd{M-r}, @kbd{M-c}, @kbd{M-e}, and some others described below).
|
@kbd{C-y}, @kbd{M-y}, @kbd{M-r}, @kbd{M-c}, @kbd{M-e}, and some others
|
||||||
You can fine-tune the commands that exit the search; see @ref{Not
|
described below). You can fine-tune the commands that exit the
|
||||||
Exiting Isearch}.
|
search; see @ref{Not Exiting Isearch}.
|
||||||
|
|
||||||
As a special exception, entering @key{RET} when the search string is
|
As a special exception, entering @key{RET} when the search string is
|
||||||
empty launches nonincremental search (@pxref{Nonincremental Search}).
|
empty launches nonincremental search (@pxref{Nonincremental Search}).
|
||||||
(This can be customized; see @ref{Search Customizations}.)
|
(This can be customized; see @ref{Search Customizations}.)
|
||||||
|
|
||||||
|
@findex isearch-abort
|
||||||
|
@findex isearch-cancel
|
||||||
|
@kindex C-g C-g @r{(Incremental Search)}
|
||||||
|
@kindex ESC ESC ESC @r{(Incremental Search)}
|
||||||
To abandon the search and return to the place where you started,
|
To abandon the search and return to the place where you started,
|
||||||
type @kbd{@key{ESC} @key{ESC} @key{ESC}} (@code{isearch-cancel}) or
|
type @kbd{@key{ESC} @key{ESC} @key{ESC}} (@code{isearch-cancel}) or
|
||||||
@kbd{C-g C-g} (@code{isearch-abort}).
|
@kbd{C-g C-g} (@code{isearch-abort}).
|
||||||
|
@ -154,13 +160,18 @@ 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-r @r{(Incremental Search)}
|
||||||
|
@findex isearch-repeat-forward
|
||||||
|
@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
|
||||||
the one you expected to find: the @samp{FOO} you were aiming for
|
the one you expected to find: the @samp{FOO} you were aiming for
|
||||||
occurs later in the buffer. In this event, type another @kbd{C-s} to
|
occurs later in the buffer. In this event, type another @kbd{C-s}
|
||||||
move to the next occurrence of the search string. You can repeat this
|
(@code{isearch-repeat-forward}) to move to the next occurrence of the
|
||||||
any number of times. If you overshoot, you can cancel some @kbd{C-s}
|
search string. You can repeat this any number of times. If you
|
||||||
characters with @key{DEL}. Similarly, each @kbd{C-r} in a backward
|
overshoot, you can cancel some @kbd{C-s} commands with @key{DEL}.
|
||||||
incremental search repeats the backward search.
|
Similarly, each @kbd{C-r} (@code{isearch-repeat-backward}) in a
|
||||||
|
backward incremental search repeats the backward search.
|
||||||
|
|
||||||
@cindex lazy search highlighting
|
@cindex lazy search highlighting
|
||||||
If you pause for a little while during incremental search, Emacs
|
If you pause for a little while during incremental search, Emacs
|
||||||
|
@ -200,12 +211,15 @@ going past the original starting point of the search, it changes to
|
||||||
you have already seen.
|
you have already seen.
|
||||||
|
|
||||||
@cindex search ring
|
@cindex search ring
|
||||||
|
@findex isearch-ring-advance
|
||||||
|
@findex isearch-ring-retreat
|
||||||
@kindex M-n @r{(Incremental search)}
|
@kindex M-n @r{(Incremental search)}
|
||||||
@kindex M-p @r{(Incremental search)}
|
@kindex M-p @r{(Incremental search)}
|
||||||
@vindex search-ring-max
|
@vindex search-ring-max
|
||||||
To reuse earlier search strings, use the @dfn{search ring}. The
|
To reuse earlier search strings, use the @dfn{search ring}. The
|
||||||
commands @kbd{M-p} and @kbd{M-n} move through the ring to pick a
|
commands @kbd{M-p} (@code{isearch-ring-retreat}) and @kbd{M-n}
|
||||||
search string to reuse. These commands leave the selected search ring
|
(@code{isearch-ring-advance}) move through the ring to pick a search
|
||||||
|
string to reuse. These commands leave the selected search ring
|
||||||
element in the minibuffer, where you can edit it. Type
|
element in the minibuffer, where you can edit it. Type
|
||||||
@kbd{C-s}/@kbd{C-r} or @key{RET} to accept the string and start
|
@kbd{C-s}/@kbd{C-r} or @key{RET} to accept the string and start
|
||||||
searching for it. The number of most recently used search strings
|
searching for it. The number of most recently used search strings
|
||||||
|
@ -214,14 +228,16 @@ saved in the search ring is specified by the variable
|
||||||
|
|
||||||
@cindex incremental search, edit search string
|
@cindex incremental search, edit search string
|
||||||
@cindex interactively edit search string
|
@cindex interactively edit search string
|
||||||
|
@findex isearch-edit-string
|
||||||
@kindex M-e @r{(Incremental search)}
|
@kindex M-e @r{(Incremental search)}
|
||||||
@kindex mouse-1 @r{in the minibuffer (Incremental Search)}
|
@kindex mouse-1 @r{in the minibuffer (Incremental Search)}
|
||||||
To edit the current search string in the minibuffer without
|
To edit the current search string in the minibuffer without
|
||||||
replacing it with items from the search ring, type @kbd{M-e} or click
|
replacing it with items from the search ring, type @kbd{M-e}
|
||||||
@kbd{mouse-1} in the minibuffer. Type @key{RET}, @kbd{C-s} or
|
(@code{isearch-edit-string}) or click @kbd{mouse-1} in the minibuffer.
|
||||||
@kbd{C-r} to finish editing the string and search for it. Type
|
Type @key{RET}, @kbd{C-s} or @kbd{C-r} to finish editing the string
|
||||||
@kbd{C-f} or @kbd{@key{RIGHT}} to add to the search string characters
|
and search for it. Type @kbd{C-f} or @kbd{@key{RIGHT}} to add to the
|
||||||
following point from the buffer from which you started the search.
|
search string characters following point from the buffer from which
|
||||||
|
you started the search.
|
||||||
|
|
||||||
@node Isearch Yank
|
@node Isearch Yank
|
||||||
@subsection Isearch Yanking
|
@subsection Isearch Yanking
|
||||||
|
@ -357,17 +373,22 @@ following methods:
|
||||||
|
|
||||||
@itemize @bullet
|
@itemize @bullet
|
||||||
@item
|
@item
|
||||||
Type @kbd{C-q}, followed by a non-graphic character or a sequence of
|
@findex isearch-quote-char
|
||||||
octal digits. This adds a character to the search string, similar to
|
@kindex C-q @r{(Incremental Search)}
|
||||||
inserting into a buffer using @kbd{C-q} (@pxref{Inserting Text}). For
|
Type @kbd{C-q} (@code{isearch-quote-char}), followed by a non-graphic
|
||||||
example, @kbd{C-q C-s} during incremental search adds the
|
character or a sequence of octal digits. This adds a character to the
|
||||||
@samp{control-S} character to the search string.
|
search string, similar to inserting into a buffer using @kbd{C-q}
|
||||||
|
(@pxref{Inserting Text}). For example, @kbd{C-q C-s} during
|
||||||
|
incremental search adds the @samp{control-S} character to the search
|
||||||
|
string.
|
||||||
|
|
||||||
@item
|
@item
|
||||||
Type @kbd{C-x 8 @key{RET}}, followed by a Unicode name or code-point
|
@findex isearch-char-by-name
|
||||||
in hex. This adds the specified character into the search string,
|
@kindex C-x 8 RET @r{(Incremental Search)}
|
||||||
similar to the usual @code{insert-char} command (@pxref{Inserting
|
Type @kbd{C-x 8 @key{RET}} (@code{isearch-char-by-name}), followed by
|
||||||
Text}).
|
a Unicode name or code-point in hex. This adds the specified
|
||||||
|
character into the search string, similar to the usual
|
||||||
|
@code{insert-char} command (@pxref{Inserting Text}).
|
||||||
|
|
||||||
@item
|
@item
|
||||||
@kindex C-^ @r{(Incremental Search)}
|
@kindex C-^ @r{(Incremental Search)}
|
||||||
|
@ -400,12 +421,20 @@ current buffer afterwards.
|
||||||
@code{isearch-occur}, which runs @code{occur} with the current search
|
@code{isearch-occur}, which runs @code{occur} with the current search
|
||||||
string. @xref{Other Repeating Search, occur}.
|
string. @xref{Other Repeating Search, occur}.
|
||||||
|
|
||||||
|
@findex isearch-query-replace
|
||||||
|
@findex isearch-query-replace-regexp
|
||||||
@kindex M-% @r{(Incremental search)}
|
@kindex M-% @r{(Incremental search)}
|
||||||
Typing @kbd{M-%} in incremental search invokes @code{query-replace}
|
@kindex C-M-% @r{(Incremental search)}
|
||||||
or @code{query-replace-regexp} (depending on search mode) with the
|
Typing @kbd{M-%} (@code{isearch-query-replace}) in incremental
|
||||||
current search string used as the string to replace. A negative
|
search invokes @code{query-replace} or @code{query-replace-regexp}
|
||||||
prefix argument means to replace backward. @xref{Query Replace}.
|
(depending on search mode) with the current search string used as the
|
||||||
|
string to replace. A negative prefix argument means to replace
|
||||||
|
backward. @xref{Query Replace}. Typing @kbd{C-M-%}
|
||||||
|
(@code{isearch-query-replace-regexp}) invokes
|
||||||
|
@code{query-replace-regexp} with the current search string used as the
|
||||||
|
regexp to replace.
|
||||||
|
|
||||||
|
@findex isearch-complete
|
||||||
@kindex M-TAB @r{(Incremental search)}
|
@kindex M-TAB @r{(Incremental search)}
|
||||||
Typing @kbd{M-@key{TAB}} in incremental search invokes
|
Typing @kbd{M-@key{TAB}} in incremental search invokes
|
||||||
@code{isearch-complete}, which attempts to complete the search string
|
@code{isearch-complete}, which attempts to complete the search string
|
||||||
|
@ -599,15 +628,17 @@ Search backward for @var{words}, using a nonincremental word search.
|
||||||
Search the Web for the text in region.
|
Search the Web for the text in region.
|
||||||
@end table
|
@end table
|
||||||
|
|
||||||
@kindex M-s w
|
|
||||||
@findex isearch-forward-word
|
@findex isearch-forward-word
|
||||||
|
@findex isearch-toggle-word
|
||||||
|
@kindex M-s w
|
||||||
To begin a forward incremental word search, type @kbd{M-s w}. If
|
To begin a forward incremental word search, type @kbd{M-s w}. If
|
||||||
incremental search is not already active, this runs the command
|
incremental search is not already active, this runs the command
|
||||||
@code{isearch-forward-word}. If incremental search is already active
|
@code{isearch-forward-word}. If incremental search is already active
|
||||||
(whether a forward or backward search), @kbd{M-s w} switches to a word
|
(whether a forward or backward search), @kbd{M-s w} runs the command
|
||||||
search while keeping the direction of the search and the current
|
@code{isearch-toggle-word}, which switches to a word search while
|
||||||
search string unchanged. You can toggle word search back off by
|
keeping the direction of the search and the current search string
|
||||||
typing @kbd{M-s w} again.
|
unchanged. You can toggle word search back off by typing @kbd{M-s w}
|
||||||
|
again.
|
||||||
|
|
||||||
@findex word-search-forward
|
@findex word-search-forward
|
||||||
@findex word-search-backward
|
@findex word-search-backward
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue