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: Sat, 01 Aug 2015 23:56:44 -0700 Organization: UCLA Computer Science Department Message-ID: <55BDBF2C.10000@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> <559B85BE.4070303@cs.ucla.edu> <559B902D.4000906@yandex.ru> <55BC22BB.4020002@cs.ucla.edu> <55BD34B2.5060001@yandex.ru> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1438498631 24760 80.91.229.3 (2 Aug 2015 06:57:11 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 2 Aug 2015 06:57:11 +0000 (UTC) To: Dmitry Gutov , emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Aug 02 08:57:04 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 1ZLnCg-0004mn-G9 for ged-emacs-devel@m.gmane.org; Sun, 02 Aug 2015 08:57:02 +0200 Original-Received: from localhost ([::1]:55398 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZLnCf-0006hv-Nw for ged-emacs-devel@m.gmane.org; Sun, 02 Aug 2015 02:57:01 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59550) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZLnCT-0006hp-V3 for emacs-devel@gnu.org; Sun, 02 Aug 2015 02:56:50 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZLnCQ-00008R-Of for emacs-devel@gnu.org; Sun, 02 Aug 2015 02:56:49 -0400 Original-Received: from zimbra.cs.ucla.edu ([131.179.128.68]:52662) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZLnCQ-00008L-Ix for emacs-devel@gnu.org; Sun, 02 Aug 2015 02:56:46 -0400 Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id D9C5B16057C; Sat, 1 Aug 2015 23:56:45 -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 FBdoWJ52aFS3; Sat, 1 Aug 2015 23:56:45 -0700 (PDT) Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 28B2C160728; Sat, 1 Aug 2015 23:56:45 -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 jjX0_rOPXlZk; Sat, 1 Aug 2015 23:56:45 -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 0CE4316057C; Sat, 1 Aug 2015 23:56:45 -0700 (PDT) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.8.0 In-Reply-To: <55BD34B2.5060001@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:188288 Archived-At: Dmitry Gutov wrote: > Here's a contrived example which can't be fixed without that: > > (defun =E2=80=99=E2=80=98 (a b c) > "It's called `=E2=80=99=E2=80=98'." > (+ 1 2 3)) Yes, and one can come up with other contrived examples that fail even wit= hout=20 putting curved quotes into the name. Elisp function names can contain an= y=20 character: apostrophe, grave accent, newline, parenthesis, space, etc., a= nd I'm=20 sure many of these other special characters also cause problems in help b= uffers. While it might be worthwhile to fix this, it's an independent issue. If = it is=20 fixed, I expect you're right that substitute-command-keys will need to be= teased=20 apart; this is not just because of curved quotes, but also because its ot= her=20 substitutions can generate characters that also need special treatment. = If=20 someone wants to take on that task, that's great, so long as it doesn't g= et in=20 the way of ordinary use of *Help* buffers. In particular, users should b= e able=20 to type =E2=80=98C-h f length RET=E2=80=99, see this in a *Help* buffer: To get the number of bytes, use =E2=80=98string-bytes=E2=80=99. and if they save and later yank this text into a source-code buffer they = should=20 get what they see, not a bowdlerized version with ASCII approximations.