Fix typo.
[emacs.git] / doc / emacs / fixit.texi
bloba5b571d20885737f6ecdd2648b2e548a2003f7f5
1 @c This is part of the Emacs manual.
2 @c Copyright (C) 1985-1987, 1993-1995, 1997, 2001-2014 Free Software
3 @c Foundation, Inc.
4 @c See file emacs.texi for copying conditions.
5 @node Fixit
6 @chapter Commands for Fixing Typos
7 @cindex typos, fixing
8 @cindex mistakes, correcting
10   In this chapter we describe commands that are useful when you catch
11 a mistake while editing.  The most fundamental of these commands is
12 the undo command @kbd{C-/} (also bound to @kbd{C-x u} and @kbd{C-_}).
13 This undoes a single command, or a
14 part of a command (as in the case of @code{query-replace}), or several
15 consecutive character insertions.  Consecutive repetitions of
16 @kbd{C-/} undo earlier and earlier changes, back to the limit of the
17 undo information available.
19   Aside from the commands described here, you can erase text using
20 deletion commands such as @key{DEL} (@code{delete-backward-char}).
21 These were described earlier in this manual.  @xref{Erasing}.
23 @menu
24 * Undo::        The Undo commands.
25 * Transpose::   Exchanging two characters, words, lines, lists...
26 * Fixing Case:: Correcting case of last word entered.
27 * Spelling::    Apply spelling checker to a word, or a whole file.
28 @end menu
30 @node Undo
31 @section Undo
32 @cindex undo
33 @cindex changes, undoing
35   The @dfn{undo} command reverses recent changes in the buffer's text.
36 Each buffer records changes individually, and the undo command always
37 applies to the current buffer.  You can undo all the changes in a
38 buffer for as far back as the buffer's records go.  Usually, each editing
39 command makes a separate entry in the undo records, but some commands
40 such as @code{query-replace} divide their changes into multiple
41 entries for flexibility in undoing.  Consecutive character insertion
42 commands are usually grouped together into a single undo record, to
43 make undoing less tedious.
45 @table @kbd
46 @item C-/
47 @itemx C-x u
48 @itemx C-_
49 Undo one entry in the current buffer's undo records (@code{undo}).
50 @end table
52 @kindex C-x u
53 @kindex C-_
54 @kindex C-/
55 @findex undo
56   To begin to undo, type @kbd{C-/} (or its aliases, @kbd{C-_} or
57 @kbd{C-x u})@footnote{Aside from @kbd{C-/}, the @code{undo} command is
58 also bound to @kbd{C-x u} because that is more straightforward for
59 beginners to remember: @samp{u} stands for ``undo''.  It is also bound
60 to @kbd{C-_} because typing @kbd{C-/} on some text terminals actually
61 enters @kbd{C-_}.}.  This undoes the most recent change in the buffer,
62 and moves point back to where it was before that change.
63   Consecutive repetitions of @kbd{C-/} (or its aliases) undo earlier
64 and earlier changes in the current buffer.  If all the recorded
65 changes have already been undone, the undo command signals an error.
67 @cindex redo
68 @findex undo-only
69   Any command other than an undo command breaks the sequence of undo
70 commands.  Starting from that moment, the entire sequence of undo
71 commands that you have just performed are themselves placed into the
72 undo record, as a single set of changes.  Therefore, to re-apply
73 changes you have undone, type @kbd{C-f} or any other command that
74 harmlessly breaks the sequence of undoing; then type @kbd{C-/} to undo
75 the undo command.
77   Alternatively, if you want to resume undoing, without redoing
78 previous undo commands, use @kbd{M-x undo-only}.  This is like
79 @code{undo}, but will not redo changes you have just undone.
81   If you notice that a buffer has been modified accidentally, the
82 easiest way to recover is to type @kbd{C-/} repeatedly until the stars
83 disappear from the front of the mode line (@pxref{Mode Line}).
84 Whenever an undo command makes the stars disappear from the mode line,
85 it means that the buffer contents are the same as they were when the
86 file was last read in or saved.  If you do not remember whether you
87 changed the buffer deliberately, type @kbd{C-/} once.  When you see
88 the last change you made undone, you will see whether it was an
89 intentional change.  If it was an accident, leave it undone.  If it
90 was deliberate, redo the change as described above.
92 @cindex selective undo
93 @kindex C-u C-/
94   When there is an active region, any use of @code{undo} performs
95 @dfn{selective undo}: it undoes the most recent change within the
96 region, instead of the entire buffer.  However, when Transient Mark
97 mode is off (@pxref{Disabled Transient Mark}), @kbd{C-/} always
98 operates on the entire buffer, ignoring the region.  In this case, you
99 can perform selective undo by supplying a prefix argument to the
100 @code{undo} command: @kbd{C-u C-/}.  To undo further changes in the
101 same region, repeat the @code{undo} command (no prefix argument is
102 needed).
104   Some specialized buffers do not make undo records.  Buffers whose
105 names start with spaces never do; these buffers are used internally by
106 Emacs to hold text that users don't normally look at or edit.
108 @vindex undo-limit
109 @vindex undo-strong-limit
110 @vindex undo-outer-limit
111 @cindex undo limit
112   When the undo information for a buffer becomes too large, Emacs discards
113 the oldest records from time to time (during @dfn{garbage
114 collection}).  You can specify how much undo information to keep by
115 setting the variables @code{undo-limit}, @code{undo-strong-limit}, and
116 @code{undo-outer-limit}.  Their values are expressed in bytes.
118   The variable @code{undo-limit} sets a soft limit: Emacs keeps undo
119 data for enough commands to reach this size, and perhaps exceed it,
120 but does not keep data for any earlier commands beyond that.  Its
121 default value is 80000.  The variable @code{undo-strong-limit} sets a
122 stricter limit: any previous command (though not the most recent one)
123 that pushes the size past this amount is forgotten.  The default value
124 of @code{undo-strong-limit} is 120000.
126   Regardless of the values of those variables, the most recent change
127 is never discarded unless it gets bigger than @code{undo-outer-limit}
128 (normally 12,000,000).  At that point, Emacs discards the undo data and
129 warns you about it.  This is the only situation in which you cannot
130 undo the last command.  If this happens, you can increase the value of
131 @code{undo-outer-limit} to make it even less likely to happen in the
132 future.  But if you didn't expect the command to create such large
133 undo data, then it is probably a bug and you should report it.
134 @xref{Bugs,, Reporting Bugs}.
136 @node Transpose
137 @section Transposing Text
139 @table @kbd
140 @item C-t
141 Transpose two characters (@code{transpose-chars}).
142 @item M-t
143 Transpose two words (@code{transpose-words}).
144 @item C-M-t
145 Transpose two balanced expressions (@code{transpose-sexps}).
146 @item C-x C-t
147 Transpose two lines (@code{transpose-lines}).
148 @end table
150 @kindex C-t
151 @findex transpose-chars
152   The common error of transposing two characters can be fixed, when they
153 are adjacent, with the @kbd{C-t} command (@code{transpose-chars}).  Normally,
154 @kbd{C-t} transposes the two characters on either side of point.  When
155 given at the end of a line, rather than transposing the last character of
156 the line with the newline, which would be useless, @kbd{C-t} transposes the
157 last two characters on the line.  So, if you catch your transposition error
158 right away, you can fix it with just a @kbd{C-t}.  If you don't catch it so
159 fast, you must move the cursor back between the two transposed
160 characters before you type @kbd{C-t}.  If you transposed a space with
161 the last character of the word before it, the word motion commands are
162 a good way of getting there.  Otherwise, a reverse search (@kbd{C-r})
163 is often the best way.  @xref{Search}.
165 @kindex C-x C-t
166 @findex transpose-lines
167 @kindex M-t
168 @findex transpose-words
169 @c Don't index C-M-t and transpose-sexps here, they are indexed in
170 @c programs.texi, in the "List Commands" node.
171 @c @kindex C-M-t
172 @c @findex transpose-sexps
173   @kbd{M-t} transposes the word before point with the word after point
174 (@code{transpose-words}).  It moves point forward over a word,
175 dragging the word preceding or containing point forward as well.  The
176 punctuation characters between the words do not move.  For example,
177 @w{@samp{FOO, BAR}} transposes into @w{@samp{BAR, FOO}} rather than
178 @samp{@w{BAR FOO,}}.
180   @kbd{C-M-t} (@code{transpose-sexps}) is a similar command for
181 transposing two expressions (@pxref{Expressions}), and @kbd{C-x C-t}
182 (@code{transpose-lines}) exchanges lines.  They work like @kbd{M-t}
183 except as regards what units of text they transpose.
185   A numeric argument to a transpose command serves as a repeat count: it
186 tells the transpose command to move the character (word, expression, line)
187 before or containing point across several other characters (words,
188 expressions, lines).  For example, @kbd{C-u 3 C-t} moves the character before
189 point forward across three other characters.  It would change
190 @samp{f@point{}oobar} into @samp{oobf@point{}ar}.  This is equivalent to
191 repeating @kbd{C-t} three times.  @kbd{C-u - 4 M-t} moves the word
192 before point backward across four words.  @kbd{C-u - C-M-t} would cancel
193 the effect of plain @kbd{C-M-t}.
195   A numeric argument of zero is assigned a special meaning (because
196 otherwise a command with a repeat count of zero would do nothing): to
197 transpose the character (word, expression, line) ending after point
198 with the one ending after the mark.
200 @node Fixing Case
201 @section Case Conversion
203 @table @kbd
204 @item M-- M-l
205 Convert last word to lower case.  Note @kbd{Meta--} is Meta-minus.
206 @item M-- M-u
207 Convert last word to all upper case.
208 @item M-- M-c
209 Convert last word to lower case with capital initial.
210 @end table
212 @kindex M-@t{-} M-l
213 @kindex M-@t{-} M-u
214 @kindex M-@t{-} M-c
215   A very common error is to type words in the wrong case.  Because of this,
216 the word case-conversion commands @kbd{M-l}, @kbd{M-u} and @kbd{M-c} have a
217 special feature when used with a negative argument: they do not move the
218 cursor.  As soon as you see you have mistyped the last word, you can simply
219 case-convert it and go on typing.  @xref{Case}.
221 @node Spelling
222 @section Checking and Correcting Spelling
223 @cindex spelling, checking and correcting
224 @cindex checking spelling
225 @cindex correcting spelling
227   This section describes the commands to check the spelling of a
228 single word or of a portion of a buffer.  These commands only work if
229 the spelling checker program Aspell, Ispell or Hunspell is installed.
230 These programs are not part of Emacs, but one of them is usually
231 installed in GNU/Linux and other free operating systems.
232 @ifnottex
233 @xref{Top, Aspell,, aspell, The Aspell Manual}.
234 @end ifnottex
236 @table @kbd
237 @item M-$
238 Check and correct spelling of the word at point (@code{ispell-word}).
239 If the region is active, do it for all words in the region instead.
240 @item M-x ispell
241 Check and correct spelling of all words in the buffer.  If the region
242 is active, do it for all words in the region instead.
243 @item M-x ispell-buffer
244 Check and correct spelling in the buffer.
245 @item M-x ispell-region
246 Check and correct spelling in the region.
247 @item M-x ispell-message
248 Check and correct spelling in a draft mail message, excluding cited
249 material.
250 @item M-x ispell-change-dictionary @key{RET} @var{dict} @key{RET}
251 Restart the Aspell/Ispell/Hunspell process, using @var{dict} as the dictionary.
252 @item M-x ispell-kill-ispell
253 Kill the Aspell/Ispell/Hunspell subprocess.
254 @item M-@key{TAB}
255 @itemx @key{ESC} @key{TAB}
256 Complete the word before point based on the spelling dictionary
257 (@code{ispell-complete-word}).
258 @item M-x flyspell-mode
259 Enable Flyspell mode, which highlights all misspelled words.
260 @item M-x flyspell-prog-mode
261 Enable Flyspell mode for comments and strings only.
262 @end table
264 @kindex M-$
265 @findex ispell-word
266   To check the spelling of the word around or before point, and
267 optionally correct it as well, type @kbd{M-$} (@code{ispell-word}).
268 If a region is active, @kbd{M-$} checks the spelling of all words
269 within the region.  @xref{Mark}.  (When Transient Mark mode is off,
270 @kbd{M-$} always acts on the word around or before point, ignoring the
271 region; @pxref{Disabled Transient Mark}.)
273 @findex ispell
274 @findex ispell-buffer
275 @findex ispell-region
276 @cindex spell-checking the active region
277   Similarly, the command @kbd{M-x ispell} performs spell-checking in
278 the region if one is active, or in the entire buffer otherwise.  The
279 commands @kbd{M-x ispell-buffer} and @kbd{M-x ispell-region}
280 explicitly perform spell-checking on the entire buffer or the region
281 respectively.  To check spelling in an email message you are writing,
282 use @kbd{M-x ispell-message}; that command checks the whole buffer,
283 except for material that is indented or appears to be cited from other
284 messages.  @xref{Sending Mail}.
286   When one of these commands encounters what appears to be an
287 incorrect word, it asks you what to do.  It usually displays a list of
288 numbered ``near-misses''---words that are close to the incorrect word.
289 Then you must type a single-character response.  Here are the valid
290 responses:
292 @table @kbd
293 @item @var{digit}
294 Replace the word, just this time, with one of the displayed
295 near-misses.  Each near-miss is listed with a digit; type that digit
296 to select it.
298 @item @key{SPC}
299 Skip this word---continue to consider it incorrect, but don't change it
300 here.
302 @item r @var{new} @key{RET}
303 Replace the word, just this time, with @var{new}.  (The replacement
304 string will be rescanned for more spelling errors.)
306 @item R @var{new} @key{RET}
307 Replace the word with @var{new}, and do a @code{query-replace} so you
308 can replace it elsewhere in the buffer if you wish.  (The replacements
309 will be rescanned for more spelling errors.)
311 @item a
312 Accept the incorrect word---treat it as correct, but only in this
313 editing session.
315 @item A
316 Accept the incorrect word---treat it as correct, but only in this
317 editing session and for this buffer.
319 @item i
320 Insert this word in your private dictionary file so that Aspell or Ispell
321 or Hunspell will consider it correct from now on, even in future sessions.
323 @item m
324 Like @kbd{i}, but you can also specify dictionary completion
325 information.
327 @item u
328 Insert the lower-case version of this word in your private dic@-tion@-ary
329 file.
331 @item l @var{word} @key{RET}
332 Look in the dictionary for words that match @var{word}.  These words
333 become the new list of ``near-misses''; you can select one of them as
334 the replacement by typing a digit.  You can use @samp{*} in @var{word} as a
335 wildcard.
337 @item C-g
338 @itemx X
339 Quit interactive spell checking, leaving point at the word that was
340 being checked.  You can restart checking again afterward with @kbd{C-u
341 M-$}.
343 @item x
344 Quit interactive spell checking and move point back to where it was
345 when you started spell checking.
347 @item q
348 Quit interactive spell checking and kill the spell-checker subprocess.
350 @item ?
351 Show the list of options.
352 @end table
354 @findex ispell-complete-word
355   In Text mode and related modes, @kbd{M-@key{TAB}}
356 (@code{ispell-complete-word}) performs in-buffer completion based on
357 spelling correction.  Insert the beginning of a word, and then type
358 @kbd{M-@key{TAB}}; this shows a list of completions.  (If your
359 window manager intercepts @kbd{M-@key{TAB}}, type @kbd{@key{ESC}
360 @key{TAB}} or @kbd{C-M-i}.)  Each completion is listed with a digit or
361 character; type that digit or character to choose it.
363 @cindex @code{ispell} program
364 @findex ispell-kill-ispell
365   Once started, the Aspell or Ispell or Hunspell subprocess continues
366 to run, waiting for something to do, so that subsequent spell checking
367 commands complete more quickly.  If you want to get rid of the
368 process, use @kbd{M-x ispell-kill-ispell}.  This is not usually
369 necessary, since the process uses no processor time except when you do
370 spelling correction.
372 @vindex ispell-dictionary
373 @vindex ispell-local-dictionary
374 @vindex ispell-personal-dictionary
375 @findex ispell-change-dictionary
376   Ispell, Aspell and Hunspell look up spelling in two dictionaries:
377 the standard dictionary and your personal dictionary.  The standard
378 dictionary is specified by the variable @code{ispell-local-dictionary}
379 or, if that is @code{nil}, by the variable @code{ispell-dictionary}.
380 If both are @code{nil}, the spelling program's default dictionary is
381 used.  The command @kbd{M-x ispell-change-dictionary} sets the
382 standard dictionary for the buffer and then restarts the subprocess,
383 so that it will use a different standard dictionary.  Your personal
384 dictionary is specified by the variable
385 @code{ispell-personal-dictionary}.  If that is @code{nil}, the
386 spelling program looks for a personal dictionary in a default
387 location.
389 @vindex ispell-complete-word-dict
390   A separate dictionary is used for word completion.  The variable
391 @code{ispell-complete-word-dict} specifies the file name of this
392 dictionary.  The completion dictionary must be different because it
393 cannot use root and affix information.  For some languages, there
394 is a spell checking dictionary but no word completion dictionary.
396 @cindex Flyspell mode
397 @cindex mode, Flyspell
398 @findex flyspell-mode
399   Flyspell mode is a minor mode that performs automatic spell checking
400 as you type.  When it finds a word that it does not recognize, it
401 highlights that word.  Type @kbd{M-x flyspell-mode} to toggle Flyspell
402 mode in the current buffer.  To enable Flyspell mode in all text mode
403 buffers, add @code{flyspell-mode} to @code{text-mode-hook}.
404 @xref{Hooks}.
406   When Flyspell mode highlights a word as misspelled, you can click on
407 it with @kbd{Mouse-2} to display a menu of possible corrections and
408 actions.  You can also correct the word by editing it manually in any
409 way you like.
411 @findex flyspell-prog-mode
412   Flyspell Prog mode works just like ordinary Flyspell mode, except
413 that it only checks words in comments and string constants.  This
414 feature is useful for editing programs.  Type @kbd{M-x
415 flyspell-prog-mode} to enable or disable this mode in the current
416 buffer.  To enable this mode in all programming mode buffers, add
417 @code{flyspell-prog-mode} to @code{prog-mode-hook} (@pxref{Hooks}).