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 11:15:11 -0700 Message-ID: References: <87wqk6e5zm.fsf@web.de> <87v9euwzbe.fsf@gnus.org> <87blglmjlc.fsf@web.de> <54a1c039-6929-4e4d-ac9b-e7e5daf37c68@default> <62b06d46-5371-4df7-a3c5-b53f84e728ef@default> 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="26894"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 15917@debbugs.gnu.org, Paul Smith To: Drew Adams , Michael Heerdegen , Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Oct 29 19:17:40 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 1kYCUV-0006sK-9J for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 29 Oct 2020 19:17:39 +0100 Original-Received: from localhost ([::1]:55272 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kYCUU-00071R-Bn for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 29 Oct 2020 14:17:38 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:51818) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kYCSw-0006F2-EF for bug-gnu-emacs@gnu.org; Thu, 29 Oct 2020 14:16:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:43383) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kYCSv-0003Ir-Rt for bug-gnu-emacs@gnu.org; Thu, 29 Oct 2020 14:16:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kYCSv-0003V3-My for bug-gnu-emacs@gnu.org; Thu, 29 Oct 2020 14:16: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 18:16: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.160399532013348 (code B ref 15917); Thu, 29 Oct 2020 18:16:01 +0000 Original-Received: (at 15917) by debbugs.gnu.org; 29 Oct 2020 18:15:20 +0000 Original-Received: from localhost ([127.0.0.1]:54916 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kYCSG-0003TE-EB for submit@debbugs.gnu.org; Thu, 29 Oct 2020 14:15:20 -0400 Original-Received: from mail-lj1-f181.google.com ([209.85.208.181]:36277) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kYCSE-0003Sw-9R for 15917@debbugs.gnu.org; Thu, 29 Oct 2020 14:15:18 -0400 Original-Received: by mail-lj1-f181.google.com with SMTP id x6so4158503ljd.3 for <15917@debbugs.gnu.org>; Thu, 29 Oct 2020 11:15:18 -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=0+DsUThTZfssbGbU9dp7t/Fo7uRuExH9XP9PB85zXLo=; b=KdIpcTNBVnWahFAXgvdBpyDhwKc8xbI0YTr95bWLM09Zy+XMavLqGjr5wHRe7r0ihZ 4YkeFoHNSh9QZd8z3OZNQONvz0Jc2XAxERuZtBrSkGOwVCDGB+MpkQ2rFFNTHipwBeo6 rvAwcM4YBGZ1YI1f8RBwLlxA3o5GEI2Sgy7xQfZ3YhDPqDsB9AdiLA66uM/u35lwb1ux 8ixibf0McKyJf4Qjjr9GuwFNOCu7kjejh2gXXWIdvXo0MKfqPGPFvjq8FOzi1ZftELRG GNhsjQjxgVdR+PBLRujMeDSEyv9NgbjO1T1dbgLdWAgI8P8lMwKI6jS0HbyyroUA4IDC dzyw== X-Gm-Message-State: AOAM533Mca9Tk/fbeNgp5zeWIYfGLG/NBQvmzg2HSRe3ESP4HL9DER0h LUeQYyqbjOxK76aLmHqsDmURnSHaLgMV044YDQQ= X-Google-Smtp-Source: ABdhPJzTKFhVgNcUjYF5qpzIH8VkohNaTTimP/44z08XDO9YSDtUBwgoKY/8+AGRUYNQ9io2rSKx842SN2brZgOgnPw= X-Received: by 2002:a05:651c:1311:: with SMTP id u17mr2482383lja.177.1603995312453; Thu, 29 Oct 2020 11:15:12 -0700 (PDT) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Thu, 29 Oct 2020 11:15:11 -0700 In-Reply-To: <62b06d46-5371-4df7-a3c5-b53f84e728ef@default> 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:191986 Archived-At: Drew Adams writes: >> >> +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. >> > >> > IMO that last part ("will never conflict") >> > sounds too automatic or passive. >> >> How about "should not conflict"? Otherwise, please propose an >> alternative. > > Better, yes. But that could mean that we expect that, > most of the time, they won't (automatically). I don't understand the second sentence. Could you please elaborate? > Active voice here removes such ambiguity, I think. > > Key sequences that consist of @kbd{C-c} followed by a > letter are reserved for users. Please do not write > code to be used by others that binds these keys. Such advice is already in the elisp manual. The user manual should rather advice users which keys are reserved for their use in their Init file. So I don't think writing about "code to be used for others" is suitable here. > (Why mention "upper or lower"? Why put "reserved for users" > in quotes?) We can probably remove that, yes.