Commit b2a42eb7 authored by Chong Yidong's avatar Chong Yidong
Browse files

* trouble.texi (Quitting): Add other undo bindings to table.

(DEL Does Not Delete): Note that the erasure key is usually labelled
"Backspace".  Remove discussion of obscure Xmodmap issue.
parent a9e3ff69
2009-05-12 Chong Yidong <cyd@stupidchicken.com>
* trouble.texi (Quitting): Add other undo bindings to table.
(DEL Does Not Delete): Note that the erasure key is usually labelled
"Backspace". Remove discussion of obscure Xmodmap issue.
2009-05-07 Chong Yidong <cyd@stupidchicken.com> 2009-05-07 Chong Yidong <cyd@stupidchicken.com>
* files.texi (Visiting): Copyedits. * files.texi (Visiting): Copyedits.
......
...@@ -30,7 +30,9 @@ invoked it (@code{abort-recursive-edit}). ...@@ -30,7 +30,9 @@ invoked it (@code{abort-recursive-edit}).
Either quit or abort, whichever makes sense (@code{keyboard-escape-quit}). Either quit or abort, whichever makes sense (@code{keyboard-escape-quit}).
@item M-x top-level @item M-x top-level
Abort all recursive editing levels that are currently executing. Abort all recursive editing levels that are currently executing.
@item C-x u @item C-/
@itemx C-x u
@itemx C-_
Cancel a previously made change in the buffer contents (@code{undo}). Cancel a previously made change in the buffer contents (@code{undo}).
@end table @end table
...@@ -126,10 +128,10 @@ effect only when Emacs is ready for a command. @kbd{C-]} is an ...@@ -126,10 +128,10 @@ effect only when Emacs is ready for a command. @kbd{C-]} is an
ordinary key and has its meaning only because of its binding in the ordinary key and has its meaning only because of its binding in the
keymap. @xref{Recursive Edit}. keymap. @xref{Recursive Edit}.
@kbd{C-x u} (@code{undo}) is not strictly speaking a way of canceling @kbd{C-/} (@code{undo}) is not strictly speaking a way of canceling
a command, but you can think of it as canceling a command that already a command, but you can think of it as canceling a command that already
finished executing. @xref{Undo}, for more information finished executing. @xref{Undo}, for more information about the undo
about the undo facility. facility.
@node Lossage, Bugs, Quitting, Top @node Lossage, Bugs, Quitting, Top
@section Dealing with Emacs Trouble @section Dealing with Emacs Trouble
...@@ -159,26 +161,21 @@ in the Emacs distribution. Type @kbd{C-h C-f} to read the FAQ; type ...@@ -159,26 +161,21 @@ in the Emacs distribution. Type @kbd{C-h C-f} to read the FAQ; type
@cindex @key{BACKSPACE} vs @key{DEL} @cindex @key{BACKSPACE} vs @key{DEL}
@cindex usual erasure key @cindex usual erasure key
Every keyboard has a large key, a little ways above the @key{RET} or Every keyboard has a large key, usually labelled @key{Backspace},
@key{ENTER} key, which you normally use outside Emacs to erase the which is ordinarily used to erase the last character that you typed.
last character that you typed. We call this key @dfn{the usual We call this key @dfn{the usual erasure key}. In Emacs, it is
erasure key}. In Emacs, it is supposed to be equivalent to @key{DEL}, supposed to be equivalent to @key{DEL}.
and when Emacs is properly configured for your terminal, it translates
that key into the character @key{DEL}.
When Emacs starts up on a graphical display, it determines When Emacs starts up on a graphical display, it determines
automatically which key should be @key{DEL}. In some unusual cases automatically which key should be @key{DEL}. In some unusual cases,
Emacs gets the wrong information from the system. If the usual Emacs gets the wrong information from the system. If the usual
erasure key deletes forwards instead of backwards, that is probably erasure key deletes forwards instead of backwards, that is probably
what happened---Emacs ought to be treating the @key{DELETE} key as what happened---Emacs ought to be treating the @key{Backspace} key as
@key{DEL}, but it isn't. @key{DEL}, but it isn't.
On a graphical display, if the usual erasure key is labeled Some keyboards also have a @key{Delete} key, which is ordinarily
@key{BACKSPACE} and there is a @key{DELETE} key elsewhere, but the used to forwards. If this key deletes backward in Emacs, that too
@key{DELETE} key deletes backward instead of forward, that too
suggests Emacs got the wrong information---but in the opposite sense. suggests Emacs got the wrong information---but in the opposite sense.
It ought to be treating the @key{BACKSPACE} key as @key{DEL}, and
treating @key{DELETE} differently, but it isn't.
On a text-only terminal, if you find the usual erasure key prompts On a text-only terminal, if you find the usual erasure key prompts
for a Help command, like @kbd{Control-h}, instead of deleting a for a Help command, like @kbd{Control-h}, instead of deleting a
...@@ -197,9 +194,9 @@ work, if it sends character code 127. ...@@ -197,9 +194,9 @@ work, if it sends character code 127.
@findex normal-erase-is-backspace-mode @findex normal-erase-is-backspace-mode
To fix the problem automatically for every Emacs session, you can To fix the problem automatically for every Emacs session, you can
put one of the following lines into your @file{.emacs} file put one of the following lines into your @file{.emacs} file
(@pxref{Init File}). For the first case above, where @key{DELETE} (@pxref{Init File}). For the first case above, where @key{Backspace}
deletes forwards instead of backwards, use this line to make deletes forwards instead of backwards, use this line to make
@key{DELETE} act as @key{DEL} (resulting in behavior compatible @key{Backspace} act as @key{DEL} (resulting in behavior compatible
with Emacs 20 and previous versions): with Emacs 20 and previous versions):
@lisp @lisp
...@@ -207,8 +204,7 @@ with Emacs 20 and previous versions): ...@@ -207,8 +204,7 @@ with Emacs 20 and previous versions):
@end lisp @end lisp
@noindent @noindent
For the other two cases, where @key{BACKSPACE} ought to act as For the other two cases, use this line:
@key{DEL}, use this line:
@lisp @lisp
(normal-erase-is-backspace-mode 1) (normal-erase-is-backspace-mode 1)
...@@ -221,15 +217,6 @@ customize the variable @code{normal-erase-is-backspace}: the value ...@@ -221,15 +217,6 @@ customize the variable @code{normal-erase-is-backspace}: the value
@key{DEL}, and @code{nil} specifies the other mode. @xref{Easy @key{DEL}, and @code{nil} specifies the other mode. @xref{Easy
Customization}. Customization}.
On a graphical display, it can also happen that the usual erasure key
is labeled @key{BACKSPACE}, there is a @key{DELETE} key elsewhere, and
both keys delete forward. This probably means that someone has
redefined your @key{BACKSPACE} key as a @key{DELETE} key. With X,
this is typically done with a command to the @code{xmodmap} program
when you start the server or log in. The most likely motive for this
customization was to support old versions of Emacs, so we recommend
you simply remove it now.
@node Stuck Recursive @node Stuck Recursive
@subsection Recursive Editing Levels @subsection Recursive Editing Levels
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment