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 10:32:01 -0700 Organization: UCLA Computer Science Department Message-ID: <55392C91.1010300@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> 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 1429810405 16934 80.91.229.3 (23 Apr 2015 17:33:25 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 23 Apr 2015 17:33:25 +0000 (UTC) Cc: 20385@debbugs.gnu.org To: Nicolas Petton Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Apr 23 19:33:13 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 1YlKzu-0002GL-JM for geb-bug-gnu-emacs@m.gmane.org; Thu, 23 Apr 2015 19:33:10 +0200 Original-Received: from localhost ([::1]:41385 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YlKzu-0003SQ-0D for geb-bug-gnu-emacs@m.gmane.org; Thu, 23 Apr 2015 13:33:10 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:48963) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YlKzq-0003S9-UY for bug-gnu-emacs@gnu.org; Thu, 23 Apr 2015 13:33:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YlKzm-0003pT-Ug for bug-gnu-emacs@gnu.org; Thu, 23 Apr 2015 13:33:06 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:48204) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YlKzm-0003pP-Ry for bug-gnu-emacs@gnu.org; Thu, 23 Apr 2015 13:33:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1YlKzm-0001ce-Ao for bug-gnu-emacs@gnu.org; Thu, 23 Apr 2015 13:33: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 17:33: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.14298103316177 (code B ref 20385); Thu, 23 Apr 2015 17:33:02 +0000 Original-Received: (at 20385) by debbugs.gnu.org; 23 Apr 2015 17:32:11 +0000 Original-Received: from localhost ([127.0.0.1]:37980 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YlKyx-0001bZ-71 for submit@debbugs.gnu.org; Thu, 23 Apr 2015 13:32:11 -0400 Original-Received: from smtp.cs.ucla.edu ([131.179.128.62]:57909) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YlKyv-0001bN-O0 for 20385@debbugs.gnu.org; Thu, 23 Apr 2015 13:32:10 -0400 Original-Received: from localhost (localhost.localdomain [127.0.0.1]) by smtp.cs.ucla.edu (Postfix) with ESMTP id C0409A60012; Thu, 23 Apr 2015 10:32:02 -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 9mu-R1dk15dy; Thu, 23 Apr 2015 10:32:01 -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 B6227A60010; Thu, 23 Apr 2015 10:32:01 -0700 (PDT) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.6.0 In-Reply-To: <877ft39juq.fsf@petton.fr> 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:101942 Archived-At: On 04/23/2015 04:15 AM, Nicolas Petton wrote: > quoting code in > elisp docstrings would only be reasonably doable from Emacs' elisp mode, No, they're reasonably doable from any editor that supports smart quoting. Although Emacs doesn't have this option, it's common elsewhere, and it shouldn't be that hard to add it to Emacs. As for quoting `like this` that still doesn't sound like a good idea. Do we really want to switch to Markdown (or something like it) for doc strings? That would be a much bigger project, and would be work that nobody's prepared to do, and its overall costs could well exceed its benefits. Finally, from this thread it's clear that some folks like quoting `like this' and I suppose there's no harm in continuing to support it, so in my next iteration of this patch I plan to remove commentary to the effect that this usage is obsolescent and may not be supported in the future. So, people who prefer quoting `like this' (e.g., because it's easier with their non-Emacs text editors), will still be free to do that.