From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#15917: 24.3.50; manual: mention keys reserved for users Date: Thu, 29 Oct 2020 11:28:56 -0700 (PDT) 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 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="4522"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 15917@debbugs.gnu.org, Paul Smith To: Stefan Kangas , 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:30:35 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 1kYCh0-00014s-I7 for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 29 Oct 2020 19:30:34 +0100 Original-Received: from localhost ([::1]:59384 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kYCgy-00010i-6c for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 29 Oct 2020 14:30:32 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:54780) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kYCgU-00010U-Pi for bug-gnu-emacs@gnu.org; Thu, 29 Oct 2020 14:30:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:43393) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kYCgU-0004tg-AU for bug-gnu-emacs@gnu.org; Thu, 29 Oct 2020 14:30:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kYCgU-0003rB-5m for bug-gnu-emacs@gnu.org; Thu, 29 Oct 2020 14:30:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 29 Oct 2020 18:30:02 +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.160399615214739 (code B ref 15917); Thu, 29 Oct 2020 18:30:02 +0000 Original-Received: (at 15917) by debbugs.gnu.org; 29 Oct 2020 18:29:12 +0000 Original-Received: from localhost ([127.0.0.1]:54939 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kYCff-0003pf-La for submit@debbugs.gnu.org; Thu, 29 Oct 2020 14:29:11 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:60100) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kYCfe-0003pS-1G for 15917@debbugs.gnu.org; Thu, 29 Oct 2020 14:29:10 -0400 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 09TI9EaV016952; Thu, 29 Oct 2020 18:29:02 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2020-01-29; bh=BSdjjXJfOHNJB7OwAtIlgptvWhUZsG7vXl5YPWkttaU=; b=NPL+4dYnN/ozdY/c/YWfJCz9dX7I8KFLIGA1Qopf8EbLOzhWNgZVP4l/KsHBTplUzhSY xq19BHDXIB32P3IltPzUU2p9c+VPFeQIgX8jn1eMoz1WJio31AmmoQsOHCxi65lfP1+y uHcdGYKiJyHgYhKJ6ZvG8i/q3cf3arxYsof+NXBJqVOU05fwdr7bQ7vWJLMO0qoLRswF Ho7mEdY6fxP5hnE5c0lfT4pRTJ/TMAYXGUjRlTvxd29yK4JCd/sdNYctWJ9NkmyWOJUr 0wJL6t24sVa1uaA2/1sUCMBsbyMw0Tpd4hES7djYB7wBjH5QiXFbdvHTiLgkUj4giL5Z 0A== Original-Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70]) by aserp2120.oracle.com with ESMTP id 34cc7m6cn6-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Thu, 29 Oct 2020 18:29:01 +0000 Original-Received: from pps.filterd (aserp3020.oracle.com [127.0.0.1]) by aserp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 09TIADPq108664; Thu, 29 Oct 2020 18:29:01 GMT Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserp3020.oracle.com with ESMTP id 34cx60tvx7-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 29 Oct 2020 18:29:01 +0000 Original-Received: from abhmp0013.oracle.com (abhmp0013.oracle.com [141.146.116.19]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id 09TISvTf013224; Thu, 29 Oct 2020 18:28:58 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.5056.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9789 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 adultscore=0 mlxscore=0 mlxlogscore=999 suspectscore=0 bulkscore=0 malwarescore=0 spamscore=0 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2010290127 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9789 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 lowpriorityscore=0 adultscore=0 malwarescore=0 spamscore=0 clxscore=1015 mlxscore=0 suspectscore=0 priorityscore=1501 impostorscore=0 bulkscore=0 phishscore=0 mlxlogscore=999 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2010290127 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:191988 Archived-At: > >> 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). >=20 > I don't understand the second sentence. Could you please elaborate? "Should" has at least two meanings: (1) you should do something (like must but less strong) and (2) something probably will happen. #2 says that we expect that something will likely happen, but it doesn't say who makes it happen. It's passive. There's no telling someone that you want them to do something. It's just saying that something will likely happen (somehow). My suggestion is that we not allow such a reading. Remove such ambiguity. > > 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. >=20 > 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. Sorry, I thought this was for the Elisp manual, node `Coding Conventions'. If this is for the user manual, and it's only a message for users for their own use of keys, and not also users who provide default key bindings for others (e.g. in code they write), then my suggestion is to remove any such text, beyond saying that these keys are reserved for personal use (not just "users"). If you want to add (for some reason) that users can at least expect that code Emacs distributes won't bind such keys, that's OK too.