texinfo/texi2html/test/xemacs_manual/fixit.texi

@node Fixit, Files, Search, Top
@chapter Commands for Fixing Typos
@cindex typos
@cindex mistakes, correcting

  This chapter describes commands that are especially useful when you
catch a mistake in your text just after you have made it, or when you 
change your mind while composing text on line.

@menu
* Kill Errors:: Commands to kill a batch of recently entered text.
* Transpose::   Exchanging two characters, words, lines, lists...
* Fixing Case:: Correcting case of last word entered.
* Spelling::    Apply spelling checker to a word, or a whole file.
@end menu

@node Kill Errors, Transpose, Fixit, Fixit
@section Killing Your Mistakes

@table @kbd
@item @key{DEL}
Delete last character (@code{delete-backward-char}).
@item M-@key{DEL}
Kill last word (@code{backward-kill-word}).
@item C-x @key{DEL}
Kill to beginning of sentence (@code{backward-kill-sentence}).
@end table

@kindex DEL
@findex delete-backward-char
  The @key{DEL} character (@code{delete-backward-char}) is the most
important correction command.  When used among graphic (self-inserting)
characters, it can be thought of as canceling the last character typed.

@kindex M-DEL
@kindex C-x DEL
@findex backward-kill-word
@findex backward-kill-sentence
  When your mistake is longer than a couple of characters, it might be more
convenient to use @kbd{M-@key{DEL}} or @kbd{C-x @key{DEL}}.
@kbd{M-@key{DEL}} kills back to the start of the last word, and @kbd{C-x
@key{DEL}} kills back to the start of the last sentence.  @kbd{C-x
@key{DEL}} is particularly useful when you are thinking of what to write as
you type it, in case you change your mind about phrasing.
@kbd{M-@key{DEL}} and @kbd{C-x @key{DEL}} save the killed text for
@kbd{C-y} and @kbd{M-y} to retrieve.  @xref{Yanking}.@refill

  @kbd{M-@key{DEL}} is often useful even when you have typed only a few
characters wrong, if you know you are confused in your typing and aren't
sure exactly what you typed.  At such a time, you cannot correct with
@key{DEL} except by looking at the screen to see what you did.  It requires
less thought to kill the whole word and start over.

@node Transpose, Fixing Case, Kill Errors, Fixit
@section Transposing Text

@table @kbd
@item C-t
Transpose two characters (@code{transpose-chars}).
@item M-t
Transpose two words (@code{transpose-words}).
@item C-M-t
Transpose two balanced expressions (@code{transpose-sexps}).
@item C-x C-t
Transpose two lines (@code{transpose-lines}).
@end table

@cindex transposition
@kindex C-t
@findex transpose-chars
  The common error of transposing two adjacent characters can be fixed
with the @kbd{C-t} command (@code{transpose-chars}).  Normally,
@kbd{C-t} transposes the two characters on either side of point.  When
given at the end of a line, @kbd{C-t} transposes the last two characters
on the line, rather than transposing the last character of the line with
the newline, which would be useless.  If you catch a
transposition error right away, you can fix it with just @kbd{C-t}.
If you catch the error later,  move the cursor back to between
the two transposed characters.  If you transposed a space with the last
character of the word before it, the word motion commands are a good way
of getting there.  Otherwise, a reverse search (@kbd{C-r}) is often the
best way.  @xref{Search}.

@kindex C-x C-t
@findex transpose-lines
@kindex M-t
@findex transpose-words
@kindex C-M-t
@findex transpose-sexps
  @kbd{Meta-t} (@code{transpose-words}) transposes the word before point
with the word after point.  It moves point forward over a word, dragging
the word preceding or containing point forward as well.  The punctuation
characters between the words do not move.  For example, @w{@samp{FOO, BAR}}
transposes into @w{@samp{BAR, FOO}} rather than @samp{@w{BAR FOO,}}.

  @kbd{C-M-t} (@code{transpose-sexps}) is a similar command for transposing
two expressions (@pxref{Lists}), and @kbd{C-x C-t} (@code{transpose-lines})
exchanges lines.  It works like @kbd{M-t} but in determines the
division of the text into syntactic units differently.

  A numeric argument to a transpose command serves as a repeat count: it
tells the transpose command to move the character (word, sexp, line) before
or containing point across several other characters (words, sexps, lines).
For example, @kbd{C-u 3 C-t} moves the character before point forward
across three other characters.  This is equivalent to repeating @kbd{C-t}
three times.  @kbd{C-u - 4 M-t} moves the word before point backward across
four words.  @kbd{C-u - C-M-t} would cancel the effect of plain
@kbd{C-M-t}.@refill

  A numeric argument of zero transposes the character (word, sexp, line)
ending after point with the one ending after the mark (otherwise a
command with a repeat count of zero would do nothing).

@node Fixing Case, Spelling, Transpose, Fixit
@section Case Conversion

@table @kbd
@item M-- M-l
Convert last word to lower case.  Note that @kbd{Meta--} is ``Meta-minus.''
@item M-- M-u
Convert last word to all upper case.
@item M-- M-c
Convert last word to lower case with capital initial.
@end table

@findex downcase-word
@findex upcase-word
@findex capitalize-word
@kindex M-@t{-} M-l
@kindex M-@t{-} M-u
@kindex M-@t{-} M-c
@cindex case conversion
@cindex words
  A  common error is to type words in the wrong case.  Because of this,
the word case-conversion commands @kbd{M-l}, @kbd{M-u}, and @kbd{M-c} do
not move the cursor when used with a negative argument.
As soon as you see you have mistyped the last word, you can simply
case-convert it and continue typing.  @xref{Case}.@refill

@node Spelling,, Fixing Case, Fixit
@section Checking and Correcting Spelling
@cindex spelling

@c doublewidecommands
@table @kbd
@item M-$
Check and correct spelling of word (@code{spell-word}).
@item M-x spell-buffer
Check and correct spelling of each word in the buffer.
@item M-x spell-region
Check and correct spelling of each word in the region.
@item M-x spell-string
Check spelling of specified word.
@end table

@kindex M-$
@findex spell-word
  To check the spelling of the word before point, and optionally correct
it, use the command @kbd{M-$} (@code{spell-word}).  This command runs an
inferior process containing the @code{spell} program to see whether the
word is correct English.  If it is not, it asks you to edit the word (in
the minibuffer) into a corrected spelling, and then performs a
@code{query-replace} to substitute the corrected spelling for the old
one throughout the buffer.

  If you exit the minibuffer without altering the original spelling, it
means you do not want to do anything to that word.  In that case, the
@code{query-replace} is not done.

@findex spell-buffer
  @kbd{M-x spell-buffer} checks each word in the buffer the same way that
@code{spell-word} does, doing a @code{query-replace} for
every incorrect word if appropriate.@refill

@findex spell-region
  @kbd{M-x spell-region} is similar to @code{spell-buffer} but operates
only on the region, not the entire buffer.

@findex spell-string
  @kbd{M-x spell-string} reads a string as an argument and checks
whether that is a correctly spelled English word.  It prints a message
giving the answer in the echo area.