aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorCharles A. Roelli2018-10-28 18:07:01 +0100
committerCharles A. Roelli2018-10-28 18:07:01 +0100
commit10e0fd8ca955070682d5f09231a7a386ef185fa5 (patch)
treee629b1a32b1b2947ab014141c99ccb911c6133d7
parentde2818432acacea4eec35d5a92f240856de7b765 (diff)
downloademacs-10e0fd8ca955070682d5f09231a7a386ef185fa5.tar.gz
emacs-10e0fd8ca955070682d5f09231a7a386ef185fa5.zip
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.
-rw-r--r--doc/emacs/search.texi117
1 files changed, 74 insertions, 43 deletions
diff --git a/doc/emacs/search.texi b/doc/emacs/search.texi
index 58a76580d76..33aa0dd1c7b 100644
--- a/doc/emacs/search.texi
+++ b/doc/emacs/search.texi
@@ -114,24 +114,30 @@ Isearch}, for more about dealing with unsuccessful search.
114 114
115@cindex exit incremental search 115@cindex exit incremental search
116@cindex incremental search, exiting 116@cindex incremental search, exiting
117@findex isearch-exit
118@kindex RET @r{(Incremental search)}
117 When you are satisfied with the place you have reached, type 119 When you are satisfied with the place you have reached, type
118@key{RET}. This stops searching, leaving the cursor where the search 120@key{RET} (@code{isearch-exit}). This stops searching, leaving the
119brought it. Also, any command not specially meaningful in searches 121cursor where the search brought it. Also, any command not specially
120stops the searching and is then executed. Thus, typing @kbd{C-a} 122meaningful in searches stops the searching and is then executed.
121exits the search and then moves to the beginning of the line; typing 123Thus, typing @kbd{C-a} exits the search and then moves to the
122one of the arrow keys exits the search and performs the respective 124beginning of the line; typing one of the arrow keys exits the search
123movement command; etc. @key{RET} is necessary only if the next 125and performs the respective movement command; etc. @key{RET} is
124command you want to type is a printing character, @key{DEL}, 126necessary only if the next command you want to type is a printing
125@key{RET}, or another character that is special within searches 127character, @key{DEL}, @key{RET}, or another character that is special
126(@kbd{C-q}, @kbd{C-w}, @kbd{C-r}, @kbd{C-s}, @kbd{C-y}, @kbd{M-y}, 128within searches (@kbd{C-q}, @kbd{C-w}, @kbd{C-r}, @kbd{C-s},
127@kbd{M-r}, @kbd{M-c}, @kbd{M-e}, and some others described below). 129@kbd{C-y}, @kbd{M-y}, @kbd{M-r}, @kbd{M-c}, @kbd{M-e}, and some others
128You can fine-tune the commands that exit the search; see @ref{Not 130described below). You can fine-tune the commands that exit the
129Exiting Isearch}. 131search; see @ref{Not Exiting Isearch}.
130 132
131 As a special exception, entering @key{RET} when the search string is 133 As a special exception, entering @key{RET} when the search string is
132empty launches nonincremental search (@pxref{Nonincremental Search}). 134empty launches nonincremental search (@pxref{Nonincremental Search}).
133(This can be customized; see @ref{Search Customizations}.) 135(This can be customized; see @ref{Search Customizations}.)
134 136
137@findex isearch-abort
138@findex isearch-cancel
139@kindex C-g C-g @r{(Incremental Search)}
140@kindex ESC ESC ESC @r{(Incremental Search)}
135 To abandon the search and return to the place where you started, 141 To abandon the search and return to the place where you started,
136type @kbd{@key{ESC} @key{ESC} @key{ESC}} (@code{isearch-cancel}) or 142type @kbd{@key{ESC} @key{ESC} @key{ESC}} (@code{isearch-cancel}) or
137@kbd{C-g C-g} (@code{isearch-abort}). 143@kbd{C-g C-g} (@code{isearch-abort}).
@@ -154,13 +160,18 @@ matches that begin after it.
154@node Repeat Isearch 160@node Repeat Isearch
155@subsection Repeating Incremental Search 161@subsection Repeating Incremental Search
156 162
163@kindex C-s @r{(Incremental Search)}
164@kindex C-r @r{(Incremental Search)}
165@findex isearch-repeat-forward
166@findex isearch-repeat-backward
157 Suppose you search forward for @samp{FOO} and find a match, but not 167 Suppose you search forward for @samp{FOO} and find a match, but not
158the one you expected to find: the @samp{FOO} you were aiming for 168the one you expected to find: the @samp{FOO} you were aiming for
159occurs later in the buffer. In this event, type another @kbd{C-s} to 169occurs later in the buffer. In this event, type another @kbd{C-s}
160move to the next occurrence of the search string. You can repeat this 170(@code{isearch-repeat-forward}) to move to the next occurrence of the
161any number of times. If you overshoot, you can cancel some @kbd{C-s} 171search string. You can repeat this any number of times. If you
162characters with @key{DEL}. Similarly, each @kbd{C-r} in a backward 172overshoot, you can cancel some @kbd{C-s} commands with @key{DEL}.
163incremental search repeats the backward search. 173Similarly, each @kbd{C-r} (@code{isearch-repeat-backward}) in a
174backward incremental search repeats the backward search.
164 175
165@cindex lazy search highlighting 176@cindex lazy search highlighting
166 If you pause for a little while during incremental search, Emacs 177 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
200you have already seen. 211you have already seen.
201 212
202@cindex search ring 213@cindex search ring
214@findex isearch-ring-advance
215@findex isearch-ring-retreat
203@kindex M-n @r{(Incremental search)} 216@kindex M-n @r{(Incremental search)}
204@kindex M-p @r{(Incremental search)} 217@kindex M-p @r{(Incremental search)}
205@vindex search-ring-max 218@vindex search-ring-max
206 To reuse earlier search strings, use the @dfn{search ring}. The 219 To reuse earlier search strings, use the @dfn{search ring}. The
207commands @kbd{M-p} and @kbd{M-n} move through the ring to pick a 220commands @kbd{M-p} (@code{isearch-ring-retreat}) and @kbd{M-n}
208search string to reuse. These commands leave the selected search ring 221(@code{isearch-ring-advance}) move through the ring to pick a search
222string to reuse. These commands leave the selected search ring
209element in the minibuffer, where you can edit it. Type 223element in the minibuffer, where you can edit it. Type
210@kbd{C-s}/@kbd{C-r} or @key{RET} to accept the string and start 224@kbd{C-s}/@kbd{C-r} or @key{RET} to accept the string and start
211searching for it. The number of most recently used search strings 225searching for it. The number of most recently used search strings
@@ -214,14 +228,16 @@ saved in the search ring is specified by the variable
214 228
215@cindex incremental search, edit search string 229@cindex incremental search, edit search string
216@cindex interactively edit search string 230@cindex interactively edit search string
231@findex isearch-edit-string
217@kindex M-e @r{(Incremental search)} 232@kindex M-e @r{(Incremental search)}
218@kindex mouse-1 @r{in the minibuffer (Incremental Search)} 233@kindex mouse-1 @r{in the minibuffer (Incremental Search)}
219 To edit the current search string in the minibuffer without 234 To edit the current search string in the minibuffer without
220replacing it with items from the search ring, type @kbd{M-e} or click 235replacing it with items from the search ring, type @kbd{M-e}
221@kbd{mouse-1} in the minibuffer. Type @key{RET}, @kbd{C-s} or 236(@code{isearch-edit-string}) or click @kbd{mouse-1} in the minibuffer.
222@kbd{C-r} to finish editing the string and search for it. Type 237Type @key{RET}, @kbd{C-s} or @kbd{C-r} to finish editing the string
223@kbd{C-f} or @kbd{@key{RIGHT}} to add to the search string characters 238and search for it. Type @kbd{C-f} or @kbd{@key{RIGHT}} to add to the
224following point from the buffer from which you started the search. 239search string characters following point from the buffer from which
240you started the search.
225 241
226@node Isearch Yank 242@node Isearch Yank
227@subsection Isearch Yanking 243@subsection Isearch Yanking
@@ -357,17 +373,22 @@ following methods:
357 373
358@itemize @bullet 374@itemize @bullet
359@item 375@item
360Type @kbd{C-q}, followed by a non-graphic character or a sequence of 376@findex isearch-quote-char
361octal digits. This adds a character to the search string, similar to 377@kindex C-q @r{(Incremental Search)}
362inserting into a buffer using @kbd{C-q} (@pxref{Inserting Text}). For 378Type @kbd{C-q} (@code{isearch-quote-char}), followed by a non-graphic
363example, @kbd{C-q C-s} during incremental search adds the 379character or a sequence of octal digits. This adds a character to the
364@samp{control-S} character to the search string. 380search string, similar to inserting into a buffer using @kbd{C-q}
381(@pxref{Inserting Text}). For example, @kbd{C-q C-s} during
382incremental search adds the @samp{control-S} character to the search
383string.
365 384
366@item 385@item
367Type @kbd{C-x 8 @key{RET}}, followed by a Unicode name or code-point 386@findex isearch-char-by-name
368in hex. This adds the specified character into the search string, 387@kindex C-x 8 RET @r{(Incremental Search)}
369similar to the usual @code{insert-char} command (@pxref{Inserting 388Type @kbd{C-x 8 @key{RET}} (@code{isearch-char-by-name}), followed by
370Text}). 389a Unicode name or code-point in hex. This adds the specified
390character into the search string, similar to the usual
391@code{insert-char} command (@pxref{Inserting Text}).
371 392
372@item 393@item
373@kindex C-^ @r{(Incremental Search)} 394@kindex C-^ @r{(Incremental Search)}
@@ -400,12 +421,20 @@ current buffer afterwards.
400@code{isearch-occur}, which runs @code{occur} with the current search 421@code{isearch-occur}, which runs @code{occur} with the current search
401string. @xref{Other Repeating Search, occur}. 422string. @xref{Other Repeating Search, occur}.
402 423
424@findex isearch-query-replace
425@findex isearch-query-replace-regexp
403@kindex M-% @r{(Incremental search)} 426@kindex M-% @r{(Incremental search)}
404 Typing @kbd{M-%} in incremental search invokes @code{query-replace} 427@kindex C-M-% @r{(Incremental search)}
405or @code{query-replace-regexp} (depending on search mode) with the 428 Typing @kbd{M-%} (@code{isearch-query-replace}) in incremental
406current search string used as the string to replace. A negative 429search invokes @code{query-replace} or @code{query-replace-regexp}
407prefix argument means to replace backward. @xref{Query Replace}. 430(depending on search mode) with the current search string used as the
408 431string to replace. A negative prefix argument means to replace
432backward. @xref{Query Replace}. Typing @kbd{C-M-%}
433(@code{isearch-query-replace-regexp}) invokes
434@code{query-replace-regexp} with the current search string used as the
435regexp to replace.
436
437@findex isearch-complete
409@kindex M-TAB @r{(Incremental search)} 438@kindex M-TAB @r{(Incremental search)}
410 Typing @kbd{M-@key{TAB}} in incremental search invokes 439 Typing @kbd{M-@key{TAB}} in incremental search invokes
411@code{isearch-complete}, which attempts to complete the search string 440@code{isearch-complete}, which attempts to complete the search string
@@ -599,15 +628,17 @@ Search backward for @var{words}, using a nonincremental word search.
599Search the Web for the text in region. 628Search the Web for the text in region.
600@end table 629@end table
601 630
602@kindex M-s w
603@findex isearch-forward-word 631@findex isearch-forward-word
632@findex isearch-toggle-word
633@kindex M-s w
604 To begin a forward incremental word search, type @kbd{M-s w}. If 634 To begin a forward incremental word search, type @kbd{M-s w}. If
605incremental search is not already active, this runs the command 635incremental search is not already active, this runs the command
606@code{isearch-forward-word}. If incremental search is already active 636@code{isearch-forward-word}. If incremental search is already active
607(whether a forward or backward search), @kbd{M-s w} switches to a word 637(whether a forward or backward search), @kbd{M-s w} runs the command
608search while keeping the direction of the search and the current 638@code{isearch-toggle-word}, which switches to a word search while
609search string unchanged. You can toggle word search back off by 639keeping the direction of the search and the current search string
610typing @kbd{M-s w} again. 640unchanged. You can toggle word search back off by typing @kbd{M-s w}
641again.
611 642
612@findex word-search-forward 643@findex word-search-forward
613@findex word-search-backward 644@findex word-search-backward