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: Thu, 21 May 2015 07:58:57 -0700 Organization: UCLA Computer Science Department Message-ID: <555DF2B1.1070609@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> <555640E9.4060203@cs.ucla.edu> <55564460.4020208@yandex.ru> <55566196.40105@cs.ucla.edu> <55566990.8020506@yandex.ru> <555686B7.60808@cs.ucla.edu> <55568B3E.5040704@yandex.ru> <5556A205.3040503@cs.ucla.edu> <5556FF7E.8070006@yandex.ru> <555BC6F6.8020305@cs.ucla.edu> <555BEFC8.3080307@yandex.ru> <555D8790.6030405@cs.ucla.edu> <555DACE0.8020207@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 1432220438 21600 80.91.229.3 (21 May 2015 15:00:38 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 21 May 2015 15:00:38 +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 Thu May 21 17:00:26 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 1YvRxQ-0007Kj-Tl for geb-bug-gnu-emacs@m.gmane.org; Thu, 21 May 2015 17:00:25 +0200 Original-Received: from localhost ([::1]:58181 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YvRxQ-000714-Bt for geb-bug-gnu-emacs@m.gmane.org; Thu, 21 May 2015 11:00:24 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:35202) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YvRxJ-00070o-1m for bug-gnu-emacs@gnu.org; Thu, 21 May 2015 11:00:21 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YvRxC-0000EX-Ly for bug-gnu-emacs@gnu.org; Thu, 21 May 2015 11:00:17 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:42313) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YvRxC-0000ET-H6 for bug-gnu-emacs@gnu.org; Thu, 21 May 2015 11:00:10 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1YvRxB-0008JC-8q for bug-gnu-emacs@gnu.org; Thu, 21 May 2015 11:00:09 -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, 21 May 2015 15:00:08 +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.143222036831847 (code B ref 20385); Thu, 21 May 2015 15:00:08 +0000 Original-Received: (at 20385) by debbugs.gnu.org; 21 May 2015 14:59:28 +0000 Original-Received: from localhost ([127.0.0.1]:52282 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YvRwR-0008HT-ND for submit@debbugs.gnu.org; Thu, 21 May 2015 10:59:28 -0400 Original-Received: from smtp.cs.ucla.edu ([131.179.128.62]:33173) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YvRw8-0008Gb-GV for 20385@debbugs.gnu.org; Thu, 21 May 2015 10:59:09 -0400 Original-Received: from localhost (localhost.localdomain [127.0.0.1]) by smtp.cs.ucla.edu (Postfix) with ESMTP id 4BD86A60012; Thu, 21 May 2015 07:58:58 -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 7Ryq4XSWa8XN; Thu, 21 May 2015 07:58:57 -0700 (PDT) Original-Received: from [192.168.1.9] (pool-100-32-155-148.lsanca.fios.verizon.net [100.32.155.148]) by smtp.cs.ucla.edu (Postfix) with ESMTPSA id 4C7F5A60001; Thu, 21 May 2015 07:58:57 -0700 (PDT) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.7.0 In-Reply-To: <555DACE0.8020207@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:102998 Archived-At: Dmitry Gutov wrote: > I'd make it a new function (the name doesn't fit), and pass the docstring > contents through it, before giving them to substitute-command-keys. I originally wrote it that way, but it was harder for me to read. (Also slower, though that doesn't matter these days.) I couldn't find anybody that would want to call one function but not the other. Plus, having them be separate functions introduces more opportunity for error, e.g., it wouldn't be correct to call the new function after calling substitute-command-keys. So I figured we might as well leave them combined. How about if we rename substitute-command-keys to describe it better? substitute-doc-string, perhaps? > And if you write it in Lisp, you could incorporate the special handling of > quasiquotes relatively easily. Yes, I originally wrote it in Lisp too, but found that it was too tempting to implement complicated heuristics that would have been a pain to document. (I even defended some of those heuristics in previous emails -- sorry!) Doing it in C forced me to come up with something really simple and easy to explain. I'd rather keep the simple rules now, even if we go back to Lisp (but why bother?).