[Emacs-diffs] emacs/doc/emacs ChangeLog trouble.texi

[Chong Yidong]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Chong Yidong <cyd>      09/05/12 02:05:56

Modified files:
        doc/emacs      : ChangeLog trouble.texi 

Log message:
        * 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.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/emacs/ChangeLog?cvsroot=emacs&r1=1.316&r2=1.317
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/emacs/trouble.texi?cvsroot=emacs&r1=1.7&r2=1.8

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/emacs/emacs/doc/emacs/ChangeLog,v
retrieving revision 1.316
retrieving revision 1.317
diff -u -b -r1.316 -r1.317
--- ChangeLog   7 May 2009 02:18:48 -0000       1.316
+++ ChangeLog   12 May 2009 02:05:55 -0000      1.317
@@ -1,3 +1,9 @@
+2009-05-12  Chong Yidong  <address@hidden>
+
+       * 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  <address@hidden>
 
        * files.texi (Visiting): Copyedits.

Index: trouble.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/emacs/trouble.texi,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -b -r1.7 -r1.8
--- trouble.texi        5 May 2009 01:17:23 -0000       1.7
+++ trouble.texi        12 May 2009 02:05:56 -0000      1.8
@@ -30,7 +30,9 @@
 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.
address@hidden C-x u
address@hidden C-/
address@hidden C-x u
address@hidden C-_
 Cancel a previously made change in the buffer contents (@code{undo}).
 @end table
 
@@ -126,10 +128,10 @@
 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 @@
 @cindex @key{BACKSPACE} vs @key{DEL}
 @cindex usual erasure key
 
-  Every keyboard has a large key, a little ways above the @key{RET} or
address@hidden 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
address@hidden and there is a @key{DELETE} key elsewhere, but the
address@hidden 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 @@
 @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
address@hidden act as @key{DEL} (resulting in behavior compatible
address@hidden act as @key{DEL} (resulting in behavior compatible
 with Emacs 20 and previous versions):
 
 @lisp
@@ -207,8 +204,7 @@
 @end lisp
 
 @noindent
-For the other two cases, where @key{BACKSPACE} ought to act as
address@hidden, use this line:
+For the other two cases, use this line:
 
 @lisp
 (normal-erase-is-backspace-mode 1)
@@ -221,15 +217,6 @@
 @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