annotate man/new-users-guide/search.texi @ 22:8fc7fe29b841 r19-15b94

Import from CVS: tag r19-15b94
author cvs
date Mon, 13 Aug 2007 08:50:29 +0200
parents 376386a54a3c
children c9fe270a4101
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1 @comment node-name, next, previous, up
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2 @node Search and Replace, , Select and Move, Top
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3 @chapter Searching and Replacing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
4 @cindex searching
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
5 @cindex replace
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
6 @vindex case-fold-search
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
7
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
8 Emacs provides commands for searching for occurrences of a particular
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
9 string. The search is incremental i.e. it begins even before you
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
10 complete typing the whole string. All searches in Emacs ignore the case
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
11 of the text they are searching, i.e. if you are searching for "String",
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
12 then "string" will also be one of the selections. If you want a case
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
13 sensitive search select the @b{Case Sensitive Search} from the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
14 @b{Option} menu. You can also set the variable @var{case-fold-search} to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
15 @var{nil} for making searches case-sensitive. For information on setting
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
16 variables, @xref{Setting Variables}. The two commands for searching for
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
17 strings in XEmacs are:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
18
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
19 @table @kbd
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
20 @item C-s
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
21 @findex isearch-forward
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
22 @kindex C-s
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
23 This command will prompt you for a string to search :
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
24
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
25 @example
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
26 I-search:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
27 @end example
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
28
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
29 @noindent
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
30 If you type "myname" as the string to be searched, then Emacs will start
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
31 searching for "m", "my", "myn", etc as you go on typing the whole
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
32 string in the forward direction. The cursor will be on the matching
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
33 string which has been found so far. If you find the correct match just
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
34 hit @key{RET} or type @kbd{C-f} or @kbd{C-b} to set the cursor's
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
35 position. If you find a matching string "myname" but you were looking
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
36 for a different occurrence of it, use @kbd{C-s} again. If the search is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
37 unable to find the string, it will give you an error message.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
38
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
39 @item C-r
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
40 @findex isearch-backward
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
41 @kindex C-r
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
42 This command will perform an incremental search in the backward
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
43 direction. It will prompt you for a string name:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
44
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
45 @example
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
46 I-search backward:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
47 @end example
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
48
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
49 @noindent
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
50 After you start typing the string name, it will search for the string in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
51 the same fashion as it does for @kbd{C-s} except that it will search in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
52 the backward direction. If it cannot find the string name, it will give
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
53 you an error message.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
54 @end table
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
55
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
56 If you make a mistake while typing the string names when you use the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
57 above commands, you can use the @key{DEL} key to erase characters. Each
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
58 @key{DEL} will erase the last character. At any time if you want to quit
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
59 the search, just type @kbd{C-g}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
60
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
61 To do a non-incremental search i.e. to start the search only after
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
62 you have typed the whole string you can use the following commands:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
63
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
64 @table @kbd
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
65 @item C-s RET @dfn{string} RET
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
66 This command will search for the specified string in the forward
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
67 direction and will give an error message if the string is not found.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
68
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
69 @item C-r RET @dfn{string} RET
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
70 This command will search for the specified string in the backward
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
71 direction.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
72 @end table
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
73
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
74 For information on how Emacs searches for words and regular
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
75 expressions, @xref{Search,,,,XEmacs User's Manual}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
76
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
77 To replace all occurrences of a string in Emacs, you can use the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
78 following command:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
79 @findex replace-string
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
80 @example
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
81 M-x replace-string
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
82 @end example
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
83
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
84 @noindent
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
85 After you type @kbd{M-x replace-string}, you will be prompted for a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
86 string name to replace:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
87
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
88 @example
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
89 Replace string:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
90 @end example
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
91
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
92 @noindent
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
93 After you type in a string name, for example "FOO" and press @key{RET},
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
94 you will see another prompt:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
95
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
96 @example
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
97 Replace string FOO with:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
98 @end example
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
99
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
100 @noindent
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
101 Now type the string which you want to replace "FOO" with and press
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
102 @key{RET}. After all the occurrences are replaced you will see the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
103 message "Done" in the echo area. If you want only some occurrences of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
104 the string to be replaced, use @kbd{M-x query-replace RET <string> RET
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
105 <newstring> RET}. For more information, @xref{Query Replace,,,,XEmacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
106 Manual}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
107
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
108 XEmacs also provides a utility for checking spellings. Use @kbd{M-x
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
109 ispell-buffer} to check for spellings in the whole buffer. You can also
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
110 check the spelling of a word or a region. You can use menus to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
111 check for spellings:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
112
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
113 @noindent
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
114 Evaluate the expression @code{(load "big-menubar")}. To evaluate this
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
115 expression you need to hit the @key{META} or the @key{ESC} key twice and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
116 type in the expression in the echo area before hitting @key{RET}. You
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
117 will get an extensive menubar. Select the @b{Spell Check} menu item from
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
118 the @b{Utilities} menu for checking spellings.