diff options
| author | Charles A. Roelli | 2018-10-28 18:07:01 +0100 |
|---|---|---|
| committer | Charles A. Roelli | 2018-10-28 18:07:01 +0100 |
| commit | 10e0fd8ca955070682d5f09231a7a386ef185fa5 (patch) | |
| tree | e629b1a32b1b2947ab014141c99ccb911c6133d7 | |
| parent | de2818432acacea4eec35d5a92f240856de7b765 (diff) | |
| download | emacs-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.texi | 117 |
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 |
| 119 | brought it. Also, any command not specially meaningful in searches | 121 | cursor where the search brought it. Also, any command not specially |
| 120 | stops the searching and is then executed. Thus, typing @kbd{C-a} | 122 | meaningful in searches stops the searching and is then executed. |
| 121 | exits the search and then moves to the beginning of the line; typing | 123 | Thus, typing @kbd{C-a} exits the search and then moves to the |
| 122 | one of the arrow keys exits the search and performs the respective | 124 | beginning of the line; typing one of the arrow keys exits the search |
| 123 | movement command; etc. @key{RET} is necessary only if the next | 125 | and performs the respective movement command; etc. @key{RET} is |
| 124 | command you want to type is a printing character, @key{DEL}, | 126 | necessary only if the next command you want to type is a printing |
| 125 | @key{RET}, or another character that is special within searches | 127 | character, @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}, | 128 | within 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 |
| 128 | You can fine-tune the commands that exit the search; see @ref{Not | 130 | described below). You can fine-tune the commands that exit the |
| 129 | Exiting Isearch}. | 131 | search; 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 |
| 132 | empty launches nonincremental search (@pxref{Nonincremental Search}). | 134 | empty 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, |
| 136 | type @kbd{@key{ESC} @key{ESC} @key{ESC}} (@code{isearch-cancel}) or | 142 | type @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 |
| 158 | the one you expected to find: the @samp{FOO} you were aiming for | 168 | the one you expected to find: the @samp{FOO} you were aiming for |
| 159 | occurs later in the buffer. In this event, type another @kbd{C-s} to | 169 | occurs later in the buffer. In this event, type another @kbd{C-s} |
| 160 | move 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 |
| 161 | any number of times. If you overshoot, you can cancel some @kbd{C-s} | 171 | search string. You can repeat this any number of times. If you |
| 162 | characters with @key{DEL}. Similarly, each @kbd{C-r} in a backward | 172 | overshoot, you can cancel some @kbd{C-s} commands with @key{DEL}. |
| 163 | incremental search repeats the backward search. | 173 | Similarly, each @kbd{C-r} (@code{isearch-repeat-backward}) in a |
| 174 | backward 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 | |||
| 200 | you have already seen. | 211 | you 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 |
| 207 | commands @kbd{M-p} and @kbd{M-n} move through the ring to pick a | 220 | commands @kbd{M-p} (@code{isearch-ring-retreat}) and @kbd{M-n} |
| 208 | search string to reuse. These commands leave the selected search ring | 221 | (@code{isearch-ring-advance}) move through the ring to pick a search |
| 222 | string to reuse. These commands leave the selected search ring | ||
| 209 | element in the minibuffer, where you can edit it. Type | 223 | element 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 |
| 211 | searching for it. The number of most recently used search strings | 225 | 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 | |||
| 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 |
| 220 | replacing it with items from the search ring, type @kbd{M-e} or click | 235 | replacing 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 | 237 | Type @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 | 238 | and search for it. Type @kbd{C-f} or @kbd{@key{RIGHT}} to add to the |
| 224 | following point from the buffer from which you started the search. | 239 | search string characters following point from the buffer from which |
| 240 | you 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 |
| 360 | Type @kbd{C-q}, followed by a non-graphic character or a sequence of | 376 | @findex isearch-quote-char |
| 361 | octal digits. This adds a character to the search string, similar to | 377 | @kindex C-q @r{(Incremental Search)} |
| 362 | inserting into a buffer using @kbd{C-q} (@pxref{Inserting Text}). For | 378 | Type @kbd{C-q} (@code{isearch-quote-char}), followed by a non-graphic |
| 363 | example, @kbd{C-q C-s} during incremental search adds the | 379 | character or a sequence of octal digits. This adds a character to the |
| 364 | @samp{control-S} character to the search string. | 380 | search string, similar to inserting into a buffer using @kbd{C-q} |
| 381 | (@pxref{Inserting Text}). For example, @kbd{C-q C-s} during | ||
| 382 | incremental search adds the @samp{control-S} character to the search | ||
| 383 | string. | ||
| 365 | 384 | ||
| 366 | @item | 385 | @item |
| 367 | Type @kbd{C-x 8 @key{RET}}, followed by a Unicode name or code-point | 386 | @findex isearch-char-by-name |
| 368 | in hex. This adds the specified character into the search string, | 387 | @kindex C-x 8 RET @r{(Incremental Search)} |
| 369 | similar to the usual @code{insert-char} command (@pxref{Inserting | 388 | Type @kbd{C-x 8 @key{RET}} (@code{isearch-char-by-name}), followed by |
| 370 | Text}). | 389 | a Unicode name or code-point in hex. This adds the specified |
| 390 | character 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 |
| 401 | string. @xref{Other Repeating Search, occur}. | 422 | string. @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)} |
| 405 | or @code{query-replace-regexp} (depending on search mode) with the | 428 | Typing @kbd{M-%} (@code{isearch-query-replace}) in incremental |
| 406 | current search string used as the string to replace. A negative | 429 | search invokes @code{query-replace} or @code{query-replace-regexp} |
| 407 | prefix argument means to replace backward. @xref{Query Replace}. | 430 | (depending on search mode) with the current search string used as the |
| 408 | 431 | string to replace. A negative prefix argument means to replace | |
| 432 | backward. @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 | ||
| 435 | regexp 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. | |||
| 599 | Search the Web for the text in region. | 628 | Search 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 |
| 605 | incremental search is not already active, this runs the command | 635 | incremental 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 |
| 608 | search while keeping the direction of the search and the current | 638 | @code{isearch-toggle-word}, which switches to a word search while |
| 609 | search string unchanged. You can toggle word search back off by | 639 | keeping the direction of the search and the current search string |
| 610 | typing @kbd{M-s w} again. | 640 | unchanged. You can toggle word search back off by typing @kbd{M-s w} |
| 641 | again. | ||
| 611 | 642 | ||
| 612 | @findex word-search-forward | 643 | @findex word-search-forward |
| 613 | @findex word-search-backward | 644 | @findex word-search-backward |