From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#15917: 24.3.50; manual: mention keys reserved for users Date: Thu, 29 Oct 2020 15:22:57 +0000 Message-ID: References: <87wqk6e5zm.fsf@web.de> <87v9euwzbe.fsf@gnus.org> <87blglmjlc.fsf@web.de> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="35372"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 15917@debbugs.gnu.org, Paul Smith To: Michael Heerdegen , Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Oct 29 16:24:27 2020 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1kY9mt-00095O-8w for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 29 Oct 2020 16:24:27 +0100 Original-Received: from localhost ([::1]:46280 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kY9ms-0007nK-Ad for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 29 Oct 2020 11:24:26 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:38382) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kY9mU-0007mv-0b for bug-gnu-emacs@gnu.org; Thu, 29 Oct 2020 11:24:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:43101) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kY9mT-0005Fx-MD for bug-gnu-emacs@gnu.org; Thu, 29 Oct 2020 11:24:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kY9mT-0007a2-HR for bug-gnu-emacs@gnu.org; Thu, 29 Oct 2020 11:24:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 29 Oct 2020 15:24:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 15917 X-GNU-PR-Package: emacs Original-Received: via spool by 15917-submit@debbugs.gnu.org id=B15917.160398498529070 (code B ref 15917); Thu, 29 Oct 2020 15:24:01 +0000 Original-Received: (at 15917) by debbugs.gnu.org; 29 Oct 2020 15:23:05 +0000 Original-Received: from localhost ([127.0.0.1]:54647 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kY9lZ-0007Yo-KR for submit@debbugs.gnu.org; Thu, 29 Oct 2020 11:23:05 -0400 Original-Received: from mail-ej1-f49.google.com ([209.85.218.49]:34325) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kY9lY-0007Xt-Bj for 15917@debbugs.gnu.org; Thu, 29 Oct 2020 11:23:04 -0400 Original-Received: by mail-ej1-f49.google.com with SMTP id o9so2288925ejg.1 for <15917@debbugs.gnu.org>; Thu, 29 Oct 2020 08:23:04 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:in-reply-to:references:mime-version:date :message-id:subject:to:cc; bh=szUNh9fKcXhkekTVu6n9zj9nQUogUc1d7GjVN3SblSQ=; b=IuiDiEps9wVZg3/qCMNSg63CZ+HGy60xIfK/VJo9LMcPyG7fBoxlFf0eKtaYN8jI79 zbnbAiG2HGZwCmtQXYtJ6wfqm0o8twdF5C0RHXw2s6dpW9zopcrqpro8oWTourLytu1z rFJ9YN2xu5B6Or+ADy+xTJbp1DcrNcLvo1OdSYPehcEcodeYAAk0F2mIYvh10gdQFMXo tdN8r/QEs+bm5jaIdGT/WznCxiROQRG/kDfZfrTCwMrtP71JynkVkf9U08yuSRaXB8gX pWjgYgCjGD5uHpaTid4z4173SKrrSKZmHm5tlm/SCYjfLwsNdaf0ZyAVP6haaOvdqWHA ESzw== X-Gm-Message-State: AOAM532nWJCFXE+txO298ka5FttST7zINKtz3241cSwBpNYOu++cbd9B SOVSGqW/N9oNyi9KZSGNzA3pBIUKuSFxqBMyPBU= X-Google-Smtp-Source: ABdhPJySd6f5vXDQN4NbpQ23msZc/3T7alefTHA4/tRyaXZmr/bJs5n1EzC05f6NG8SehtID8APvUSITc7kQ2stFkwE= X-Received: by 2002:a17:906:3ed0:: with SMTP id d16mr4721059ejj.477.1603984978689; Thu, 29 Oct 2020 08:22:58 -0700 (PDT) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Thu, 29 Oct 2020 15:22:57 +0000 In-Reply-To: <87blglmjlc.fsf@web.de> X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:191965 Archived-At: Michael Heerdegen writes: >> But I think the text should mention that C-c LETTER is strictly >> reserved for users and will never be bound by Emacs itself. > > Sounds good, from my side. How about the following? diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi index 81874a04aa..d993b652f5 100644 --- a/doc/emacs/custom.texi +++ b/doc/emacs/custom.texi @@ -1582,6 +1582,10 @@ Keymaps type properly, it automatically handles such sequences as single input events. +Key sequences that consist of @kbd{C-c} followed by a letter (upper or +lower case) are ``reserved for users,'' and will never conflict with +any properly designed Emacs extension or Emacs itself. + @node Prefix Keymaps @subsection Prefix Keymaps