[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs-25 8f2a5a8: Improve and update documentation of sear
|
From: |
Eli Zaretskii |
|
Subject: |
[Emacs-diffs] emacs-25 8f2a5a8: Improve and update documentation of search commands |
|
Date: |
Wed, 25 Nov 2015 19:11:17 +0000 |
branch: emacs-25
commit 8f2a5a8aa487036006b7590c896cde30157ca7e0
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>
Improve and update documentation of search commands
* doc/emacs/search.texi (Lax Search): Renamed from "Search Case";
all references changed. Move the description of lax-whitespace
here. Add description of the new character folding features and
additional customizable options.
(Isearch Yank): Move before "Error in Search".
(Basic Isearch): Improve wording. Add index entries. Add short
description of how to abandon search, making this subsection a
complete introduction to search basics.
(Repeat Isearch): Add index entries. Describe additional
customizable options. Describe mouse clicks.
(Isearch Yank): Add index entries. Describe mouse-2 click in echo
area. Describe more customizable options.
(Error in Isearch): Add index entries.
(Special Isearch): Move actual description of some isearch
commands to other sections, leaving here just the summary of the
commands. Add command that toggles character folding. Describe
commands, like "C-h C-h", that were previously omitted for some
reason.
(Not Exiting Isearch): Describe search-exit-option. Add index
entries.
(Word Search): Describe eww-search-word and eww-search-prefix.
(Symbol Search): Add index entries.
(Regexp Search): Describe regexp-search-ring-max.
(Replacement and Lax Matches): Renamed from "Replacement and
Case"; all references changed. Describe lax-whitespace matching
in replace commands and related options. Describe character
folding in replace commands and related options.
(Query Replace): Describe query-replace-from-to-separator and the
new history features. Add index entries for highlighted text.
Describe query-replace-skip-read-only. Describe more keys
accepted by query-replace.
(Other Repeating Search): More index entries for Occur. Describe
list-matching-lines-default-context-lines.
(Search Customizations): New section, documents customizable
options that were not documented until now.
* doc/emacs/glossary.texi (Glossary): Add "Case Folding" and
"Character Folding".
* etc/NEWS: Move search- and replace-related entries to a single
parent section.
* lisp/replace.el (query-replace-show-replacement): Doc fix.
* lisp/isearch.el (search-nonincremental-instead)
(isearch-hide-immediately): Doc fixes.
---
doc/emacs/abbrevs.texi | 4 +-
doc/emacs/emacs.texi | 11 +-
doc/emacs/glossary.texi | 11 +
doc/emacs/maintaining.texi | 2 +-
doc/emacs/mini.texi | 4 +-
doc/emacs/search.texi | 738 +++++++++++++++++++++++++++++++-------------
etc/NEWS | 53 ++--
lisp/isearch.el | 12 +-
lisp/replace.el | 3 +-
9 files changed, 595 insertions(+), 243 deletions(-)
diff --git a/doc/emacs/abbrevs.texi b/doc/emacs/abbrevs.texi
index 23d7e28..695ffa8 100644
--- a/doc/emacs/abbrevs.texi
+++ b/doc/emacs/abbrevs.texi
@@ -407,7 +407,7 @@ you are expanding.
in this search; if it is @code{nil}, the word and the expansion must
match in case. If the value is @code{case-fold-search} (the default),
then the variable @code{case-fold-search} controls whether to ignore
-case while searching for expansions (@pxref{Search Case}).
+case while searching for expansions (@pxref{Lax Search}).
@vindex dabbrev-case-replace
Normally, dynamic abbrev expansion preserves the case pattern
@@ -421,7 +421,7 @@ the dynamic abbrev's case pattern is preserved in most
cases; if it is
@code{nil}, the expansion is always copied verbatim. If the value is
@code{case-replace} (the default), then the variable
@code{case-replace} controls whether to copy the expansion verbatim
-(@pxref{Replacement and Case}).
+(@pxref{Replacement and Lax Matches}).
However, if the expansion contains a complex mixed case pattern, and
the dynamic abbrev matches this pattern as far as it goes, then the
diff --git a/doc/emacs/emacs.texi b/doc/emacs/emacs.texi
index 27bb77d..2877be9 100644
--- a/doc/emacs/emacs.texi
+++ b/doc/emacs/emacs.texi
@@ -392,18 +392,20 @@ Searching and Replacement
* Regexps:: Syntax of regular expressions.
* Regexp Backslash:: Regular expression constructs starting with `\'.
* Regexp Example:: A complex regular expression explained.
-* Search Case:: To ignore case while searching, or not.
+* Lax Search:: Search ignores some distinctions between
+ similar characters, like letter-case.
* Replace:: Search, and replace some or all matches.
* Other Repeating Search:: Operating on all matches for some regexp.
+* Search Customizations:: Various search customizations.
Incremental Search
* Basic Isearch:: Basic incremental search commands.
* Repeat Isearch:: Searching for the same string again.
-* Error in Isearch:: When your string is not found.
-* Special Isearch:: Special input in incremental search.
* Isearch Yank:: Commands that grab text into the search string
or else edit the search string.
+* Error in Isearch:: When your string is not found.
+* Special Isearch:: Special input in incremental search.
* Not Exiting Isearch:: Prefix argument and scrolling commands.
* Isearch Minibuffer:: Incremental search of the minibuffer history.
@@ -411,7 +413,8 @@ Replacement Commands
* Unconditional Replace:: Replacing all matches for a string.
* Regexp Replace:: Replacing all matches for a regexp.
-* Replacement and Case:: How replacements preserve case of letters.
+* Replacement and Lax Matches::
+ Lax searching for text to replace.
* Query Replace:: How to use querying.
Commands for Fixing Typos
diff --git a/doc/emacs/glossary.texi b/doc/emacs/glossary.texi
index e66cd79..cc81101 100644
--- a/doc/emacs/glossary.texi
+++ b/doc/emacs/glossary.texi
@@ -175,11 +175,22 @@ corresponding Control character. @xref{User Input,C-M-}.
Case conversion means changing text from upper case to lower case or
vice versa. @xref{Case}.
address@hidden Case Folding
+Case folding means ignoring the differences between case variants of
+the same letter: upper-case, lower-case, and title-case. Emacs
+performs case folding by default in text search. @xref{Lax Search}.
+
@item Character
Characters form the contents of an Emacs buffer. Also, key sequences
(q.v.@:) are usually made up of characters (though they may include
other input events as well). @xref{User Input}.
address@hidden Character Folding
+Character folding means ignoring differences between similarly looking
+characters, such as between @code{a}, and @code{@:a} and @code{@'a}.
+Emacs performs character folding by default in text search. @xref{Lax
+Search}.
+
@item Character Set
Emacs supports a number of character sets, each of which represents a
particular alphabet or script. @xref{International}.
diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi
index a571ea7..f1a59f8 100644
--- a/doc/emacs/maintaining.texi
+++ b/doc/emacs/maintaining.texi
@@ -2285,7 +2285,7 @@ input. @xref{Query Replace}, for more information on
query replace.
You can control the case-sensitivity of tags search commands by
customizing the value of the variable @code{tags-case-fold-search}. The
default is to use the same setting as the value of
address@hidden (@pxref{Search Case}).
address@hidden (@pxref{Lax Search}).
It is possible to get through all the files in the tags table with a
single invocation of @kbd{M-x tags-query-replace}. But often it is
diff --git a/doc/emacs/mini.texi b/doc/emacs/mini.texi
index 2493fda..ed339a9 100644
--- a/doc/emacs/mini.texi
+++ b/doc/emacs/mini.texi
@@ -642,8 +642,8 @@ expressions. A numeric prefix argument @var{n} means to
fetch the
@var{n}th matching entry. These commands are unusual, in that they
use the minibuffer to read the regular expression argument, even
though they are invoked from the minibuffer. An upper-case letter in
-the regular expression makes the search case-sensitive (@pxref{Search
-Case}).
+the regular expression makes the search case-sensitive (@pxref{Lax
+Search}).
You can also search through the history using an incremental search.
@xref{Isearch Minibuffer}.
diff --git a/doc/emacs/search.texi b/doc/emacs/search.texi
index ae275d1..9da9226 100644
--- a/doc/emacs/search.texi
+++ b/doc/emacs/search.texi
@@ -26,9 +26,11 @@ thing, but search for patterns instead of fixed strings.
* Regexps:: Syntax of regular expressions.
* Regexp Backslash:: Regular expression constructs starting with `\'.
* Regexp Example:: A complex regular expression explained.
-* Search Case:: To ignore case while searching, or not.
+* Lax Search:: Search ignores some distinctions between
+ similar characters, like letter-case.
* Replace:: Search, and replace some or all matches.
* Other Repeating Search:: Operating on all matches for some regexp.
+* Search Customizations:: Various search customizations.
@end menu
@node Incremental Search
@@ -54,10 +56,10 @@ Incremental search backward (@code{isearch-backward}).
@menu
* Basic Isearch:: Basic incremental search commands.
* Repeat Isearch:: Searching for the same string again.
-* Error in Isearch:: When your string is not found.
-* Special Isearch:: Special input in incremental search.
* Isearch Yank:: Commands that grab text into the search string
or else edit the search string.
+* Error in Isearch:: When your string is not found.
+* Special Isearch:: Special input in incremental search.
* Not Exiting Isearch:: Prefix argument and scrolling commands.
* Isearch Minibuffer:: Incremental search of the minibuffer history.
@end menu
@@ -89,31 +91,46 @@ cursor moves to just after the first @samp{FOO}.
@cindex isearch face
At each step, Emacs highlights the @dfn{current match}---the buffer
text that matches the search string---using the @code{isearch} face
-(@pxref{Faces}). The current search string is also displayed in the
-echo area.
+(@pxref{Faces}). @xref{Search Customizations}, for various options
+that customize this highlighting. The current search string is also
+displayed in the echo area.
If you make a mistake typing the search string, type @key{DEL}.
Each @key{DEL} cancels the last character of the search string.
address@hidden in Isearch}, for more about dealing with unsuccessful
+search.
address@hidden exit incremental search
address@hidden incremental search, exiting
When you are satisfied with the place you have reached, type
@key{RET}. This stops searching, leaving the cursor where the search
brought it. Also, any command not specially meaningful in searches
stops the searching and is then executed. Thus, typing @kbd{C-a}
-exits the search and then moves to the beginning of the line.
address@hidden is necessary only if the next command you want to type is a
-printing character, @key{DEL}, @key{RET}, or another character that is
-special within searches (@kbd{C-q}, @kbd{C-w}, @kbd{C-r}, @kbd{C-s},
address@hidden, @kbd{M-y}, @kbd{M-r}, @kbd{M-c}, @kbd{M-e}, and some others
-described below).
+exits the search and then moves to the beginning of the line; typing
+one of the arrow keys exits the search and performs the respective
+movement command; etc. @key{RET} is necessary only if the next
+command you want to type is a printing character, @key{DEL},
address@hidden, or another character that is special within searches
+(@kbd{C-q}, @kbd{C-w}, @kbd{C-r}, @kbd{C-s}, @kbd{C-y}, @kbd{M-y},
address@hidden, @kbd{M-c}, @kbd{M-e}, and some others described below).
+You can fine-tune the commands that exit the search; see @ref{Not
+Exiting Isearch}.
As a special exception, entering @key{RET} when the search string is
empty launches nonincremental search (@pxref{Nonincremental Search}).
+(This can be customized; see @ref{Search Customizations}.)
+
+ To abandon the search and return to the place where you started,
+type @address@hidden @key{ESC} @key{ESC}} (@code{isearch-cancel}) or
address@hidden C-g} (@code{isearch-abort}).
When you exit the incremental search, it adds the original value of
point to the mark ring, without activating the mark; you can thus use
address@hidden address@hidden to return to where you were before beginning the
-search. @xref{Mark Ring}. It only does this if the mark was not
-already active.
address@hidden address@hidden or @kbd{C-x C-x} to return to where you were
+before beginning the search. @xref{Mark Ring}. (Emacs only does this
+if the mark was not already active; if the mark was active when you
+started the search, both @kbd{C-u address@hidden and @kbd{C-x C-x} will
+go to the mark.)
@kindex C-r
@findex isearch-backward
@@ -134,7 +151,6 @@ characters with @key{DEL}. Similarly, each @kbd{C-r} in a
backward
incremental search repeats the backward search.
@cindex lazy search highlighting
address@hidden isearch-lazy-highlight
If you pause for a little while during incremental search, Emacs
highlights all the other possible matches for the search string that
are present on the screen. This helps you anticipate where you can
@@ -142,21 +158,26 @@ get to by typing @kbd{C-s} or @kbd{C-r} to repeat the
search. The
other matches are highlighted differently from the current match,
using the customizable face @code{lazy-highlight} (@pxref{Faces}). If
you don't like this feature, you can disable it by setting
address@hidden to @code{nil}.
address@hidden to @code{nil}. For other customizations
+related to highlighting matches, see @ref{Search Customizations}.
After exiting a search, you can search for the same string again by
typing just @kbd{C-s C-s}. The first @kbd{C-s} is the key that
invokes incremental search, and the second @kbd{C-s} means to search
-again. Similarly, @kbd{C-r C-r} searches backward for the last
-search string. In determining the last search string, it doesn't
-matter whether the string was searched for with @kbd{C-s} or
address@hidden
+again for the last search string. Similarly, @kbd{C-r C-r} searches
+backward for the last search string. In determining the last search
+string, it doesn't matter whether that string was searched for with
address@hidden or @kbd{C-r}.
If you are searching forward but you realize you were looking for
something before the starting point, type @kbd{C-r} to switch to a
backward search, leaving the search string unchanged. Similarly,
@kbd{C-s} in a backward search switches to a forward search.
address@hidden search, wrapping around
address@hidden search, overwrapped
address@hidden wrapped search
address@hidden overwrapped search
If a search is failing and you ask to repeat it by typing another
@kbd{C-s}, it starts again from the beginning of the buffer.
Repeating a failing reverse search with @kbd{C-r} starts again from
@@ -169,19 +190,86 @@ you have already seen.
@cindex search ring
@kindex M-n @r{(Incremental search)}
@kindex M-p @r{(Incremental search)}
address@hidden search-ring-max
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
search string to reuse. These commands leave the selected search ring
-element in the minibuffer, where you can edit it.
-
+element in the minibuffer, where you can edit it. Type
address@hidden/@kbd{C-r} or @key{RET} to accept the string and start
+searching for it. The number of most recently used search strings
+saved in the search ring is specified by the variable
address@hidden, 16 by default.
+
address@hidden incremental search, edit search string
address@hidden interactively edit search string
@kindex M-e @r{(Incremental search)}
address@hidden Mouse-1 @r{in the minibuffer (Incremental Search)}
To edit the current search string in the minibuffer without
-replacing it with items from the search ring, type @kbd{M-e}. Type @key{RET},
address@hidden or @kbd{C-r} to finish editing the string and search for it.
+replacing it with items from the search ring, type @kbd{M-e} or click
address@hidden in the minibuffer. Type @key{RET}, @kbd{C-s} or
address@hidden to finish editing the string and search for it. Type
address@hidden or @address@hidden to add to the search string characters
+following point from the buffer from which you started the search.
+
address@hidden Isearch Yank
address@hidden Isearch Yanking
+
+ In many cases, you will want to use text at or near point as your
+search string. The commands described in this subsection let you do
+that conveniently.
+
address@hidden C-w @r{(Incremental search)}
address@hidden isearch-yank-word-or-char
+ @kbd{C-w} (@code{isearch-yank-word-or-char}) appends the next
+character or word at point to the search string. This is an easy way
+to search for another occurrence of the text at point. (The decision
+of whether to copy a character or a word is heuristic.)
+
address@hidden M-s C-e @r{(Incremental search)}
address@hidden isearch-yank-line
+ Similarly, @kbd{M-s C-e} (@code{isearch-yank-line}) appends the rest
+of the current line to the search string. If point is already at the
+end of a line, it appends the next line. With a prefix argument
address@hidden, it appends the next @var{n} lines.
+
address@hidden C-y @r{(Incremental search)}
address@hidden M-y @r{(Incremental search)}
address@hidden Mouse-2 @r{in the minibuffer (Incremental search)}
address@hidden isearch-yank-kill
address@hidden isearch-yank-pop
address@hidden isearch-yank-x-selection
+ Within incremental search, @kbd{C-y} (@code{isearch-yank-kill})
+appends the current kill to the search string. @kbd{M-y}
+(@code{isearch-yank-pop}), if called after @kbd{C-y}, replaces that
+appended text with an earlier kill, similar to the usual @kbd{M-y}
+(@code{yank-pop}) command (@pxref{Yanking}). Clicking @kbd{Mouse-2}
+in the echo area appends the current X selection (@pxref{Primary
+Selection}) to the search string (@code{isearch-yank-x-selection}).
+
address@hidden C-M-w @r{(Incremental search)}
address@hidden C-M-y @r{(Incremental search)}
address@hidden isearch-del-char
address@hidden isearch-yank-char
+ @kbd{C-M-w} (@code{isearch-del-char}) deletes the last character
+from the search string, and @kbd{C-M-y} (@code{isearch-yank-char})
+appends the character after point to the search string. An
+alternative method to add the character after point is to enter the
+minibuffer with @kbd{M-e} (@pxref{Repeat Isearch}) and type @kbd{C-f}
+or @address@hidden at the end of the search string in the
+minibuffer. Each @kbd{C-f} or @address@hidden you type adds another
+character following point to the search string.
+
+ Normally, when the search is case-insensitive, text yanked into the
+search string is converted to lower case, so that the search remains
+case-insensitive (@pxref{Lax Search, case folding}). However, if the
+value of the variable @code{search-upper-case} (@pxref{Lax Search,
+search-upper-case}) is other than @code{not-yanks}, that disables this
+down-casing.
@node Error in Isearch
@subsection Errors in Incremental Search
address@hidden isearch-fail face
If your string is not found at all, the echo area says @samp{Failing
I-Search}, and the cursor moves past the place where Emacs found as
much of your string as it could. Thus, if you search for @samp{FOOT},
@@ -192,12 +280,13 @@ string that failed to match is highlighted using the face
At this point, there are several things you can do. If your string
was mistyped, you can use @key{DEL} to erase some of it and correct
-it. If you like the place you have found, you can type @key{RET} to
-remain there. Or you can type @kbd{C-g}, which removes from the
-search string the characters that could not be found (the @samp{T} in
address@hidden), leaving those that were found (the @samp{FOO} in
address@hidden). A second @kbd{C-g} at that point cancels the search
-entirely, returning point to where it was when the search started.
+it, or you can type @kbd{M-e} and edit it. If you like the place you
+have found, you can type @key{RET} to remain there. Or you can type
address@hidden, which removes from the search string the characters that
+could not be found (the @samp{T} in @samp{FOOT}), leaving those that
+were found (the @samp{FOO} in @samp{FOOT}). A second @kbd{C-g} at
+that point cancels the search entirely, returning point to where it
+was when the search started.
@cindex quitting (in search)
@kindex C-g @r{(Incremental search)}
@@ -216,34 +305,21 @@ search.
@node Special Isearch
@subsection Special Input for Incremental Search
- Some of the characters you type during incremental search have
-special effects.
+ In addition to characters described in the previous subsections,
+some of the other characters you type during incremental search have
+special effects. They are described here.
address@hidden lax space matching
address@hidden M-s SPC @r{(Incremental search)}
address@hidden SPC @r{(Incremental search)}
address@hidden isearch-toggle-lax-whitespace
address@hidden search-whitespace-regexp
- By default, incremental search performs @dfn{lax space matching}:
-each space, or sequence of spaces, matches any sequence of one or more
-spaces in the text. Hence, @samp{foo bar} matches @samp{foo bar},
address@hidden@w{ }bar}, @address@hidden }bar}, and so on (but not
address@hidden). More precisely, Emacs matches each sequence of space
-characters in the search string to a regular expression specified by
-the variable @code{search-whitespace-regexp}. For example, to make
-spaces match sequences of newlines as well as spaces, set it to
address@hidden"[[:space:]\n]+"}.
-
- To toggle lax space matching, type @kbd{M-s @key{SPC}}
-(@code{isearch-toggle-lax-whitespace}). To disable this feature
-entirely, change @code{search-whitespace-regexp} to @code{nil}; then
-each space in the search string matches exactly one space.
-
- If the search string you entered contains only lower-case letters,
-the search is case-insensitive; as long as an upper-case letter exists
-in the search string, the search becomes case-sensitive. If you
-delete the upper-case character from the search string, it ceases to
-have this effect. @xref{Search Case}.
+ To toggle lax space matching (@pxref{Lax Search, lax space
+matching}), type @kbd{M-s @key{SPC}}.
+
+ To toggle case sensitivity of the search, type @kbd{M-c} or
address@hidden c}. @xref{Lax Search, case folding}. If the search string
+includes upper-case letters, the search is case-sensitive by default.
+
+ To toggle whether or not the search will consider similar and
+equivalent characters as a match, type @kbd{M-s '}. @xref{Lax Search,
+character folding}. If the search string includes accented
+characters, that disables character folding during that search.
@cindex invisible text, searching for
@kindex M-s i @r{(Incremental search)}
@@ -251,7 +327,17 @@ have this effect. @xref{Search Case}.
To toggle whether or not invisible text is searched, type
@kbd{M-s i} (@code{isearch-toggle-invisible}). @xref{Outline Search}.
- To search for a newline character, type @kbd{C-j}.
address@hidden M-r @r{(Incremental Search)}
address@hidden M-s r @r{(Incremental Search)}
address@hidden isearch-toggle-regexp
+ To toggle between non-regexp and regexp incremental search, type
address@hidden or @kbd{M-s r} (@code{isearch-toggle-regexp}).
address@hidden Search}.
+
+ To toggle symbol mode, type @kbd{M-s _}. @xref{Symbol Search}.
+
+ To search for a newline character, type @kbd{C-j} as part of the
+search string.
To search for address@hidden characters, use one of the
following methods:
@@ -265,17 +351,21 @@ example, @kbd{C-q C-s} during incremental search adds the
@samp{control-S} character to the search string.
@item
-Type @kbd{C-x 8 @key{RET}}, followed by a Unicode name or code-point.
-This adds the specified character into the search string, similar to
-the usual @code{insert-char} command (@pxref{Inserting Text}).
+Type @kbd{C-x 8 @key{RET}}, followed by 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
address@hidden C-^ @r{(Incremental Search)}
address@hidden isearch-toggle-input-method
address@hidden isearch-toggle-specified-input-method
Use an input method (@pxref{Input Methods}). If an input method is
-enabled in the current buffer when you start the search, you can use
-it in the search string also. While typing the search string, you can
-toggle the input method with @kbd{C-\}
-(@code{isearch-toggle-input-method}). You can also turn on a
-non-default input method with @kbd{C-^}
+enabled in the current buffer when you start the search, the same
+method will be active in the minibuffer when you type the search
+string. While typing the search string, you can toggle the input
+method with @kbd{C-\} (@code{isearch-toggle-input-method}). You can
+also turn on a non-default input method with @kbd{C-^}
(@code{isearch-toggle-specified-input-method}), which prompts for the
name of the input method. When an input method is active during
incremental search, the search prompt includes the input method
@@ -286,13 +376,17 @@ I-search address@hidden:
@end example
@noindent
address@hidden isearch-toggle-input-method
address@hidden isearch-toggle-specified-input-method
where @var{im} is the mnemonic of the active input method. Any input
method you enable during incremental search remains enabled in the
current buffer afterwards.
@end itemize
address@hidden M-s o @r{(Incremental Search)}
address@hidden isearch-occur
+ Typing @kbd{M-s o} in incremental search invokes
address@hidden, which runs @code{occur} with the current search
+string. @xref{Other Repeating Search, occur}.
+
@kindex M-% @r{(Incremental search)}
Typing @kbd{M-%} in incremental search invokes @code{query-replace}
or @code{query-replace-regexp} (depending on search mode) with the
@@ -302,83 +396,72 @@ prefix argument means to replace backward. @xref{Query
Replace}.
@kindex M-TAB @r{(Incremental search)}
Typing @address@hidden in incremental search invokes
@code{isearch-complete}, which attempts to complete the search string
-using the search ring as a list of completion alternatives.
address@hidden In many operating systems, the @address@hidden
-key sequence is captured by the window manager; you then need to
-rebind @code{isearch-complete} to another key sequence if you want to
-use it (@pxref{Rebinding}).
-
+using the search ring (the previous search strings you used) as a list
+of completion alternatives. @xref{Completion}. In many operating
+systems, the @address@hidden key sequence is captured by the window
+manager; you then need to rebind @code{isearch-complete} to another
+key sequence if you want to use it (@pxref{Rebinding}).
+
address@hidden M-s h r @r{(Incremental Search)}
address@hidden isearch-highlight-regexp
+ You can exit the search while leaving the matches for the last
+search string highlighted on display. To this end, type @kbd{M-s h r}
+(@code{isearch-highlight-regexp}), which will run
address@hidden (@pxref{Highlight Interactively}) passing
+it the regexp derived from the last search string and prompting you
+for the face to use for highlighting. To remove the highlighting,
+type @kbd{M-s h u} (@code{unhighlight-regexp}).
+
address@hidden incremental search, help on special keys
address@hidden C-h C-h @r{(Incremental Search)}
address@hidden isearch-help-map
@vindex isearch-mode-map
- When incremental search is active, you can type @kbd{C-h C-h} to
-access interactive help options, including a list of special key
-bindings. These key bindings are part of the keymap
address@hidden (@pxref{Keymaps}).
-
address@hidden Isearch Yank
address@hidden Isearch Yanking
-
address@hidden C-y @r{(Incremental search)}
address@hidden M-y @r{(Incremental search)}
address@hidden isearch-yank-kill
address@hidden isearch-yank-pop
- Within incremental search, @kbd{C-y} (@code{isearch-yank-kill})
-appends the current kill to the search string. @kbd{M-y}
-(@code{isearch-yank-pop}), if called after @kbd{C-y}, replaces that
-appended text with an earlier kill, similar to the usual @kbd{M-y}
-(@code{yank-pop}) command (@pxref{Yanking}). @kbd{Mouse-2} appends
-the current X selection (@pxref{Primary Selection}).
-
address@hidden C-w @r{(Incremental search)}
address@hidden isearch-yank-word-or-char
- @kbd{C-w} (@code{isearch-yank-word-or-char}) appends the next
-character or word at point to the search string. This is an easy way
-to search for another occurrence of the text at point. (The decision
-of whether to copy a character or a word is heuristic.)
-
address@hidden M-s C-e @r{(Incremental search)}
address@hidden isearch-yank-line
- Similarly, @kbd{M-s C-e} (@code{isearch-yank-line}) appends the rest
-of the current line to the search string. If point is already at the
-end of a line, it appends the next line. With a prefix argument
address@hidden, it appends the next @var{n} lines.
-
- If the search is currently case-insensitive, both @kbd{C-w} and
address@hidden C-e} convert the text they copy to lower case, so that the
-search remains case-insensitive.
-
address@hidden C-M-w @r{(Incremental search)}
address@hidden C-M-y @r{(Incremental search)}
address@hidden isearch-del-char
address@hidden isearch-yank-char
- @kbd{C-M-w} (@code{isearch-del-char}) deletes the last character
-from the search string, and @kbd{C-M-y} (@code{isearch-yank-char})
-appends the character after point to the search string. An
-alternative method to add the character after point is to enter the
-minibuffer with @kbd{M-e} (@pxref{Repeat Isearch}) and type @kbd{C-f}
-at the end of the search string in the minibuffer.
+ When incremental search is active, you can type @kbd{C-h C-h}
+(@code{isearch-help-map}) to access interactive help options,
+including a list of special key bindings. These key bindings are part
+of the keymap @code{isearch-mode-map} (@pxref{Keymaps}).
@node Not Exiting Isearch
@subsection Not Exiting Incremental Search
-This subsection describes two categories of commands which you can
-type without exiting the current incremental search, even though they
-are not themselves part of incremental search.
+This subsection describes how to control whether typing a command not
+specifically meaningful is searches exits the search before executing
+the command. It also describes two categories of commands which you
+can type without exiting the current incremental search, even though
+they are not themselves part of incremental search.
+
address@hidden search-exit-option
+ Normally, typing a command that is not bound by the incremental
+search exits the search before executing the command. Thus, the
+command operates on the buffer from which you invoked the search.
+However, if you customize the variable @code{search-exit-option} to a
address@hidden value, the characters which you type that are not
+interpreted by the incremental search are simply appended to the
+search string. This is so you could include in the search string
+control characters, such as @kbd{C-a}, that would normally exit the
+search and invoke the command bound to them on the buffer.
@table @asis
@item Prefix Arguments
address@hidden prefix argument commands, during incremental search
@vindex isearch-allow-prefix
- In incremental search, when you enter a prefix argument
-(@pxref{Arguments}), by default it will apply either to the next
-action in the search or to the command that exits the search.
+ In incremental search, when you type a command that specifies a
+prefix argument (@pxref{Arguments}), by default it will apply either
+to the next action in the search or to the command that exits the
+search. In other words, entering a prefix argument will not by itself
+terminate the search.
In previous versions of Emacs, entering a prefix argument always
terminated the search. You can revert to this behavior by setting the
variable @code{isearch-allow-prefix} to @code{nil}.
When @code{isearch-allow-scroll} is address@hidden (see below),
-prefix arguments always have the default behavior described above.
+prefix arguments always have the default behavior described above,
+i.e., they don't terminate the search, even if
address@hidden is @code{nil}.
@item Scrolling Commands
address@hidden scrolling commands, during incremental search
@vindex isearch-allow-scroll
Normally, scrolling commands exit incremental search. If you change
the variable @code{isearch-allow-scroll} to a address@hidden value,
@@ -390,12 +473,14 @@ prefix arguments to these commands in the usual way.
This feature
won't let you scroll the current match out of visibility, however.
The @code{isearch-allow-scroll} feature also affects some other
-commands, such as @kbd{C-x 2} (@code{split-window-below}) and @kbd{C-x
-^} (@code{enlarge-window}), which don't exactly scroll but do affect
-where the text appears on the screen. It applies to any command whose
-name has a address@hidden @code{isearch-scroll} property. So you can
-control which commands are affected by changing these properties.
-
+commands, such as @kbd{C-x 2} (@code{split-window-below}) and
address@hidden ^} (@code{enlarge-window}), which don't exactly scroll but do
+affect where the text appears on the screen. It applies to any
+command whose name has a address@hidden @code{isearch-scroll}
+property. So you can control which commands are affected by changing
+these properties.
+
address@hidden prevent commands from exiting incremental search
For example, to make @kbd{C-h l} usable within an incremental search
in all future Emacs sessions, use @kbd{C-h c} to find what command it
runs (@pxref{Key Help}), which is @code{view-lossage}. Then you can
@@ -409,7 +494,8 @@ put the following line in your init file (@pxref{Init
File}):
This feature can be applied to any command that doesn't permanently
change point, the buffer contents, the match data, the current buffer,
or the selected window and frame. The command must not itself attempt
-an incremental search.
+an incremental search. This feature is disabled if
address@hidden is @code{nil} (which it is by default).
@end table
@node Isearch Minibuffer
@@ -475,11 +561,13 @@ search matches any sequence of those two words separated
by one or
more spaces, newlines, or other punctuation characters. This is
particularly useful for searching text documents, because you don't
have to worry whether the words you are looking for are separated by
-newlines or spaces.
+newlines or spaces. Note that major modes for programming languages
+or other specialized modes can modify the definition of a word to suit
+their syntactic needs.
@table @kbd
@item M-s w
-If incremental search is active, toggle word search mode
+ If incremental search is active, toggle word search mode
(@code{isearch-toggle-word}); otherwise, begin an incremental forward
word search (@code{isearch-forward-word}).
@item M-s w @key{RET} @var{words} @key{RET}
@@ -514,6 +602,14 @@ so that the matching can proceed incrementally as you
type. This
additional laxity does not apply to the lazy highlight
(@pxref{Incremental Search}), which always matches whole words.
address@hidden M-s M-w
address@hidden eww-search-word
address@hidden eww-search-prefix
+ Search the Web for the text in region. This command performs an
+Internet search for the words in region using the search engine whose
address@hidden is specified by the variable @code{eww-search-prefix}.
address@hidden, EWW, , eww, The Emacs Web Wowser Manual}.
+
@node Symbol Search
@section Symbol Search
@cindex symbol search
@@ -529,6 +625,7 @@ searching source code.
@table @kbd
@item M-s _
address@hidden isearch-toggle-symbol
If incremental search is active, toggle symbol search mode
(@code{isearch-toggle-symbol}); otherwise, begin an incremental
forward symbol search (@code{isearch-forward-symbol}).
@@ -595,13 +692,16 @@ for. To search backward for a regexp, use @kbd{C-M-r}
(@code{isearch-backward-regexp}), @kbd{C-r} with a prefix argument,
or @kbd{M-r} within a backward incremental search.
address@hidden regexp-search-ring-max
All of the special key sequences in an ordinary incremental search
-do similar things in an incremental regexp search. For instance,
-typing @kbd{C-s} immediately after starting the search retrieves the
-last incremental search regexp used and searches forward for it.
-Incremental regexp and non-regexp searches have independent defaults.
-They also have separate search rings, which you can access with
address@hidden and @kbd{M-n}.
+(@pxref{Special Isearch}) do similar things in an incremental regexp
+search. For instance, typing @kbd{C-s} immediately after starting the
+search retrieves the last incremental search regexp used and searches
+forward for it. Incremental regexp and non-regexp searches have
+independent defaults. They also have separate search rings, which you
+can access with @kbd{M-p} and @kbd{M-n}. The maximum number of search
+regexps saved in the search ring is determined by the value of
address@hidden, 16 by default.
Unlike ordinary incremental search, incremental regexp search
do not use lax space matching by default. To toggle this feature
@@ -1030,21 +1130,67 @@ This contains two parts in succession: a character set
matching
period, @samp{?}, or @samp{!}, and a character set matching
close-brackets, quotes, or parentheses, repeated zero or more times.
address@hidden Search Case
address@hidden Searching and Case
address@hidden Lax Search
address@hidden Lax Matching During Searching
+
address@hidden lax search
address@hidden character equivalence in search
+ Normally, you'd want search commands to disregard certain minor
+differences between the search string you types and the text being
+searched. For example, sequences of whitespace characters of
+different length are normally perceived as equivalent; letter-case
+differences usually don't matter; etc. This is known as
address@hidden equivalence}.
+
+ This section describes the Emacs lax search features, and how to
+tailor them to your needs.
address@hidden lax space matching in search
address@hidden M-s SPC @r{(Incremental search)}
address@hidden SPC @r{(Incremental search)}
address@hidden isearch-toggle-lax-whitespace
address@hidden search-whitespace-regexp
+ By default, search commands perform @dfn{lax space matching}:
+each space, or sequence of spaces, matches any sequence of one or more
+whitespace characters in the text. (Incremental regexp search has a
+separate default; see @ref{Regexp Search}.) Hence, @samp{foo bar}
+matches @samp{foo bar}, @address@hidden }bar}, @address@hidden }bar}, and so
+on (but not @samp{foobar}). More precisely, Emacs matches each
+sequence of space characters in the search string to a regular
+expression specified by the variable @code{search-whitespace-regexp}.
+For example, to make spaces match sequences of newlines as well as
+spaces, set it to @samp{"[[:space:]\n]+"}. The default value of this
+variable depends on the buffer's major mode; most major modes classify
+spaces, tabs, and formfeed characters as whitespace.
+
+ If you want whitespace characters to match exactly, you can turn lax
+space matching by typing @kbd{M-s @key{SPC}}
+(@code{isearch-toggle-lax-whitespace}) within an incremental search.
+Another @kbd{M-s @key{SPC}} turns lax space matching back on. To
+disable this feature entirely, change @code{search-whitespace-regexp}
+to @code{nil}; then each space in the search string matches exactly
+one space.
+
address@hidden case folding in search
address@hidden case-sensitivity and search
Searches in Emacs normally ignore the case of the text they are
-searching through, if you specify the text in lower case. Thus, if
-you specify searching for @samp{foo}, then @samp{Foo} and @samp{foo}
-also match. Regexps, and in particular character sets, behave
-likewise: @samp{[ab]} matches @samp{a} or @samp{A} or @samp{b} or
address@hidden
-
- An upper-case letter anywhere in the incremental search string makes
-the search case-sensitive. Thus, searching for @samp{Foo} does not find
address@hidden or @samp{FOO}. This applies to regular expression search as
-well as to string search. The effect ceases if you delete the
-upper-case letter from the search string.
+searching through, if you specify the search string in lower case.
+Thus, if you specify searching for @samp{foo}, then @samp{Foo} and
address@hidden also match. Regexps, and in particular character sets,
+behave likewise: @samp{[ab]} matches @samp{a} or @samp{A} or @samp{b}
+or @samp{B}. This feature is known as @dfn{case folding}, and it is
+supported in both incremental and non-incremental search modes.
+
address@hidden search-upper-case
+ An upper-case letter anywhere in the search string makes the search
+case-sensitive. Thus, searching for @samp{Foo} does not find
address@hidden or @samp{FOO}. This applies to regular expression search
+as well as to string search. The effect ceases if you delete the
+upper-case letter from the search string. The variable
address@hidden controls this: if it is address@hidden (the
+default), an upper-case character in the search string make the search
+case-sensitive; setting it to @code{nil} disables this effect of
+upper-case characters.
@vindex case-fold-search
If you set the variable @code{case-fold-search} to @code{nil}, then
@@ -1055,12 +1201,14 @@ This variable applies to nonincremental searches also,
including those
performed by the replace commands (@pxref{Replace}) and the minibuffer
history matching commands (@pxref{Minibuffer History}).
address@hidden isearch-toggle-case-fold
- Typing @kbd{M-c} within an incremental search toggles the case
-sensitivity of that search. The effect does not extend beyond the
-current incremental search to the next one, but it does override the
-effect of adding or removing an upper-case letter in the current
-search.
address@hidden M-c @r{(Incremental search)}
address@hidden M-s c @r{(Incremental search)}
address@hidden isearch-toggle-case-fold
+ Typing @kbd{M-c} or @kbd{M-s c} (@code{isearch-toggle-case-fold})
+within an incremental search toggles the case sensitivity of that
+search. The effect does not extend beyond the current incremental
+search to the next one, but it does override the effect of adding or
+removing an upper-case letter in the current search.
Several related variables control case-sensitivity of searching and
matching for specific commands or activities. For instance,
@@ -1068,6 +1216,46 @@ matching for specific commands or activities. For
instance,
@code{find-tag}. To find these variables, do @kbd{M-x
apropos-variable @key{RET} case-fold-search @key{RET}}.
address@hidden character folding in search
address@hidden equivalent character sequences
+ Case folding disregards case distinctions between characters, making
+upper-case characters match lower-case variants, and vice versa. A
+generalization of case folding is @dfn{character folding}, which
+disregards wider classes of distinctions between similar characters.
+For instance, under character folding the letter @code{a} will match
+all of its accented cousins like @code{@"a} and @code{@'a}, i.e., the
+match disregards the diacriticals that distinguish between these
+variants. In addition, @code{a} will match other characters that
+resemble it, or have it as part of their graphical representation,
+such as @sc{u+249c parenthesized latin small letter a} and @sc{u+2100
+account of} (which looks like a small @code{a} over @code{c}).
+Similarly, the @acronym{ASCII} double-quote character @code{"} will
+match all the other variants of double quotes defined by the Unicode
+standard.
address@hidden @c FIXME: This doesn't work. Should it?
+Finally, character folding can make a sequence of one or
+more characters match another sequence of a different length: for
+example, the sequence of two characters @code{ae} matches the ligature
address@hidden@ae{}}.
address@hidden ignore
+Character sequences that match under character folding are called
address@hidden
+
address@hidden M-s ' @r{(Incremental Search)}
address@hidden isearch-toggle-character-fold
+ Searches in Emacs normally perform character folding, thus matching
+equivalent character sequences. You can disable this behavior by
+customizing the variable @code{search-default-regexp-mode} to the
address@hidden value. @xref{Search Customizations}. Within an
+incremental search, typing @kbd{M-s '}
+(@code{isearch-toggle-character-fold}) toggles character folding, but
+only for that search.
+
+ Like with case folding, typing an explicit variant of a character,
+such as @code{@"a}, as part of the search string disables character
+folding for that search. If you delete such a character from the
+search string, this effect ceases.
+
@node Replace
@section Replacement Commands
@cindex replacement
@@ -1078,7 +1266,8 @@ apropos-variable @key{RET} case-fold-search @key{RET}}.
Emacs provides several commands for performing search-and-replace
operations. In addition to the simple @kbd{M-x replace-string}
command, there is @kbd{M-%} (@code{query-replace}), which presents
-each occurrence of the pattern and asks you whether to replace it.
+each occurrence of the search pattern and asks you whether to replace
+it.
The replace commands normally operate on the text from point to the
end of the buffer. When the region is active, they operate on it
@@ -1087,17 +1276,11 @@ instead (@pxref{Mark}). The basic replace commands
replace one
is possible to perform several replacements in parallel, using the
command @code{expand-region-abbrevs} (@pxref{Expanding Abbrevs}).
address@hidden replace-lax-whitespace
- Unlike incremental search, the replacement commands do not use lax
-space matching (@pxref{Special Isearch}) by default. To enable lax
-space matching for replacement, change the variable
address@hidden to @code{t}. (This only affects how
-Emacs finds the text to replace, not the replacement text.)
-
@menu
* Unconditional Replace:: Replacing all matches for a string.
* Regexp Replace:: Replacing all matches for a regexp.
-* Replacement and Case:: How replacements preserve case of letters.
+* Replacement and Lax Matches::
+ Lax searching for text to replace.
* Query Replace:: How to use querying.
@end menu
@@ -1128,8 +1311,8 @@ activating the mark; use @kbd{C-u address@hidden to move
back there.
A prefix argument restricts replacement to matches that are
surrounded by word boundaries.
- @xref{Replacement and Case}, for details about case-sensitivity in
-replace commands.
+ @xref{Replacement and Lax Matches}, for details about
+case-sensitivity in replace commands.
@node Regexp Replace
@subsection Regexp Replacement
@@ -1137,7 +1320,7 @@ replace commands.
The @kbd{M-x replace-string} command replaces exact matches for a
single string. The similar command @kbd{M-x replace-regexp} replaces
-any match for a specified pattern.
+any match for a specified regular expression pattern (@pxref{Regexps}).
@table @kbd
@item M-x replace-regexp @key{RET} @var{regexp} @key{RET} @var{newstring}
@key{RET}
@@ -1218,9 +1401,28 @@ M-x replace-regexp @key{RET}
address@hidden,address@hidden @key{RET}
\,(format "%-72sABC%05d" \& \#) @key{RET}
@end example
address@hidden Replacement and Case
address@hidden Replace Commands and Case
address@hidden Replacement and Lax Matches
address@hidden Replace Commands and Lax Matches
+
+ This subsection describes the behavior of replace commands with
+respect to lax matches (@pxref{Lax Search}) and how to customize it.
+In general, replace commands mostly default to stricter matching than
+their search counterparts.
address@hidden lax space matching in replace commands
address@hidden replace-lax-whitespace
+ Unlike incremental search, the replacement commands do not use lax
+space matching (@pxref{Lax Search, lax space matching}) by default.
+To enable lax space matching for replacement, change the variable
address@hidden to address@hidden (This only affects
+how Emacs finds the text to replace, not the replacement text.)
+
address@hidden replace-regexp-lax-whitespace
+ A companion variable @code{replace-regexp-lax-whitespace} controls
+whether @code{query-replace-regexp} uses lax whitespace matching when
+searching for patterns.
+
address@hidden case folding in replace commands
If the first argument of a replace command is all lower case, the
command ignores case while searching for occurrences to
replace---provided @code{case-fold-search} is address@hidden If
@@ -1250,6 +1452,14 @@ exactly as given, with no case conversion. Likewise, if
either
@code{case-replace} or @code{case-fold-search} is set to @code{nil},
replacement is done without case conversion.
address@hidden character folding in replace commands
+ The replacement commands by default do not use character folding
+(@pxref{Lax Search, character folding}) when looking for the text to
+replace. To enable character folding for matching, set the variable
address@hidden to a address@hidden value. (This
+setting does not affect the replacement text, only how Emacs finds the
+text to replace.)
+
@node Query Replace
@subsection Query Replace
@cindex query replace
@@ -1270,9 +1480,9 @@ occurrence and asks you whether to replace it. Aside
from querying,
@code{query-replace} works just like @code{replace-string}
(@pxref{Unconditional Replace}). In particular, it preserves case
provided @code{case-replace} is address@hidden, as it normally is
-(@pxref{Replacement and Case}). A numeric argument means to consider
-only occurrences that are bounded by word-delimiter characters. A
-negative prefix argument replaces backward.
+(@pxref{Replacement and Lax Matches}). A numeric argument means to
+consider only occurrences that are bounded by word-delimiter
+characters. A negative prefix argument replaces backward.
@kindex C-M-%
@findex query-replace-regexp
@@ -1280,18 +1490,38 @@ negative prefix argument replaces backward.
It works like @code{replace-regexp} except that it queries
like @code{query-replace}.
address@hidden query-replace-from-to-separator
+ You can reuse earlier replacements with these commands. When
address@hidden or @code{query-replace-regexp} prompts for the
+search string, use @kbd{M-p} and @kbd{M-n} to show previous
+replacements in the form @address@hidden -> @var{to}}, where
address@hidden is the search pattern, @var{to} is its replacement, and the
+separator between them is determined by the value of the variable
address@hidden Type @key{RET} to select the
+desired replacement.
+
@cindex faces for highlighting query replace
@cindex query-replace face
address@hidden lazy-highlight face
address@hidden lazy-highlight face, in replace
address@hidden query-replace-highlight
address@hidden query-replace-lazy-highlight
address@hidden query-replace-show-replacement
These commands highlight the current match using the face
address@hidden They highlight other matches using
address@hidden just like incremental search (@pxref{Incremental
-Search}). By default, @code{query-replace-regexp} will show the
-substituted replacement string for the current match in the
-minibuffer. If you want to keep special sequences @samp{\&} and
address@hidden@var{n}} unexpanded, customize
address@hidden You can disable this highlight by setting the
+variable @code{query-replace-highlight} to @code{nil}. They highlight
+other matches using @code{lazy-highlight} just like incremental search
+(@pxref{Incremental Search}); this can be disabled by setting
address@hidden to @code{nil}. By default,
address@hidden will show the substituted replacement
+string for the current match in the minibuffer. If you want to keep
+special sequences @samp{\&} and @address@hidden unexpanded, customize
@code{query-replace-show-replacement} variable.
address@hidden query-replace-skip-read-only
+ The variable @code{query-replace-skip-read-only}, if set
address@hidden, will cause replacement commands to ignore matches in
+read-only text. The default is not to ignore them.
+
The characters you can type when you are shown a match for the string
or regexp are:
@@ -1311,9 +1541,13 @@ or regexp are:
@c WideCommands
@table @kbd
@item @key{SPC}
address@hidden y
to replace the occurrence with @var{newstring}.
@item @key{DEL}
address@hidden @key{Delete}
address@hidden @key{BACKSPACE}
address@hidden n
to skip to the next occurrence without replacing this one.
@item , @r{(Comma)}
@@ -1329,6 +1563,7 @@ must use @kbd{C-x @key{ESC} @key{ESC} @key{RET}} to
restart
(@pxref{Repetition}).
@item @key{RET}
address@hidden q
to exit without doing any more replacements.
@item .@: @r{(Period)}
@@ -1338,19 +1573,6 @@ occurrences.
@item !
to replace all remaining occurrences without asking again.
address@hidden Y @r{(Upper-case)}
-to replace all remaining occurrences in all remaining buffers in
-multi-buffer replacements (like the Dired @key{Q} command that performs
-query replace on selected files). It answers this question and all
-subsequent questions in the series with ``yes'', without further
-user interaction.
-
address@hidden N @r{(Upper-case)}
-to skip to the next buffer in multi-buffer replacements without
-replacing remaining occurrences in the current buffer. It answers
-this question ``no'', gives up on the questions for the current buffer,
-and continues to the next buffer in the sequence.
-
@item ^
to go back to the position of the previous occurrence (or what used to
be an occurrence), in case you changed it by mistake or want to
@@ -1378,19 +1600,30 @@ replacement string for any further occurrences.
to redisplay the screen. Then you must type another character to
specify what to do with this occurrence.
address@hidden Y @r{(Upper-case)}
+to replace all remaining occurrences in all remaining buffers in
+multi-buffer replacements (like the Dired @key{Q} command that performs
+query replace on selected files). It answers this question and all
+subsequent questions in the series with ``yes'', without further
+user interaction.
+
address@hidden N @r{(Upper-case)}
+to skip to the next buffer in multi-buffer replacements without
+replacing remaining occurrences in the current buffer. It answers
+this question ``no'', gives up on the questions for the current buffer,
+and continues to the next buffer in the sequence.
+
@item C-h
address@hidden ?
address@hidden @key{F1}
to display a message summarizing these options. Then you must type
another character to specify what to do with this occurrence.
@end table
- Some other characters are aliases for the ones listed above: @kbd{y},
address@hidden and @kbd{q} are equivalent to @key{SPC}, @key{DEL} and
address@hidden
-
Aside from this, any other character exits the @code{query-replace},
and is then reread as part of a key sequence. Thus, if you type
@kbd{C-k}, it exits the @code{query-replace} and then kills to end of
-line.
+line. In particular, @kbd{C-g} simply exits the @code{query-replace}.
To restart a @code{query-replace} once it is exited, use @kbd{C-x
@key{ESC} @key{ESC}}, which repeats the @code{query-replace} because it
@@ -1454,12 +1687,17 @@ a multi-file incremental search is activated
automatically.
@cindex Occur mode
@cindex mode, Occur
address@hidden match (face name)
address@hidden list-matching-lines-default-context-lines
@item M-x occur
Prompt for a regexp, and display a list showing each line in the
-buffer that contains a match for it. To limit the search to part of
-the buffer, narrow to that part (@pxref{Narrowing}). A numeric
+buffer that contains a match for it. The text that matched is
+highlighted using the @code{match} face. To limit the search to part
+of the buffer, narrow to that part (@pxref{Narrowing}). A numeric
argument @var{n} specifies that @var{n} lines of context are to be
-displayed before and after each matching line.
+displayed before and after each matching line. The default number of
+context lines is specified by the variable
address@hidden
@kindex RET @r{(Occur mode)}
@kindex o @r{(Occur mode)}
@@ -1526,3 +1764,89 @@ it never deletes lines that are only partially contained
in the region
If a match is split across lines, this command keeps all those lines.
@end table
+
address@hidden Search Customizations
address@hidden Tailoring Search to Your Needs
address@hidden search customizations
+
+ This section describes miscellaneous search-related customizations
+not described elsewhere.
+
address@hidden default search mode
address@hidden search mode, default
+ The default search mode for the incremental search is specified by
+the variable @code{search-default-regexp-mode}. It can be @code{nil},
address@hidden, or a function. If it is @code{nil}, the default mode is to
+do literal searches without character folding, but with case folding
+and lax-whitespace matches as determined by @code{case-fold-search}
+and @code{search-whitespace-regexp}, respectively (@pxref{Lax
+Search}). If the value is @code{t}, incremental search defaults to
+regexp searches. The default value specifies a function that causes
+the default search mode to perform character folding in addition to
+case folding and lax-whitespace matching.
+
address@hidden search-highlight
+ The current match of an on-going incremental search is highlighted
+using the @code{isearch} face. This highlighting can be disabled by
+setting the variable @code{search-highlight} to a @code{nil} value.
+
address@hidden lazy highlighting customizations
address@hidden isearch-lazy-highlight
address@hidden lazy-highlight face
+ The other matches for the search string that are visible on display
+are highlighted using the @code{lazy-highlight} face. Setting the
+variable @code{isearch-lazy-highlight} to a @code{nil} value disables
+this highlighting. Here are some other variables that customize the
+lazy highlighting:
+
address@hidden @code
address@hidden lazy-highlight-initial-delay
+Time in seconds to wait before highlighting visible matches.
+
address@hidden lazy-highlight-interval
+Time in seconds between highlighting successive matches.
+
address@hidden lazy-highlight-max-at-a-time
+The maximum number of matches to highlight before checking for input.
+A large number can take some time to highlight, so if you want to
+continue searching and type @kbd{C-s} or @kbd{C-r} during that time,
+Emacs will not respond until it finishes highlighting all those
+matches. Thus, smaller values make Emacs more responsive.
address@hidden table
+
address@hidden search-nonincremental-instead
+ Normally, entering @key{RET} within incremental search when the
+search string is empty launches a nonincremental search. (Actually,
+it lets you edit the search string, and the next @key{RET} does the
+search.) However, if you customize the variable
address@hidden to a @code{nil} value, typing
address@hidden will always exit the incremental search, even if the search
+string is empty.
+
address@hidden isearch-hide-immediately
+ By default, incremental search and query-replace commands match
+invisible text, but hide any such matches as soon as the current match
+moves off the invisible text. If you customize the variable
address@hidden to a @code{nil} value, any invisible
+text where matches were found stays on display until the search or the
+replace command exits.
+
address@hidden search display on slow terminals
address@hidden search-slow-speed
address@hidden search-slow-window-lines
+ Searching incrementally on slow terminals, such as displays
+connected to remote machines over slow connection, could be annoying
+due to the need to redraw large portions of the display as the search
+proceeds. Emacs provides a special display mode for slow terminals,
+whereby search pops up a separate small window and displays the text
+surrounding the match in that window. Small windows display faster,
+so the annoying effect of slow speed is alleviated. The variable
address@hidden determines the baud rate threshold below
+which Emacs will use this display mode. The variable
address@hidden controls the number of lines in the
+window Emacs pops up for displaying the search results; the default is
+1 line. Normally, this window will pop up at the bottom of the window
+that displays the buffer where you start searching, bit if the value
+of @code{search-slow-window-lines} is negative, that means to put the
+window at the top and give it the number of lines that is the absolute
+value of that value.
diff --git a/etc/NEWS b/etc/NEWS
index 1a381ec..daa5003 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -135,25 +135,6 @@ frames.
Works for functions, variables, faces, etc. It is bound to `C-h o' by
default.
-** New user option `search-default-regexp-mode'
-specifies the default mode for I-search.
-
-** `isearch' and `query-replace' now perform character folding in matches.
-This is analogous to case folding, but instead of disregarding case
-variants, it disregards wider classes of distinctions between similar
-characters. (Case folding is a special case of character folding.)
-This means many characters in the search string will match entire
-groups of characters instead of just themselves.
-
-For instance, the " will match all variants of double quotes (like “
-and ”), and the letter a will match all of its accented cousins, even
-those composed of multiple characters, as well as many other symbols
-like ℀, ℁, ⒜, and ⓐ.
-
-** New function `character-fold-to-regexp' can be used
-by searching commands to produce a regexp matching anything that
-character-folds into STRING.
-
** New command `checkdoc-package-keywords' checks if the
current package keywords are recognized. Set the new option
`checkdoc-package-keywords-flag' to non-nil to make
@@ -175,10 +156,6 @@ the `network-security-level' variable.
** C-h l now also lists the commands that were run.
----
-** The new M-s M-w key binding uses eww to search the web for the
-text in the region.
-
** M-x suggests shorthands and ignores obsolete commands for completion.
** x-select-enable-clipboard is renamed select-enable-clipboard.
x-select-enable-primary and renamed select-enable-primary.
@@ -532,6 +509,36 @@ element. The new commands bound to <up> and <down> in the
minibuffer:
** Search and Replace
++++
+*** New user option `search-default-regexp-mode'
+specifies the default mode for I-search.
+
++++
+*** `isearch' and `query-replace' can now perform character folding in matches.
+Isearch does that by default, while `query-replace' will do that if
+the new variable `replace-character-fold' is customized to a non-nil
+value. This is analogous to case folding, but instead of disregarding
+case variants, it disregards wider classes of distinctions between
+similar characters. (Case folding is a special case of character
+folding.) This means many characters in the search string will match
+entire groups of characters instead of just themselves.
+
+For instance, the " will match all variants of double quotes (like “
+and ”), and the letter a will match all of its accented cousins, even
+those composed of multiple characters, as well as many other symbols
+like ℀, ℁, ⒜, and ⓐ.
+
++++
+*** New function `character-fold-to-regexp' can be used
+by searching commands to produce a regexp matching anything that
+character-folds into STRING.
+
++++
+*** The new M-s M-w key binding uses eww to search the web for the
+text in the region. The search engine to use for this is specified by
+the customizable variable `eww-search-prefix'.
+
++++
*** Query-replace history is enhanced.
When query-replace reads the FROM string from the minibuffer, typing
`M-p' will now show previous replacements as "FROM SEP TO", where FROM
diff --git a/lisp/isearch.el b/lisp/isearch.el
index 080eb57..0a6b925 100644
--- a/lisp/isearch.el
+++ b/lisp/isearch.el
@@ -96,8 +96,12 @@ in Isearch mode is always downcased."
(defcustom search-nonincremental-instead t
"If non-nil, do a nonincremental search instead of exiting immediately.
-Actually, `isearch-edit-string' is called to let you enter the search
-string, and RET terminates editing and does a nonincremental search."
+This affects the behavior of `isearch-exit' and any key bound to that
+command: if this variable is nil, `isearch-exit' always exits the search;
+if the value is non-nil, and the search string is empty, `isearch-exit'
+starts a nonincremental search instead. (Actually, `isearch-edit-string'
+is called to let you enter the search string, and RET terminates editing
+and does a nonincremental search.)"
:type 'boolean)
(defcustom search-whitespace-regexp (purecopy "\\s-+")
@@ -142,9 +146,11 @@ whenever point is in one of them."
(defcustom isearch-hide-immediately t
"If non-nil, re-hide an invisible match right away.
This variable makes a difference when `search-invisible' is set to `open'.
+If non-nil, invisible matches are re-hidden as soon as the match moves
+off the invisible text surrounding the match.
If nil then do not re-hide opened invisible text when the match moves.
Whatever the value, all opened invisible text is hidden again after exiting
-the search."
+the search, with the exception of the last successful match, if any."
:type 'boolean)
(defcustom isearch-resume-in-command-history nil
diff --git a/lisp/replace.el b/lisp/replace.el
index 7727562..a671a98 100644
--- a/lisp/replace.el
+++ b/lisp/replace.el
@@ -111,7 +111,8 @@ strings or patterns."
:version "22.1")
(defcustom query-replace-show-replacement t
- "Non-nil means to show what actual replacement text will be."
+ "Non-nil means show substituted replacement text in the minibuffer.
+This variable affects only `query-replace-regexp'."
:type 'boolean
:group 'matching
:version "23.1")
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] emacs-25 8f2a5a8: Improve and update documentation of search commands,
Eli Zaretskii <=