From: Richard M. Stallman <rms@gnu.org>
Date: Sun, 22 Apr 2001 14:55:21 +0000 (+0000)
Subject: Explain binding TAB etc using \t etc.
X-Git-Tag: emacs-pretest-21.0.103~153
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=03d4836128deca9580a61c4e9d29b8231b01f67d;p=emacs.git

Explain binding TAB etc using \t etc.
Minor clarifications.
---

diff --git a/man/custom.texi b/man/custom.texi
index b481fdb122a..286d5e9d5cf 100644
--- a/man/custom.texi
+++ b/man/custom.texi
@@ -1304,11 +1304,11 @@ sequence, and so on.
 @kbd{C-x @key{SELECT}} is meaningful.  If you make @key{SELECT} a prefix
 key, then @kbd{@key{SELECT} C-n} makes sense.  You can even mix mouse
 events with keyboard events, but we recommend against it, because such
-sequences are inconvenient to type in.
+key sequences are inconvenient to use.
 
-  As a user, you can redefine any key; but it might be best to stick to
-key sequences that consist of @kbd{C-c} followed by a letter.  These
-keys are ``reserved for users,'' so they won't conflict with any
+  As a user, you can redefine any key; but it is usually best to stick
+to key sequences that consist of @kbd{C-c} followed by a letter.
+These keys are ``reserved for users,'' so they won't conflict with any
 properly designed Emacs extension.  The function keys @key{F5} through
 @key{F9} are also reserved for users.  If you redefine some other key,
 your definition may be overridden by certain extensions or major modes
@@ -1572,6 +1572,15 @@ probably causes an error; it certainly isn't what you want.
 
 @example
 (global-set-key "\C-xl" 'make-symbolic-link)
+@end example
+
+  To put @key{TAB}, @key{RET}, @key{ESC}, or @key{DEL} in the
+string, you can use the Emacs Lisp escape sequences, @samp{\t},
+@samp{\r}, @samp{\e}, and @samp{\d}.  Here is an example which binds
+@kbd{C-x @key{TAB}}:
+
+@example
+(global-set-key "\C-x\t" 'indent-rigidly)
 @end example
 
   When the key sequence includes function keys or mouse button events,
@@ -1599,12 +1608,14 @@ keyboard-modified mouse button):
 @end example
 
   You can use a vector for the simple cases too.  Here's how to rewrite
-the first two examples, above, to use vectors:
+the first three examples, above, using vectors:
 
 @example
 (global-set-key [?\C-z] 'shell)
 
 (global-set-key [?\C-x ?l] 'make-symbolic-link)
+
+(global-set-key [?\C-x ?\t] 'indent-rigidly)
 @end example
 
 @node Function Keys