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 10:58:27 -0700 (PDT) Message-ID: <62b06d46-5371-4df7-a3c5-b53f84e728ef@default> References: <87wqk6e5zm.fsf@web.de> <87v9euwzbe.fsf@gnus.org> <87blglmjlc.fsf@web.de> <54a1c039-6929-4e4d-ac9b-e7e5daf37c68@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="27101"; 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 18:59:29 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 1kYCCt-0006uz-Di for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 29 Oct 2020 18:59:27 +0100 Original-Received: from localhost ([::1]:33748 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kYCCr-0005hI-VI for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 29 Oct 2020 13:59:25 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:46754) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kYCCU-0005h8-DH for bug-gnu-emacs@gnu.org; Thu, 29 Oct 2020 13:59:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:43360) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kYCCT-0000dY-Uu for bug-gnu-emacs@gnu.org; Thu, 29 Oct 2020 13:59:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kYCCT-000346-TZ for bug-gnu-emacs@gnu.org; Thu, 29 Oct 2020 13:59:01 -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 17:59: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.160399432011755 (code B ref 15917); Thu, 29 Oct 2020 17:59:01 +0000 Original-Received: (at 15917) by debbugs.gnu.org; 29 Oct 2020 17:58:40 +0000 Original-Received: from localhost ([127.0.0.1]:54906 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kYCC7-00033X-K5 for submit@debbugs.gnu.org; Thu, 29 Oct 2020 13:58:39 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:34748) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kYCC6-00033K-Aw for 15917@debbugs.gnu.org; Thu, 29 Oct 2020 13:58:38 -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 09THtQ0i182141; Thu, 29 Oct 2020 17:58:32 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=YgpsKpxqInzhp3x5jvfAgnlBI6nDFINKxyvogt+CEQk=; b=Y8eqvkuf6ZG5BAJ5yaS5qmbUtNAtyzrsRlCw0NtM8q02ygJA/wLJjq7kt5RpX6WkVD40 Yqu1xnBz0A0whyIwY9Anavw7jVSIFbDy+S2Zebj6rX4Lwc0Yhc7l82pOPDi5NZYqnd9X XjuIIvDP3bTB33SnW6ShDshoGIeaejyr9DczqolYty0a/7cYEaofkmgx7jCXbVJLx33c SMTAV7zMyuk5YL2DkM3OHf2aKVOmJCA6O8AsHbnI5DU11sUJW/dhKL5DhLHf5dCinGyQ Ag1oV5YBZwfQRwuMYd50Ug7lXwBd9HkLITgSW2tPkh/7RHcV6sbkuprl6Lpu2bixnOoo xw== Original-Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by aserp2120.oracle.com with ESMTP id 34cc7m68c5-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Thu, 29 Oct 2020 17:58:32 +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 09THuP9W020464; Thu, 29 Oct 2020 17:58:31 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userp3020.oracle.com with ESMTP id 34cx1tgy94-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 29 Oct 2020 17:58:31 +0000 Original-Received: from abhmp0013.oracle.com (abhmp0013.oracle.com [141.146.116.19]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id 09THwSea000994; Thu, 29 Oct 2020 17:58:30 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 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-2010290125 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-2010290125 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:191981 Archived-At: > >> +Key sequences that consist of @kbd{C-c} followed by a letter (upper o= r > >> +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. >=20 > 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). 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. (Why mention "upper or lower"? Why put "reserved for users" in quotes?)