mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-02-16 13:11:14 -08:00
Code Issues Projects Releases Wiki Activity

Clarify which letters in C-c LETTER are reserved for users.

Browse source
This commit is contained in:
Richard M. Stallman 2002-04-22 07:52:50 +00:00
parent 73e19344ce
commit 17d4b8cea3
1 changed files with 9 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

17
lispref/tips.texi
View file

@ -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{@}},