comparison man/fixit.texi @ 88155:d7ddb3e565de

sync with trunk

88154:8ce476d3ba36

@c This is part of the Emacs manual.
@c Copyright (C) 1985, 86, 87, 93, 94, 95, 1997 Free Software Foundation, Inc.
@c See file emacs.texi for copying conditions.
@node Fixit, Files, Search, Top
@chapter Commands for Fixing Typos
@cindex typos, fixing
@cindex mistakes, correcting

  In this chapter we describe the commands that are especially useful for
the times when you catch a mistake in your text just after you have made
it, or change your mind while composing text on the fly.

  The most fundamental command for correcting erroneous editing is the
undo command, @kbd{C-x u} or @kbd{C-_}.  This command undoes a single
command (usually), a part of a command (in the case of
@code{query-replace}), or several consecutive self-inserting characters.
Consecutive repetitions of @kbd{C-_} or @kbd{C-x u} undo earlier and
earlier changes, back to the limit of the undo information available.
@xref{Undo}, for more information.

@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.

  This section describes the commands to check the spelling of a single
word or of a portion of a buffer.  These commands work with the spelling
checker program Ispell, which is not part of Emacs.
@ifinfo
@xref{Top, Ispell, Overview ispell, ispell.info, The Ispell Manual}.
@end ifinfo

@table @kbd
@item M-x flyspell-mode
Enable Flyspell mode, which highlights all misspelled words.
@item M-x flyspell-progmode
Enable Flyspell mode for comments and strings only.
@item M-$
Check and correct spelling of the word at point (@code{ispell-word}).
@item M-@key{TAB}
Complete the word before point based on the spelling dictionary
(@code{ispell-complete-word}).
@item M-x ispell
Spell-check the active region or the current buffer.
@item M-x ispell-buffer

it only checks words in comments and string constants.  This feature
is useful for editing programs.  Type @kbd{M-x flyspell-prog-mode} to
enable or disable this mode in the current buffer.

  The other Emacs spell-checking features check or look up words when
you give an explicit command to do so.  Checking all or part of the
buffer is useful when you have text that was written outside of this
Emacs session and might contain any number of misspellings.

@kindex M-$
@findex ispell-word
  To check the spelling of the word around or next to point, and
optionally correct it as well, use the command @kbd{M-$}
(@code{ispell-word}).  If the word is not correct, the command offers
you various alternatives for what to do about it.

@findex ispell-buffer

@item @key{SPC}
Skip this word---continue to consider it incorrect, but don't change it
here.

@item r @var{new} @key{RET}
Replace the word (just this time) with @var{new}.

@item R @var{new} @key{RET}
Replace the word with @var{new}, and do a @code{query-replace} so you
can replace it elsewhere in the buffer if you wish.

@item @var{digit}
Replace the word (just this time) with one of the displayed
near-misses.  Each near-miss is listed with a digit; type that digit to
select it.

become the new list of ``near-misses''; you can select one of them as
the replacement by typing a digit.  You can use @samp{*} in @var{word} as a
wildcard.

@item C-g
Quit interactive spell checking.  You can restart it again afterward
with @kbd{C-u M-$}.

@item X
Same as @kbd{C-g}.

@item x

Refresh the screen.

@item C-z
This key has its normal command meaning (suspend Emacs or iconify this
frame).
@end table

@findex ispell-complete-word
  The command @code{ispell-complete-word}, which is bound to the key
@kbd{M-@key{TAB}} in Text mode and related modes, shows a list of
completions based on spelling correction.  Insert the beginning of a
word, and then type @kbd{M-@key{TAB}}; the command displays a completion
list window.  To choose one of the completions listed, click
@kbd{Mouse-2} on it, or move the cursor there in the completions window
and type @key{RET}.  @xref{Text Mode}.

@ignore
@findex reload-ispell
  The first time you use any of the spell checking commands, it starts
an Ispell subprocess.  The first thing the subprocess does is read your

@vindex ispell-complete-word-dict
  Ispell uses a separate dictionary for word completion.  The variable
@code{ispell-complete-word-dict} specifies the file name of this
dictionary.  The completion dictionary must be different because it
cannot use employ root and affix information.  For some languages
there is a spell checking dictionary but no word completion
dictionary.

88155:d7ddb3e565de

