From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: Backslash-escaped brackets in string literals Date: Sat, 25 Jan 2020 09:16:13 -0800 (PST) Message-ID: <22215450-ffbb-4188-a3c1-3cf0e74a6acd@default> References: <64ECD2AB-962B-4781-BFBA-6357277C9599@acm.org> <83a76cq8u7.fsf@gnu.org> <83pnf7pso7.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="41730"; mail-complaints-to="usenet@ciao.gmane.io" Cc: monnier@iro.umontreal.ca, emacs-devel@gnu.org To: =?iso-8859-1?B?TWF0dGlhcyBFbmdkZWflcmQ=?= , Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Jan 25 18:17:32 2020 Return-path: Envelope-to: ged-emacs-devel@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 1ivP3r-000ApR-Oi for ged-emacs-devel@m.gmane-mx.org; Sat, 25 Jan 2020 18:17:31 +0100 Original-Received: from localhost ([::1]:55606 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ivP3q-0004Sw-Q2 for ged-emacs-devel@m.gmane-mx.org; Sat, 25 Jan 2020 12:17:30 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:36137) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ivP2p-0003d4-MZ for emacs-devel@gnu.org; Sat, 25 Jan 2020 12:16:28 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ivP2o-0004Km-Br for emacs-devel@gnu.org; Sat, 25 Jan 2020 12:16:27 -0500 Original-Received: from userp2120.oracle.com ([156.151.31.85]:55560) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1ivP2k-0004Hy-At; Sat, 25 Jan 2020 12:16:22 -0500 Original-Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id 00PHDfeb158601; Sat, 25 Jan 2020 17:16:18 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-2019-08-05; bh=1T7luFhNOwB28lq0rYzW5NgaaWxOvOav91t7+KPjjVA=; b=MIRJzAN25fCb6HYFKKuCkypF+6MIXAAOCTZslWhb/EWP1g3/QwxYbP+L8AMpfmIzMNEB 7zwrG8UoeZhxNPhydSEmzWykv7YdQ2+I3KTspnaWW5+WsevFkhedsvzQ/R1qlmpmmHCC OhGku/YSa1At2gHXEqoNbWOFg76/zTNTd6qmnFiw1yfgiESqjxrtKXcudWB9E47p27xU ebBwrGCER8K0Rx2NcLHbmx8MwNwl/ejeNqpVTlHa8tEaqJG59u+9/ECszWvVcgoDELYA NShcvgIi5lgJ9hckT9g8cAU7r4VNaI3cLIXGxGzRjelvLBuXSe+fx9NqGc5X565X7HdO zw== Original-Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by userp2120.oracle.com with ESMTP id 2xreaqscck-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 25 Jan 2020 17:16:18 +0000 Original-Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.0.27/8.16.0.27) with SMTP id 00PHD4Io081912; Sat, 25 Jan 2020 17:16:17 GMT Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userp3030.oracle.com with ESMTP id 2xratbxbyw-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 25 Jan 2020 17:16:17 +0000 Original-Received: from abhmp0015.oracle.com (abhmp0015.oracle.com [141.146.116.21]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id 00PHGESK013561; Sat, 25 Jan 2020 17:16:15 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4954.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9511 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=975 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1911140001 definitions=main-2001250146 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9511 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1911140001 definitions=main-2001250146 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] X-Received-From: 156.151.31.85 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:244632 Archived-At: > I think the manual should be amended at this point, and that > we needn't require new doc strings to escape brackets in the leftmost ^^^^^^^^^^^^^^^^^^ > column. Would this patch be acceptable for emacs-27? "We need not" doesn't mean that no users of Elisp need to use such escaping. This messaging/doc is for everyone, not just the developers who provide the code that GNU Emacs distributes as part of Emacs. And no user has ever been "required" to use such escaping. Let's keep the target audience in mind: general Elisp users. I think it's misleading and narrow to say "there is no longer any need" for such escaping. There can be such a need, if you're writing code intended for more than just Emacs 27 and later. 3rd-party code is sometimes intended for multiple releases. In fact, it's probable that only a tiny minority of Emacs users use the latest release, and only the latest release. It would be better to point out clearly that: 1. It never _hurts_ to provide such escaping. 2. Such escaping is appropriate for backward compatibility. It presents no advantage for Emacs 27+, but it's helpful for older releases.