From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Nicolas Petton Newsgroups: gmane.emacs.bugs Subject: bug#20385: [PROPOSED PATCH] Support quoting 'like this' in doc strings Date: Thu, 23 Apr 2015 13:15:09 +0200 Message-ID: <877ft39juq.fsf@petton.fr> 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> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha1; protocol="application/pgp-signature" X-Trace: ger.gmane.org 1429787790 7390 80.91.229.3 (23 Apr 2015 11:16:30 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 23 Apr 2015 11:16:30 +0000 (UTC) Cc: 20385@debbugs.gnu.org To: Paul Eggert Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Apr 23 13:16:19 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 1YlF77-0000Zl-GV for geb-bug-gnu-emacs@m.gmane.org; Thu, 23 Apr 2015 13:16:13 +0200 Original-Received: from localhost ([::1]:39502 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YlF76-0006Y7-HX for geb-bug-gnu-emacs@m.gmane.org; Thu, 23 Apr 2015 07:16:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:36495) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YlF71-0006V5-53 for bug-gnu-emacs@gnu.org; Thu, 23 Apr 2015 07:16:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YlF6w-0003vP-SU for bug-gnu-emacs@gnu.org; Thu, 23 Apr 2015 07:16:07 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:47403) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YlF6w-0003vI-LZ for bug-gnu-emacs@gnu.org; Thu, 23 Apr 2015 07:16:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1YlF6w-0008EY-4G for bug-gnu-emacs@gnu.org; Thu, 23 Apr 2015 07:16:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Nicolas Petton Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 23 Apr 2015 11:16: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.142978771631590 (code B ref 20385); Thu, 23 Apr 2015 11:16:02 +0000 Original-Received: (at 20385) by debbugs.gnu.org; 23 Apr 2015 11:15:16 +0000 Original-Received: from localhost ([127.0.0.1]:37179 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YlF6B-0008DR-Dp for submit@debbugs.gnu.org; Thu, 23 Apr 2015 07:15:15 -0400 Original-Received: from out4-smtp.messagingengine.com ([66.111.4.28]:53484) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YlF68-0008DI-Mp for 20385@debbugs.gnu.org; Thu, 23 Apr 2015 07:15:13 -0400 Original-Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailout.nyi.internal (Postfix) with ESMTP id B7DDD20495 for <20385@debbugs.gnu.org>; Thu, 23 Apr 2015 07:15:11 -0400 (EDT) Original-Received: from frontend1 ([10.202.2.160]) by compute4.internal (MEProxy); Thu, 23 Apr 2015 07:15:11 -0400 DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to:x-sasl-enc :x-sasl-enc; s=smtpout; bh=wyfzLIc/OHKDjb8Ai90MMCKVFGs=; b=fOhlt 9wItrO9DbOhGSZLUxCbstaWYrGONiZKBtsAExr4ZllysStoQXoqGXT/iA0KKQSLL 3AVmHh7+0lE3FUR7PYgCRDL6KJUY9goterWrMxdLNsYkHJ5WCNC+ZhPSp2ik5rJU L74IW2Kp8I8nqnWlyDhIA/FzmRolExi+dRwg4w= X-Sasl-enc: vK04bCUGvXr52Eu08riXbHazhsEbX/FRlxFe6jJDQjTM 1429787711 Original-Received: from blueberry (unknown [31.211.216.84]) by mail.messagingengine.com (Postfix) with ESMTPA id F1C2BC00015; Thu, 23 Apr 2015 07:15:10 -0400 (EDT) In-reply-to: <5538C7EC.9010105@cs.ucla.edu> 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:101922 Archived-At: --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Paul Eggert writes: > Nicolas Petton wrote: >> inserting curved quotes when the user types a single quote (or >> another character) in a string in Elisp code? Wouldn't that be a big >> issue in other modes (or even outside of Emacs)? > > I don't see why it would need to affect other modes, or affect > programs other than Emacs. The idea is to to make it easier for Elisp > programmers to put curved single quotes into doc strings. It's not about affecting other modes, but the fact that quoting code in elisp docstrings would only be reasonably doable from Emacs' elisp mode, since curved quotes aren't easy to type. That could be a problem in cases like answering elisp question on SE, in an email, etc. > Of course there is a more-general problem of making it easier to use > curved quotes in arbitrary contexts (including contexts outside > Emacs), but that problem needn't be solved here. I don't think it's worth it to make it unnecessarily hard to write elisp docstrings anywhere else than in emacs-lisp-mode in Emacs. It might look like I insist, but something `like-this` looks more than ok to me: =2D it is a really common practice nowadays and most people understand what it means. Many projects use Markdown in their README for example; =2D it doesn't require to use a special character (understand characters that one cannot easily type on a QWERTY keyboard); =2D it fixes the "unbalanced" quotes issue that you raised as well as using a curved single quote. But again, I don't see the need for a change at all, and I have never seen how quoted code looked like in older terminals. Cheers, Nico =2D-=20 Nicolas Petton http://nicolas-petton.fr --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 Comment: GPGTools - http://gpgtools.org iQEcBAEBAgAGBQJVONQ9AAoJECM1h6R8IHkQIGQH/jpY2VkgbKUUs1J5kzl80Ukk olFpbweWZUlDzplugVsU3rPsE21wAfVZYgfxepRtl3LxssXW0GjQXJenjwdDR5Xy ZQHsNkV2+ZdsEIcqnfN90dwW00v8mu8N5ofpu3jFbOc0zAqOM+/CQ0tmdvwRNTdv xplItJgQR2kFpxn2n7ZQPt2psa3e5rAkXvxCOSx1HhYV3RX2jl2xqfSo2UUKk4tj JiIyqXhLGemGXlp0xA7gZhBvk9bR266eLO0YwdEJG8YDfYrIXeDtWycrce4sku4h E8Ux+vtheHFdl41V9xN2Ps9g50EKrS4IL4g9qgDPCSqLnx/60P6RhIsLl9Jz9rY= =25OM -----END PGP SIGNATURE----- --=-=-=--