@c This is part of the Emacs manual.
@c Copyright (C) 1985, 1986, 1987, 1993, 1994, 1995, 1997, 2002, 2003,
@c   2004, 2005 Free Software Foundation, Inc.
@c See file emacs.texi for copying conditions.
@node Fixit, Keyboard Macros, Search, Top
@chapter Commands for Fixing Typos
@cindex typos, fixing
@cindex mistakes, correcting

  In this chapter we describe the commands that are especially useful for
the times when you catch a mistake in your text just after you have made
it, or change your mind while composing text on the fly.

  The most fundamental command for correcting erroneous editing is the
undo command, @kbd{C-x u} or @kbd{C-_} or @kbd{C-/}.  This command
undoes a single command (usually), a part of a command (in the case of
@code{query-replace}), or several consecutive self-inserting
characters.  Consecutive repetitions of the undo command undo earlier
and earlier changes, back to the limit of the undo information
available.  @xref{Undo}, for more information.

@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.

  This section describes the commands to check the spelling of a single
word or of a portion of a buffer.  These commands work with the spelling
checker program Ispell, which is not part of Emacs.
@ifinfo
@xref{Top, Ispell, Overview ispell, ispell, The Ispell Manual}.
@end ifinfo

@table @kbd
@item M-x flyspell-mode
Enable Flyspell mode, which highlights all misspelled words.
@item M-x flyspell-prog-mode
Enable Flyspell mode for comments and strings only.
@item M-$
Check and correct spelling of the word at point (@code{ispell-word}).
@item M-@key{TAB}
@itemx @key{ESC} @key{TAB}
Complete the word before point based on the spelling dictionary
(@code{ispell-complete-word}).
@item M-x ispell
Spell-check the active region or the current buffer.
@item M-x ispell-buffer

it only checks words in comments and string constants.  This feature
is useful for editing programs.  Type @kbd{M-x flyspell-prog-mode} to
enable or disable this mode in the current buffer.

  The other Emacs spell-checking features check or look up words when
you give an explicit command to do so.

@kindex M-$
@findex ispell-word
  To check the spelling of the word around or before point, and
optionally correct it as well, use the command @kbd{M-$}
(@code{ispell-word}).  If the word is not correct, the command offers
you various alternatives for what to do about it.

@findex ispell-buffer

@item @key{SPC}
Skip this word---continue to consider it incorrect, but don't change it
here.

@item r @var{new} @key{RET}
Replace the word (just this time) with @var{new}.  (The replacement
string will be rescanned for more spelling errors.)

@item R @var{new} @key{RET}
Replace the word with @var{new}, and do a @code{query-replace} so you
can replace it elsewhere in the buffer if you wish.  (The replacements
will be rescanned for more spelling errors.)

@item @var{digit}
Replace the word (just this time) with one of the displayed
near-misses.  Each near-miss is listed with a digit; type that digit to
select it.

become the new list of ``near-misses''; you can select one of them as
the replacement by typing a digit.  You can use @samp{*} in @var{word} as a
wildcard.

@item C-g
Quit interactive spell checking, leaving point at the word that was
being checked.  You can restart checking again afterward with @kbd{C-u
M-$}.

@item X
Same as @kbd{C-g}.

@item x

Refresh the screen.

@item C-z
This key has its normal command meaning (suspend Emacs or iconify this
frame).

@item ?
Show the list of options.
@end table

@findex ispell-complete-word
  The command @code{ispell-complete-word}, which is bound to the key
@kbd{M-@key{TAB}} in Text mode and related modes, shows a list of
completions based on spelling correction.  Insert the beginning of a
word, and then type @kbd{M-@key{TAB}}; the command displays a
completion list window.  (If your window manager intercepts
@kbd{M-@key{TAB}}, type @kbd{@key{ESC} @key{TAB}} or @kbd{C-M-i}.)  To
choose one of the completions listed, click @kbd{Mouse-2} or
@kbd{Mouse-1} fast on it, or move the cursor there in the completions
window and type @key{RET}.  @xref{Text Mode}.

@ignore
@findex reload-ispell
  The first time you use any of the spell checking commands, it starts
an Ispell subprocess.  The first thing the subprocess does is read your

@vindex ispell-complete-word-dict
  Ispell uses a separate dictionary for word completion.  The variable
@code{ispell-complete-word-dict} specifies the file name of this
dictionary.  The completion dictionary must be different because it
cannot use root and affix information.  For some languages
there is a spell checking dictionary but no word completion
dictionary.

@ignore
   arch-tag: 3359a443-96ed-448f-9f05-c8111ba8eac0
@end ignore