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: [PATCH] Support curved quotes in doc strings Date: Fri, 15 May 2015 11:54:33 -0700 Organization: UCLA Computer Science Department Message-ID: <555640E9.4060203@cs.ucla.edu> References: <1429555155-4695-1-git-send-email-eggert@cs.ucla.edu> <5552FDAC.4080004@cs.ucla.edu> <55534080.6010400@yandex.ru> <555369FD.30701@cs.ucla.edu> <5553D12F.7000809@yandex.ru> <5554155E.70000@cs.ucla.edu> <55547DC6.3090509@yandex.ru> <5555A4ED.8090500@cs.ucla.edu> <55562BB0.2010605@yandex.ru> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 8bit X-Trace: ger.gmane.org 1431716124 6038 80.91.229.3 (15 May 2015 18:55:24 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 15 May 2015 18:55:24 +0000 (UTC) To: Dmitry Gutov , 20385@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri May 15 20:55: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 1YtKlN-0004Zb-3R for geb-bug-gnu-emacs@m.gmane.org; Fri, 15 May 2015 20:55:13 +0200 Original-Received: from localhost ([::1]:32769 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YtKlM-0002Uv-Jo for geb-bug-gnu-emacs@m.gmane.org; Fri, 15 May 2015 14:55:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:34001) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YtKlI-0002UZ-Oz for bug-gnu-emacs@gnu.org; Fri, 15 May 2015 14:55:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YtKlD-0004MA-Nd for bug-gnu-emacs@gnu.org; Fri, 15 May 2015 14:55:08 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:36486) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YtKlD-0004LQ-KH for bug-gnu-emacs@gnu.org; Fri, 15 May 2015 14:55:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1YtKlC-00061n-Ve for bug-gnu-emacs@gnu.org; Fri, 15 May 2015 14:55:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Paul Eggert Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 15 May 2015 18:55: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.143171608723144 (code B ref 20385); Fri, 15 May 2015 18:55:02 +0000 Original-Received: (at 20385) by debbugs.gnu.org; 15 May 2015 18:54:47 +0000 Original-Received: from localhost ([127.0.0.1]:46461 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YtKkw-00061D-7f for submit@debbugs.gnu.org; Fri, 15 May 2015 14:54:46 -0400 Original-Received: from smtp.cs.ucla.edu ([131.179.128.62]:51332) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YtKkt-00060x-01 for 20385@debbugs.gnu.org; Fri, 15 May 2015 14:54:43 -0400 Original-Received: from localhost (localhost.localdomain [127.0.0.1]) by smtp.cs.ucla.edu (Postfix) with ESMTP id AF0DD39E8019; Fri, 15 May 2015 11:54:36 -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 3DrMxDMkiMAi; Fri, 15 May 2015 11:54:36 -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 642E139E8014; Fri, 15 May 2015 11:54:36 -0700 (PDT) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.6.0 In-Reply-To: <55562BB0.2010605@yandex.ru> 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:102838 Archived-At: On 05/15/2015 10:24 AM, Dmitry Gutov wrote: > It still doesn't have the fancy quotes directly in the source code: > they seem to be generated dynamically Yes, GCC uses "%< %>" in format strings to represent curved quotes, and Coreutils has a function 'quote (X)' that returns X surrounded by curved quotes. However, these are both awkward compared to just using quotes. GCC and Coreutils use these awkward constructs because they can't assume decent support for Unicode. Emacs doesn't have this constraint, so it can do better. > On the other hand, you'll be able to dynamically determine which > quotes to use, depending e.g. on the locale. That's an independent issue: it can be done no matter what quoting regime the source code uses. But it's probably not worth doing separately. Once we're worried about different locales, we'll need to translate the strings to Russian (or whatever) and at that point we can translate the quotes to use «Russian style». (And yes, Emacs should do this, just as GCC and Coreutils do -- but one thing at a time.) > Neither of those should be particularly hard to implement. I'm not that worried about the cost of implementation now. I'm worried about the long-term cost of having a quoting regime that requires documentation and explanation. It's simpler and easier to explain if the doc string looks the same in the UI as it does while you're editing it. For example, you can easily cut and paste from the UI into the doc string source when composing a new doc string, which is something that doesn't work well for either GCC or Coreutils. > - Using unicode for markup is a complication (e.g. with certain mail > clients, but some other instances might come up). It's a complication we already have, as we already use UTF-8 in a few doc strings. For example, the documentation for prettify-symbols-mode uses UTF-8 curved double-quotes. This usage will naturally grow in time. Yes, there will be some email glitches but they'll be easy to iron out as we gain experience. > - I don't like having two standards for quoting. Nor do I. This is a transition process, with the long-term goal of quoting via quotes rather than via grave accent and apostrophe. It's not practical to do this transition all at once, hence the transition period. But in the long run there'll be just one standard way to quote (even if Emacs supports the obsolete way indefinitely).