Mercurial > hg > xemacs-beta
diff man/xemacs/fixit.texi @ 0:376386a54a3c r19-14
Import from CVS: tag r19-14
author | cvs |
---|---|
date | Mon, 13 Aug 2007 08:45:50 +0200 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/man/xemacs/fixit.texi Mon Aug 13 08:45:50 2007 +0200 @@ -0,0 +1,183 @@ + +@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.