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: Fri, 30 Oct 2020 12:29:46 -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="29421"; 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 Fri Oct 30 20:30:11 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 1kYa6E-0007Xt-VP for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 30 Oct 2020 20:30:11 +0100 Original-Received: from localhost ([::1]:46258 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kYa6E-0003hS-1C for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 30 Oct 2020 15:30:10 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:41614) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kYa67-0003h3-Ec for bug-gnu-emacs@gnu.org; Fri, 30 Oct 2020 15:30:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:48252) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kYa67-0000a1-1H for bug-gnu-emacs@gnu.org; Fri, 30 Oct 2020 15:30:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kYa66-0005IW-Sl for bug-gnu-emacs@gnu.org; Fri, 30 Oct 2020 15: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: Fri, 30 Oct 2020 19: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.160408620020334 (code B ref 15917); Fri, 30 Oct 2020 19:30:02 +0000 Original-Received: (at 15917) by debbugs.gnu.org; 30 Oct 2020 19:30:00 +0000 Original-Received: from localhost ([127.0.0.1]:59798 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kYa64-0005Hu-EI for submit@debbugs.gnu.org; Fri, 30 Oct 2020 15:30:00 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:32956) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kYa62-0005Hi-SD for 15917@debbugs.gnu.org; Fri, 30 Oct 2020 15:29:59 -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 09UJTPvX044865; Fri, 30 Oct 2020 19:29:52 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=c5PX0G2/+Yc93RV0lVSFraptuqUtCnN1zrVWNvju/6Y=; b=csQ4PuN18IuN6CcKlbtACtLzv/28XGPoXSiOW67ONqC4lUIu7IZwY8dYYYq4KaVk5Y1u 8v0VWhjRbhpk9uJxEc8KzI7eNP13l66szDQZPSWtbQ4XXkRN7dAYwCs9xcTwOtMaQ8Cn BlSX9G0WtwUKeM2wNRVqU46bjhJmImSfEGy/qGGyVYlC+QbYR45UO7zI61jZf6sOsCGE Q2vjrgQb+JdOuD+s3JL+FB2VzHNIpYs825gb4QDHyXgPySdLnolUFtQTi3wv4z+HM8qr CUzStuoMlCfHIn71PHJWibEOjD220xFRpd3KG2yeAGHG8cQ/n/tOmhv0DjIJnLu7O4pG /g== Original-Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by aserp2120.oracle.com with ESMTP id 34cc7mbc6j-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Fri, 30 Oct 2020 19:29:52 +0000 Original-Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 09UJKSNM147205; Fri, 30 Oct 2020 19:29:51 GMT Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by userp3020.oracle.com with ESMTP id 34cx1utx5a-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 30 Oct 2020 19:29:51 +0000 Original-Received: from abhmp0020.oracle.com (abhmp0020.oracle.com [141.146.116.26]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id 09UJTmgW019097; Fri, 30 Oct 2020 19:29:48 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=9790 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 phishscore=0 bulkscore=0 suspectscore=0 malwarescore=0 mlxlogscore=999 mlxscore=0 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2010300141 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9790 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-2010300142 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:192184 Archived-At: > > "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. >=20 > OK. How do you propose to do that? >=20 > The full text would be: >=20 > +Key sequences that consist of @kbd{C-c} followed by a letter (upper o= r > +lower case) are ``reserved for users,'' and should not conflict with > +any properly designed Emacs extension or Emacs itself. >=20 > To me, it seems clear that the agent in this case would be either the > Emacs developers or the package developers. The active voice can make things clearer here. Say that this is by GNU convention. And say that if code follows the convention then the keys are free for personal use. It's about personal use, not just use "by users". Many users provide Elisp code for use by others. GNU convention stipulates that key sequences that consist of C-c followed by a letter are reserved for users. Emacs Lisp code that follows the convention does not bind these keys, so that they are free for personal use. What constitutes "a letter" here, I leave up to others.