From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Paul Eggert Newsgroups: gmane.emacs.devel Subject: Re: Escaping quotes in docstrings, Was: A simple solution to "Upcoming loss of usability ..." Date: Tue, 07 Jul 2015 00:54:38 -0700 Organization: UCLA Computer Science Department Message-ID: <559B85BE.4070303@cs.ucla.edu> References: <87egkzg7gb.fsf@gmail.com> <558C2E25.10303@cs.ucla.edu> <558C492E.9000705@yandex.ru> <558C7DE1.4060507@cs.ucla.edu> <558C82D2.1070408@yandex.ru> <558CBA7E.7060900@cs.ucla.edu> <558D403D.303@yandex.ru> <558EDD4C.4040002@cs.ucla.edu> <558EE315.3080107@yandex.ru> <558F10FA.409@cs.ucla.edu> <558F4804.1020406@yandex.ru> <559010D6.5090905@cs.ucla.edu> <559058AD.5060504@yandex.ru> <55908355.3080407@yandex.ru> <559356D2.4000103@cs.ucla.edu> <5594813A.3000705@yandex.ru> <5594E0DB.1080702@cs.ucla.edu> <559A1C54.5030405@cs.ucla.edu> <559A6F86.2080809@yandex.ru> <559AAD27.3000403@cs.ucla.edu> <559AFCC3.3070409@yandex.ru> 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 1436255714 23007 80.91.229.3 (7 Jul 2015 07:55:14 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 7 Jul 2015 07:55:14 +0000 (UTC) To: Dmitry Gutov , emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Jul 07 09:55:06 2015 Return-path: Envelope-to: ged-emacs-devel@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 1ZCNia-0007dK-QF for ged-emacs-devel@m.gmane.org; Tue, 07 Jul 2015 09:55:04 +0200 Original-Received: from localhost ([::1]:55294 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZCNiZ-0005mj-CG for ged-emacs-devel@m.gmane.org; Tue, 07 Jul 2015 03:55:03 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:51538) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZCNiK-0005md-4J for emacs-devel@gnu.org; Tue, 07 Jul 2015 03:54:49 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZCNiF-0001YC-33 for emacs-devel@gnu.org; Tue, 07 Jul 2015 03:54:48 -0400 Original-Received: from zimbra.cs.ucla.edu ([131.179.128.68]:57520) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZCNiE-0001VN-R3 for emacs-devel@gnu.org; Tue, 07 Jul 2015 03:54:42 -0400 Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 922D2160994; Tue, 7 Jul 2015 00:54:40 -0700 (PDT) Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id 6aTGGt4WDFbR; Tue, 7 Jul 2015 00:54:39 -0700 (PDT) Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 59B84160995; Tue, 7 Jul 2015 00:54:39 -0700 (PDT) X-Virus-Scanned: amavisd-new at zimbra.cs.ucla.edu Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id OzwM2Nd5fSoG; Tue, 7 Jul 2015 00:54:39 -0700 (PDT) Original-Received: from [192.168.1.9] (pool-100-32-155-148.lsanca.fios.verizon.net [100.32.155.148]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id 34DBB1601AE; Tue, 7 Jul 2015 00:54:39 -0700 (PDT) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.7.0 In-Reply-To: <559AFCC3.3070409@yandex.ru> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 131.179.128.68 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 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.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:187758 Archived-At: Dmitry Gutov wrote: > That doesn't sound right to me. `key-description' should continue returning a > plain string. Perhaps you're right, I haven't looked into key-description carefully enough. I gave it only as an example of the sorts of problems we'd run into. > since when do button labels have quotes in them? In customization buffers. >> In contrast, it's much easier to look through the code for ` inside a >> string, and mark the exceptional characters that are intended to be >> quotes and that are not automatically translated already. > > Sorry, I don't understand this either. Mark? Automatically translated? I meant that although normally doc strings are translated and one can quote with either grave accent and apostrophe or curved quotation marks and they will be translated automatically to the user preferred style, occasionally one wants an actual grave accent or curved quotation mark to be output as-is regardless of user preference and these exceptional cases need to be marked in the doc strings. > That would be closer, but the current master implements more in C, which means > fewer people who can change or maintain the code. And it complicates the API of > a low-level function (substitute-command-keys), in a way that seems incompatible > with radically changing the output later. We can't anticipate radical changes that future maintainers might want to do. Worrying about that is likely to lead to overengineering and wasted effort. We'll have enough trouble just solving today's problems. As for whether the implementation should be in C -- some parts have to be used by C, since C code generates quoted strings on occasion. How much should be in C vs Lisp is an implementation detail that is no big deal.