mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-12-14 09:39:42 +00:00
Code Issues Releases Activity

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

Browse Source 
(DEL Does Not Delete): Note that the erasure key is usually labelled
"Backspace".  Remove discussion of obscure Xmodmap issue.
This commit is contained in:
Chong Yidong 2009-05-12 02:05:55 +00:00
parent a9e3ff690b
commit b2a42eb75d
2 changed files with 23 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
doc/emacs/ChangeLog
View File

@ -1,3 +1,9 @@
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>
* files.texi (Visiting): Copyedits.

47
doc/emacs/trouble.texi
View File

@ -30,7 +30,9 @@ invoked it (@code{abort-recursive-edit}).
Either quit or abort, whichever makes sense (@code{keyboard-escape-quit}).
@item M-x top-level
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}).
@end table
@ -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
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
finished executing. @xref{Undo}, for more information
about the undo facility.
finished executing. @xref{Undo}, for more information about the undo
facility.
@node Lossage, Bugs, Quitting, Top
@section Dealing with Emacs Trouble
@ -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 usual erasure key
Every keyboard has a large key, a little ways above the @key{RET} or
@key{ENTER} key, which you normally use outside Emacs to erase the
last character that you typed. We call this key @dfn{the usual
erasure key}. In Emacs, it is 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}.
Every keyboard has a large key, usually labelled @key{Backspace},
which is ordinarily used to erase the last character that you typed.
We call this key @dfn{the usual erasure key}. In Emacs, it is
supposed to be equivalent to @key{DEL}.
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
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.
On a graphical display, if the usual erasure key is labeled
@key{BACKSPACE} and there is a @key{DELETE} key elsewhere, but the
@key{DELETE} key deletes backward instead of forward, that too
Some keyboards also have a @key{Delete} key, which is ordinarily
used to forwards. If this key deletes backward in Emacs, that too
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
for a Help command, like @kbd{Control-h}, instead of deleting a
@ -197,9 +194,9 @@ work, if it sends character code 127.
@findex normal-erase-is-backspace-mode
To fix the problem automatically for every Emacs session, you can
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
@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):
@lisp
@ -207,8 +204,7 @@ with Emacs 20 and previous versions):
@end lisp
@noindent
For the other two cases, where @key{BACKSPACE} ought to act as
@key{DEL}, use this line:
For the other two cases, use this line:
@lisp
(normal-erase-is-backspace-mode 1)
@ -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
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
@subsection Recursive Editing Levels