From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#20385: [PROPOSED PATCH] Support quoting 'like this' in doc strings Date: Wed, 22 Apr 2015 19:19:15 -0700 (PDT) Message-ID: References: <1429555155-4695-1-git-send-email-eggert@cs.ucla.edu> <5535974D.9050207@cs.ucla.edu> <5535C7F3.7020107@cs.ucla.edu> <83618p5y9w.fsf@gnu.org> <83vbgp49ve.fsf@gnu.org> <83pp6x45x5.fsf@gnu.org> <5536ACB3.9040707@yandex.ru> <83lhhk4phe.fsf@gnu.org> <87a8y0jmba.fsf@petton.fr> <6837d058-ba18-461b-8af6-2c4e6d767348@default> <55383081.4010106@cs.ucla.edu> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1429755627 3215 80.91.229.3 (23 Apr 2015 02:20:27 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 23 Apr 2015 02:20:27 +0000 (UTC) Cc: 20385@debbugs.gnu.org, Dmitry Gutov To: Paul Eggert , Nicolas Petton Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Apr 23 04:20:14 2015 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Yl6kP-0003UD-5h for geb-bug-gnu-emacs@m.gmane.org; Thu, 23 Apr 2015 04:20:13 +0200 Original-Received: from localhost ([::1]:37751 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Yl6kO-0004MC-GO for geb-bug-gnu-emacs@m.gmane.org; Wed, 22 Apr 2015 22:20:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:37079) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Yl6kK-0004Ko-7h for bug-gnu-emacs@gnu.org; Wed, 22 Apr 2015 22:20:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Yl6kH-0003c3-0P for bug-gnu-emacs@gnu.org; Wed, 22 Apr 2015 22:20:08 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:47180) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Yl6kG-0003aF-TV for bug-gnu-emacs@gnu.org; Wed, 22 Apr 2015 22:20:04 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1Yl6kG-0002LH-88 for bug-gnu-emacs@gnu.org; Wed, 22 Apr 2015 22:20:04 -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, 23 Apr 2015 02:20:04 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 20385 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 20385-submit@debbugs.gnu.org id=B20385.14297555678955 (code B ref 20385); Thu, 23 Apr 2015 02:20:04 +0000 Original-Received: (at 20385) by debbugs.gnu.org; 23 Apr 2015 02:19:27 +0000 Original-Received: from localhost ([127.0.0.1]:36956 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Yl6je-0002KM-Pw for submit@debbugs.gnu.org; Wed, 22 Apr 2015 22:19:27 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:46721) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Yl6jc-0002K8-Hj for 20385@debbugs.gnu.org; Wed, 22 Apr 2015 22:19:25 -0400 Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t3N2JH0U021700 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 23 Apr 2015 02:19:17 GMT Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserv0021.oracle.com (8.13.8/8.13.8) with ESMTP id t3N2JGbZ023286 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Thu, 23 Apr 2015 02:19:16 GMT Original-Received: from abhmp0017.oracle.com (abhmp0017.oracle.com [141.146.116.23]) by aserv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t3N2JG9u030177; Thu, 23 Apr 2015 02:19:16 GMT In-Reply-To: <55383081.4010106@cs.ucla.edu> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: aserv0021.oracle.com [141.146.126.233] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.43 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.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:101898 Archived-At: > > If Emacs at some point decides to switch to another code-quoting > > mechanism, that's one thing. But what it definitely should NOT > > do, IMO, is to lose code quoting >=20 > Yes, that makes sense. The latest iteration of the proposal does > that, by suggesting that doc strings use curved single quotes > =E2=80=98like-this=E2=80=99 to quote code. This mechanism is already use= d in the > Emacs 24.5 info files, and it works well there. Huh? You say that you agree, that what I say makes sense. And then you say that =E2=80=98...=E2=80=99 is a solution! That's precisely what I'= m saying does *not* work. If you paste that into any context where curly quoting is used for ordinary text (which - nowadays, as you would say - means most ordinary-text contexts) then you lose the special quoting of code. Whether curly quotes are single or double is irrelevant: both are used in ordinary situations to quote ordinary text. Neither is something special for quoting code. See http://en.wikipedia.org/wiki/Quotation_mark. Note, in particular (in case this was something you were confused about), that British and American usages tends to be reversed wrt which curly quotes, single or double, are used at the first level: In American English, double quotes are used normally (the "primary" style). If quote marks are used inside another pair of quote marks, then single quotes are used as the "secondary" style. For example: "Didn't she say 'I like red best' when asked her favorite wine?" he wondered to himself. If another set of quotes is nested, double quotes are used again, and they continue to alternate as necessary (though this is rarely done). British English tends to have the opposite convention =E2=80=93 single quotes are primary, and double quotes are secondary. Different varieties of English have different rules regarding whether neighboring punctuation should be written inside or outside the quotation marks.