From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Paul Eggert Newsgroups: gmane.emacs.bugs Subject: bug#20385: [PROPOSED PATCH] Support quoting 'like this' in doc strings Date: Thu, 23 Apr 2015 12:38:22 -0700 Organization: UCLA Computer Science Department Message-ID: <55394A2E.8020002@cs.ucla.edu> 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> <87a8xzae0o.fsf@petton.fr> <55389500.8000404@cs.ucla.edu> <878udj9pfq.fsf@petton.fr> <5538C7EC.9010105@cs.ucla.edu> <877ft39juq.fsf@petton.fr> <55392C91.1010300@cs.ucla.edu> <84f4aea9-c3ef-44c5-ac06-0df72d223e8c@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1429817965 14495 80.91.229.3 (23 Apr 2015 19:39:25 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 23 Apr 2015 19:39:25 +0000 (UTC) Cc: 20385@debbugs.gnu.org To: Drew Adams , Nicolas Petton Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Apr 23 21:39: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 1YlMxq-0006Ts-7B for geb-bug-gnu-emacs@m.gmane.org; Thu, 23 Apr 2015 21:39:10 +0200 Original-Received: from localhost ([::1]:41794 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YlMxp-0001qJ-F4 for geb-bug-gnu-emacs@m.gmane.org; Thu, 23 Apr 2015 15:39:09 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:47976) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YlMxm-0001qE-8b for bug-gnu-emacs@gnu.org; Thu, 23 Apr 2015 15:39:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YlMxj-00045g-1c for bug-gnu-emacs@gnu.org; Thu, 23 Apr 2015 15:39:06 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:48253) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YlMxi-00045c-Uo for bug-gnu-emacs@gnu.org; Thu, 23 Apr 2015 15:39:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1YlMxi-0004Wc-AB for bug-gnu-emacs@gnu.org; Thu, 23 Apr 2015 15:39:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Paul Eggert Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 23 Apr 2015 19:39:02 +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.142981791217354 (code B ref 20385); Thu, 23 Apr 2015 19:39:02 +0000 Original-Received: (at 20385) by debbugs.gnu.org; 23 Apr 2015 19:38:32 +0000 Original-Received: from localhost ([127.0.0.1]:38029 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YlMxD-0004Vp-KP for submit@debbugs.gnu.org; Thu, 23 Apr 2015 15:38:31 -0400 Original-Received: from smtp.cs.ucla.edu ([131.179.128.62]:35744) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YlMxB-0004Vd-Um for 20385@debbugs.gnu.org; Thu, 23 Apr 2015 15:38:30 -0400 Original-Received: from localhost (localhost.localdomain [127.0.0.1]) by smtp.cs.ucla.edu (Postfix) with ESMTP id BB41EA6000F; Thu, 23 Apr 2015 12:38:23 -0700 (PDT) X-Virus-Scanned: amavisd-new at smtp.cs.ucla.edu Original-Received: from smtp.cs.ucla.edu ([127.0.0.1]) by localhost (smtp.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 6FIjGjNm7YIv; Thu, 23 Apr 2015 12:38:23 -0700 (PDT) Original-Received: from Penguin.CS.UCLA.EDU (Penguin.CS.UCLA.EDU [131.179.64.200]) by smtp.cs.ucla.edu (Postfix) with ESMTPSA id F34AFA60002; Thu, 23 Apr 2015 12:38:22 -0700 (PDT) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.6.0 In-Reply-To: <84f4aea9-c3ef-44c5-ac06-0df72d223e8c@default> 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:101947 Archived-At: On 04/23/2015 11:23 AM, Drew Adams wrote: > 1. What exactly do you mean by "people who prefer...will still be free > to do that"? Is this choice only at the end-user level? Can a > library make such a choice (to be possibly overridden by a user choice)? I mean that Lisp code can use either style in its doc strings, and Emacs will work either way. End users will see what's in the doc string; I'm not proposing any on-the-fly reformatting (other than what's already there, for limited old displays), as I doubt whether the extra complexity would be worth the hassle in the long run. > 2. Does your proposed change affect only Info? The proposed change doesn't affect info. Info files in the Emacs distribution already use curved single quotes. Texinfo files will continue to use quotes `like this', to indicate curved single quotes in Emacs's info files. Similarly, quoting ``like this'' in a Texinfo file will continue to generate curved double quotes in Emacs's info files. > users should have the same experience wrt such > code quoting for Info, doc strings, and Emacs-Lisp (doc strings and > comments). Yes, that's the longer term proposal for Emacs's files, using curved single quotes. The current patch is one step in that direction. Under this approach, users who prefer to quote `like this' will still be able to do that in their own doc strings and manuals.