From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: =?utf-8?Q?Mattias_Engdeg=C3=A5rd?= Newsgroups: gmane.emacs.devel Subject: Re: Backslash-escaped brackets in string literals Date: Sat, 25 Jan 2020 16:32:58 +0100 Message-ID: References: <64ECD2AB-962B-4781-BFBA-6357277C9599@acm.org> <83a76cq8u7.fsf@gnu.org> <83pnf7pso7.fsf@gnu.org> Mime-Version: 1.0 (Mac OS X Mail 12.4 \(3445.104.11\)) Content-Type: multipart/mixed; boundary="Apple-Mail=_43CF9891-4133-4DCC-BC40-1E771BF90C9B" Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="102980"; mail-complaints-to="usenet@ciao.gmane.io" Cc: monnier@iro.umontreal.ca, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Jan 25 16:33:39 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 1ivNRL-000Qki-29 for ged-emacs-devel@m.gmane-mx.org; Sat, 25 Jan 2020 16:33:39 +0100 Original-Received: from localhost ([::1]:54750 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ivNRK-00005e-5F for ged-emacs-devel@m.gmane-mx.org; Sat, 25 Jan 2020 10:33:38 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:39985) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ivNQo-00088D-Dn for emacs-devel@gnu.org; Sat, 25 Jan 2020 10:33:07 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ivNQn-0005AA-7Q for emacs-devel@gnu.org; Sat, 25 Jan 2020 10:33:06 -0500 Original-Received: from mail78c50.megamailservers.eu ([91.136.10.88]:60698 helo=mail70c50.megamailservers.eu) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1ivNQm-0004yx-J3; Sat, 25 Jan 2020 10:33:05 -0500 X-Authenticated-User: mattiase@bredband.net DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=megamailservers.eu; s=maildub; t=1579966381; bh=+X1C36wmIjU/oGZdUrw7/sNnGTIuDQeBX9/4fgv+1iE=; h=From:Subject:Date:In-Reply-To:Cc:To:References:From; b=LC1h57UvEdcm6AKVLIKMhyT4EGe1g6T5U38um+wvASxxKkk7GZIppikU2uiRQelgM 4MhNUgaheRwq93ftv+7pA+b5fGiIF56uTU1w1D8oRgSNk+t1t0r7irBBOyb8+ucJA1 z1ceTWnslsOocC0kt3UwITOm81ajH1pY4+fIZWTI= Feedback-ID: mattiase@acm.or Original-Received: from [192.168.0.4] (c188-150-171-71.bredband.comhem.se [188.150.171.71]) (authenticated bits=0) by mail70c50.megamailservers.eu (8.14.9/8.13.1) with ESMTP id 00PFWwZn006755; Sat, 25 Jan 2020 15:33:00 +0000 In-Reply-To: <83pnf7pso7.fsf@gnu.org> X-Mailer: Apple Mail (2.3445.104.11) X-CTCH-RefID: str=0001.0A0B0209.5E2C5FAD.0021, ss=1, re=0.000, recu=0.000, reip=0.000, cl=1, cld=1, fgs=0 X-CTCH-VOD: Unknown X-CTCH-Spam: Unknown X-CTCH-Score: 0.000 X-CTCH-Flags: 0 X-CTCH-ScoreCust: 0.000 X-CSC: 0 X-CHA: v=2.3 cv=c6bVvi1l c=1 sm=1 tr=0 a=SF+I6pRkHZhrawxbOkkvaA==:117 a=SF+I6pRkHZhrawxbOkkvaA==:17 a=jpOVt7BSZ2e4Z31A5e1TngXxSK0=:19 a=M51BFTxLslgA:10 a=mDV3o1hIAAAA:8 a=zAXH9QTh4791VKdUbhgA:9 a=CjuIK1q_8ugA:10 a=EU61iqk-zV7ipYof6aoA:9 a=B2y7HmGcmWMA:10 a=_FVE-zBwftR9WsbkzFJk:22 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x (no timestamps) [generic] X-Received-From: 91.136.10.88 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:244627 Archived-At: --Apple-Mail=_43CF9891-4133-4DCC-BC40-1E771BF90C9B Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=us-ascii 25 jan. 2020 kl. 14.33 skrev Eli Zaretskii : > In case it matters, I did that in Emacs 26.3. Thank you, that explains it --- it appears fixed in Emacs 27 = (57e2ca5c50, probably), which is why I didn't observe the glitch. Good news, of course, and regarding your comment about using older = versions, I can confirm that no \ at bol was removed in my latest = clean-up. However, 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? --Apple-Mail=_43CF9891-4133-4DCC-BC40-1E771BF90C9B Content-Disposition: attachment; filename=0001-Stop-recommending-to-be-escaped-in-doc-strings.patch Content-Type: application/octet-stream; x-unix-mode=0644; name="0001-Stop-recommending-to-be-escaped-in-doc-strings.patch" Content-Transfer-Encoding: quoted-printable =46rom=2067ac7feda9031e263cd5f6ef7445287ffdd30f45=20Mon=20Sep=2017=20= 00:00:00=202001=0AFrom:=20=3D?UTF-8?q?Mattias=3D20Engdeg=3DC3=3DA5rd?=3D=20= =0ADate:=20Sat,=2025=20Jan=202020=2016:16:37=20+0100=0A= Subject:=20[PATCH]=20Stop=20recommending=20'('=20to=20be=20escaped=20in=20= doc=20strings=0A=0AThanks=20to=2057e2ca5c50=20and=20related=20changes,=20= opening=20brackets=20at=20the=0Aleftmost=20column=20inside=20doc=20= strings=20are=20no=20longer=20mistaken=20for=20the=0Astart=20of=20a=20= defun.=0A=0A*=20doc/lispref/tips.texi=20(Documentation=20Tips):=20Remove=20= recommendation.=0A*=20etc/NEWS:=20Announce.=0A---=0A=20= doc/lispref/tips.texi=20|=2012=20------------=0A=20etc/NEWS=20=20=20=20=20= =20=20=20=20=20=20=20=20=20|=20=203=20+++=0A=202=20files=20changed,=203=20= insertions(+),=2012=20deletions(-)=0A=0Adiff=20--git=20= a/doc/lispref/tips.texi=20b/doc/lispref/tips.texi=0Aindex=20= 4395069fe2..a7804ed3f3=20100644=0A---=20a/doc/lispref/tips.texi=0A+++=20= b/doc/lispref/tips.texi=0A@@=20-802,18=20+802,6=20@@=20Documentation=20= Tips=0A=20starting=20the=20sentence=20with=20lower-case=20``t'',=20which=20= could=20be=20somewhat=0A=20distracting.=0A=20=0A-@item=0A-If=20a=20line=20= in=20a=20documentation=20string=20begins=20with=20an=20open-parenthesis,=0A= -write=20a=20backslash=20before=20the=20open-parenthesis,=20like=20this:=0A= -=0A-@example=0A-The=20argument=20FOO=20can=20be=20either=20a=20number=0A= -\(a=20buffer=20position)=20or=20a=20string=20(a=20file=20name).=0A-@end=20= example=0A-=0A-This=20prevents=20the=20open-parenthesis=20from=20being=20= treated=20as=20the=20start=20of=20a=0A-defun=20(@pxref{Defuns,,=20= Defuns,=20emacs,=20The=20GNU=20Emacs=20Manual}).=0A-=0A=20@item=0A=20= Write=20documentation=20strings=20in=20the=20active=20voice,=20not=20the=20= passive,=20and=20in=0A=20the=20present=20tense,=20not=20the=20future.=20=20= For=20instance,=20use=20``Return=20a=20list=0Adiff=20--git=20a/etc/NEWS=20= b/etc/NEWS=0Aindex=20792851e5af..4c510668fb=20100644=0A---=20a/etc/NEWS=0A= +++=20b/etc/NEWS=0A@@=20-3338,6=20+3338,9=20@@=20versions.=0A=20= 'forward-comment',=20'scan-sexps',=20and=20'forward-sexp'=20when=20= parsing=20backward.=0A=20The=20new=20variable=20= 'comment-use-syntax-ppss'=20can=20be=20set=20to=20nil=20to=20recover=0A=20= the=20old=20behavior=20if=20needed.=0A+This=20also=20means=20that=20= there=20is=20no=20longer=20any=20need=20to=20precede=20opening=0A= +brackets=20at=20the=20start=20of=20a=20line=20inside=20documentation=20= strings=20with=20a=0A+backslash.=0A=20=0A=20---=0A=20**=20The=20= 'server-name'=20and=20'server-socket-dir'=20variables=20are=20set=20when=20= a=0A--=20=0A2.21.0=20(Apple=20Git-122.2)=0A=0A= --Apple-Mail=_43CF9891-4133-4DCC-BC40-1E771BF90C9B--