summaryrefslogtreecommitdiff
path: root/lispref/tips.texi
diff options
context:
space:
mode:
authorRichard M. Stallman <rms@gnu.org>2002-04-22 07:52:50 +0000
committerRichard M. Stallman <rms@gnu.org>2002-04-22 07:52:50 +0000
commit17d4b8cea3907ebd67b7575c8ccb58ef8f0c1d4e (patch)
tree07850f3e148ba2cb7cbd1039b9efe49a12730d8f /lispref/tips.texi
parent73e19344cec9b74c1f59e5fa44902804b397221a (diff)
downloademacs-17d4b8cea3907ebd67b7575c8ccb58ef8f0c1d4e.tar.gz
Clarify which letters in C-c LETTER are reserved for users.
Diffstat (limited to 'lispref/tips.texi')
-rw-r--r--lispref/tips.texi17
1 files changed, 9 insertions, 8 deletions
diff --git a/lispref/tips.texi b/lispref/tips.texi
index 2aead6be817..4eb0e3f7005 100644
--- a/lispref/tips.texi
+++ b/lispref/tips.texi
@@ -129,16 +129,17 @@ name that ends in @samp{-flag}.
@cindex reserved keys
@cindex keys, reserved
Please do not define @kbd{C-c @var{letter}} as a key in your major
-modes. These sequences are reserved for users; they are the
-@strong{only} sequences reserved for users, so do not block them.
+modes. Sequences consisting of @kbd{C-c} and a letter (either upper
+or lower case) are reserved for users; they are the @strong{only}
+sequences reserved for users, so do not block them.
-Instead, define sequences consisting of @kbd{C-c} followed by a control
-character, a digit, or certain punctuation characters. These sequences
-are reserved for major modes.
+Changing all the Emacs major modes to respect this convention was a
+lot of work; abandoning this convention would make that work go to
+waste, and inconvenience users. Please comply with it.
-Changing all the Emacs major modes to follow this convention was a lot
-of work. Abandoning this convention would make that work go to waste,
-and inconvenience users.
+@item
+Sequences consisting of @kbd{C-c} followed by a control character or a
+digit are reserved for major modes.
@item
Sequences consisting of @kbd{C-c} followed by @kbd{@{}, @kbd{@}},