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: Mon, 20 Apr 2015 13:16:20 -0700 (PDT) Message-ID: References: <<1429555155-4695-1-git-send-email-eggert@cs.ucla.edu>> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1429561043 1050 80.91.229.3 (20 Apr 2015 20:17:23 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 20 Apr 2015 20:17:23 +0000 (UTC) To: Paul Eggert , 20385@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Apr 20 22:17:10 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 1YkI7x-0007WP-B0 for geb-bug-gnu-emacs@m.gmane.org; Mon, 20 Apr 2015 22:17:09 +0200 Original-Received: from localhost ([::1]:55242 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YkI7w-0005ln-EV for geb-bug-gnu-emacs@m.gmane.org; Mon, 20 Apr 2015 16:17:08 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59398) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YkI7t-0005lf-9b for bug-gnu-emacs@gnu.org; Mon, 20 Apr 2015 16:17:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YkI7q-0006U3-DQ for bug-gnu-emacs@gnu.org; Mon, 20 Apr 2015 16:17:05 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:44118) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YkI7q-0006Ty-9q for bug-gnu-emacs@gnu.org; Mon, 20 Apr 2015 16:17:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1YkI7p-0000XX-MK for bug-gnu-emacs@gnu.org; Mon, 20 Apr 2015 16:17: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: Mon, 20 Apr 2015 20:17:01 +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.14295609982040 (code B ref 20385); Mon, 20 Apr 2015 20:17:01 +0000 Original-Received: (at 20385) by debbugs.gnu.org; 20 Apr 2015 20:16:38 +0000 Original-Received: from localhost ([127.0.0.1]:33894 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YkI7S-0000Wm-1T for submit@debbugs.gnu.org; Mon, 20 Apr 2015 16:16:38 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:26411) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YkI7O-0000QB-Uo for 20385@debbugs.gnu.org; Mon, 20 Apr 2015 16:16:35 -0400 Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t3KKGL2r001265 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Mon, 20 Apr 2015 20:16:22 GMT Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserv0022.oracle.com (8.13.8/8.13.8) with ESMTP id t3KKGLsx005884 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Mon, 20 Apr 2015 20:16:21 GMT Original-Received: from abhmp0019.oracle.com (abhmp0019.oracle.com [141.146.116.25]) by userv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t3KKGLlw010956; Mon, 20 Apr 2015 20:16:21 GMT In-Reply-To: <<1429555155-4695-1-git-send-email-eggert@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: aserv0022.oracle.com [141.146.126.234] 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:101782 Archived-At: > Emacs's traditional doc string style has been to quote symbols > `like this'. This worked well on older terminals where ` and ' > were symmetric quotes, And it has worked well in GUI Emacs as well. And it still does. And it supports simple highlighting, and simple searching, which are very helpful to users. This notation is not just some primitive, prehistoric way of setting off symbols and other code. It is a thoroughly modern way of doing that. Especially for a context that is plain text and that involves simple (and complex) editing operations. > but nowadays this quoting looks odd=20 No, it doesn't. It doesn't look more odd than it did pre-"nowadays". > and it's better to use apostrophe for single-quoted ASCII text. "It's better"? That's all you can say in support of this change? No reason given? Or was your "nowdays this quoting looks odd" to you the reason? If so, that's a feeble reason to lose helpful and simple highlighting, and to change a longstanding convention. > Add support for quoting either way, suggesting the newer style. > ... Quote symbols 'like-this' as well as `like-this'. > Recommend the former style. Please don't. Don't even add support for '...' quoting. It will just get in the way. Of users. Of tools.