diff options
| author | Juri Linkov | 2004-07-01 11:50:29 +0000 |
|---|---|---|
| committer | Juri Linkov | 2004-07-01 11:50:29 +0000 |
| commit | f98a8ffd7f8b2acb2f720763e0609698118e37db (patch) | |
| tree | b99b000930e47c77559bd0af85edf2adc9d60533 | |
| parent | 0ec4febda2d72e79bd90ab25bada4f8b34f4ab54 (diff) | |
| download | emacs-f98a8ffd7f8b2acb2f720763e0609698118e37db.tar.gz emacs-f98a8ffd7f8b2acb2f720763e0609698118e37db.zip | |
(Incremental Search): Add C-M-w, C-M-y, M-%, C-M-%, M-e.
(Regexp Search): Add M-r.
| -rw-r--r-- | man/search.texi | 31 |
1 files changed, 24 insertions, 7 deletions
diff --git a/man/search.texi b/man/search.texi index 43d6af70cf5..f07976f9aa2 100644 --- a/man/search.texi +++ b/man/search.texi | |||
| @@ -78,7 +78,7 @@ would exit the search and then move to the beginning of the line. | |||
| 78 | @key{RET} is necessary only if the next command you want to type is a | 78 | @key{RET} is necessary only if the next command you want to type is a |
| 79 | printing character, @key{DEL}, @key{RET}, or another character that is | 79 | printing character, @key{DEL}, @key{RET}, or another character that is |
| 80 | special within searches (@kbd{C-q}, @kbd{C-w}, @kbd{C-r}, @kbd{C-s}, | 80 | special within searches (@kbd{C-q}, @kbd{C-w}, @kbd{C-r}, @kbd{C-s}, |
| 81 | @kbd{C-y}, @kbd{M-y}, @kbd{M-r}, @kbd{M-s}, and some other | 81 | @kbd{C-y}, @kbd{M-y}, @kbd{M-r}, @kbd{M-c}, @kbd{M-e}, and some other |
| 82 | meta-characters). | 82 | meta-characters). |
| 83 | 83 | ||
| 84 | Sometimes you search for @samp{FOO} and find one, but not the one you | 84 | Sometimes you search for @samp{FOO} and find one, but not the one you |
| @@ -95,7 +95,9 @@ incremental search, and the second @kbd{C-s} means ``search again.'' | |||
| 95 | To reuse earlier search strings, use the @dfn{search ring}. The | 95 | To reuse earlier search strings, use the @dfn{search ring}. The |
| 96 | commands @kbd{M-p} and @kbd{M-n} move through the ring to pick a search | 96 | commands @kbd{M-p} and @kbd{M-n} move through the ring to pick a search |
| 97 | string to reuse. These commands leave the selected search ring element | 97 | string to reuse. These commands leave the selected search ring element |
| 98 | in the minibuffer, where you can edit it. Type @kbd{C-s} or @kbd{C-r} | 98 | in the minibuffer, where you can edit it. To edit the current search |
| 99 | string in the minibuffer without replacing it with items from the | ||
| 100 | search ring, type @kbd{M-e}. Type @kbd{C-s} or @kbd{C-r} | ||
| 99 | to terminate editing the string and search for it. | 101 | to terminate editing the string and search for it. |
| 100 | 102 | ||
| 101 | If your string is not found at all, the echo area says @samp{Failing | 103 | If your string is not found at all, the echo area says @samp{Failing |
| @@ -181,7 +183,7 @@ a key runs a command (@code{isearch-backward}) to search backward. A | |||
| 181 | backward search finds matches that are entirely before the starting | 183 | backward search finds matches that are entirely before the starting |
| 182 | point, just as a forward search finds matches that begin after it. | 184 | point, just as a forward search finds matches that begin after it. |
| 183 | 185 | ||
| 184 | The characters @kbd{C-y} and @kbd{C-w} can be used in incremental | 186 | The characters @kbd{C-w} and @kbd{C-y} can be used in incremental |
| 185 | search to grab text from the buffer into the search string. This | 187 | search to grab text from the buffer into the search string. This |
| 186 | makes it convenient to search for another occurrence of text at point. | 188 | makes it convenient to search for another occurrence of text at point. |
| 187 | @kbd{C-w} copies the character or word after point as part of the | 189 | @kbd{C-w} copies the character or word after point as part of the |
| @@ -195,6 +197,14 @@ current line into the search string. Both @kbd{C-y} and @kbd{C-w} | |||
| 195 | convert the text they copy to lower case if the search is currently | 197 | convert the text they copy to lower case if the search is currently |
| 196 | not case-sensitive; this is so the search remains case-insensitive. | 198 | not case-sensitive; this is so the search remains case-insensitive. |
| 197 | 199 | ||
| 200 | @kbd{C-M-w} and @kbd{C-M-y} modify the search string by only one | ||
| 201 | character at a time: @kbd{C-M-w} deletes the last character from the | ||
| 202 | search string and @kbd{C-M-y} copies the character after point to the | ||
| 203 | end of the search string. An alternative method to add the character | ||
| 204 | after point into the search string is to enter the minibuffer by | ||
| 205 | @kbd{M-e} and to type @kbd{C-f} at the end of the search string in the | ||
| 206 | minibuffer. | ||
| 207 | |||
| 198 | The character @kbd{M-y} copies text from the kill ring into the search | 208 | The character @kbd{M-y} copies text from the kill ring into the search |
| 199 | string. It uses the same text that @kbd{C-y} as a command would yank. | 209 | string. It uses the same text that @kbd{C-y} as a command would yank. |
| 200 | @kbd{Mouse-2} in the echo area does the same. | 210 | @kbd{Mouse-2} in the echo area does the same. |
| @@ -205,6 +215,11 @@ string. It uses the same text that @kbd{C-y} as a command would yank. | |||
| 205 | there. In Transient Mark mode, incremental search sets the mark without | 215 | there. In Transient Mark mode, incremental search sets the mark without |
| 206 | activating it, and does so only if the mark is not already active. | 216 | activating it, and does so only if the mark is not already active. |
| 207 | 217 | ||
| 218 | @kbd{M-%} or @kbd{C-M-%} exits the incremental search and starts an | ||
| 219 | interactive command @code{query-replace} or @code{query-replace-regexp} | ||
| 220 | with the last search string inserted in the minibuffer as initial input | ||
| 221 | for the string to replace. | ||
| 222 | |||
| 208 | @cindex lazy search highlighting | 223 | @cindex lazy search highlighting |
| 209 | @vindex isearch-lazy-highlight | 224 | @vindex isearch-lazy-highlight |
| 210 | When you pause for a little while during incremental search, it | 225 | When you pause for a little while during incremental search, it |
| @@ -371,14 +386,16 @@ nonincremental ways to search for a match for a regexp. | |||
| 371 | @kindex C-M-r | 386 | @kindex C-M-r |
| 372 | @findex isearch-backward-regexp | 387 | @findex isearch-backward-regexp |
| 373 | Incremental search for a regexp is done by typing @kbd{C-M-s} | 388 | Incremental search for a regexp is done by typing @kbd{C-M-s} |
| 374 | (@code{isearch-forward-regexp}), or by invoking @kbd{C-s} with a | 389 | (@code{isearch-forward-regexp}), by invoking @kbd{C-s} with a |
| 375 | prefix argument (whose value does not matter). This command reads a | 390 | prefix argument (whose value does not matter), or by typing @kbd{M-r} |
| 391 | within a forward incremental search. This command reads a | ||
| 376 | search string incrementally just like @kbd{C-s}, but it treats the | 392 | search string incrementally just like @kbd{C-s}, but it treats the |
| 377 | search string as a regexp rather than looking for an exact match | 393 | search string as a regexp rather than looking for an exact match |
| 378 | against the text in the buffer. Each time you add text to the search | 394 | against the text in the buffer. Each time you add text to the search |
| 379 | string, you make the regexp longer, and the new regexp is searched | 395 | string, you make the regexp longer, and the new regexp is searched |
| 380 | for. To search backward for a regexp, use @kbd{C-M-r} | 396 | for. To search backward for a regexp, use @kbd{C-M-r} |
| 381 | (@code{isearch-backward-regexp}), or @kbd{C-r} with a prefix argument. | 397 | (@code{isearch-backward-regexp}), @kbd{C-r} with a prefix argument, |
| 398 | or @kbd{M-r} within a backward incremental search. | ||
| 382 | 399 | ||
| 383 | All of the control characters that do special things within an | 400 | All of the control characters that do special things within an |
| 384 | ordinary incremental search have the same function in incremental regexp | 401 | ordinary incremental search have the same function in incremental regexp |
| @@ -925,7 +942,7 @@ scrolling will be overriden and nullified by the display code. | |||
| 925 | 942 | ||
| 926 | Global search-and-replace operations are not needed often in Emacs, | 943 | Global search-and-replace operations are not needed often in Emacs, |
| 927 | but they are available. In addition to the simple @kbd{M-x | 944 | but they are available. In addition to the simple @kbd{M-x |
| 928 | replace-string} command which is like that found in most editors, | 945 | replace-string} command which replaces all occurrences, |
| 929 | there is a @kbd{M-x query-replace} command which finds each occurrence | 946 | there is a @kbd{M-x query-replace} command which finds each occurrence |
| 930 | of the pattern and asks you whether to replace it. | 947 | of the pattern and asks you whether to replace it. |
| 931 | 948 | ||