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: Upcoming loss of usability of Emacs source files and Emacs. Date: Mon, 29 Jun 2015 18:51:03 -0700 Organization: UCLA Computer Science Department Message-ID: <5591F607.2010109@cs.ucla.edu> References: <20150615142237.GA3517@acm.fritz.box> <87y4jkhqh5.fsf@uwakimon.sk.tsukuba.ac.jp> <557F3C22.4060909@cs.ucla.edu> <5580D356.4050708@cs.ucla.edu> <87si9qonxb.fsf@gnu.org> <5581C29E.1030101@yandex.ru> <558D6A3D.1070706@yandex.ru> <55901443.5070605@cs.ucla.edu> <55915B34.1020906@cs.ucla.edu> 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 1435629083 4263 80.91.229.3 (30 Jun 2015 01:51:23 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 30 Jun 2015 01:51:23 +0000 (UTC) Cc: emacs-devel@gnu.org To: rms@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Jun 30 03:51:14 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 1Z9khe-00076X-Cn for ged-emacs-devel@m.gmane.org; Tue, 30 Jun 2015 03:51:14 +0200 Original-Received: from localhost ([::1]:44598 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z9khd-0006uM-Md for ged-emacs-devel@m.gmane.org; Mon, 29 Jun 2015 21:51:13 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:43897) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z9kha-0006uE-P9 for emacs-devel@gnu.org; Mon, 29 Jun 2015 21:51:11 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Z9khV-0003JE-P6 for emacs-devel@gnu.org; Mon, 29 Jun 2015 21:51:10 -0400 Original-Received: from zimbra.cs.ucla.edu ([131.179.128.68]:52913) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z9khV-0003J6-Jo; Mon, 29 Jun 2015 21:51:05 -0400 Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id C28AA16087A; Mon, 29 Jun 2015 18:51:04 -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 V9Le8lj0kdyD; Mon, 29 Jun 2015 18:51:03 -0700 (PDT) Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id DE9FF16087E; Mon, 29 Jun 2015 18:51:03 -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 R30dUIT_qbjT; Mon, 29 Jun 2015 18:51:03 -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 C03FF16084B; Mon, 29 Jun 2015 18:51:03 -0700 (PDT) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.7.0 In-Reply-To: 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:187658 Archived-At: Richard Stallman wrote: > What is the solution that is installed now? When a grave accent and any matching apostrophe are copied from a docstri= ng to a=20 *Help* buffer, they are converted to left and right quotation marks accor= ding to=20 user preference. Characters can be escaped with \=3D to avoid conversion= (this is=20 a longstanding escape convention in docstrings). Most existing docstrings don't need to be changed. For example, in the s= ource=20 code the docstring for eval-after-load might contain this: "FORM can be an Elisp expression (in which case it's passed to `eval')= , or a function (in which case it's passed to `funcall' with no arg)." For this docstring if the user preference is curved quotes the *Help* buf= fer=20 contains this: FORM can be an Elisp expression (in which case it's passed to =E2=80=98= eval=E2=80=99), or a function (in which case it's passed to =E2=80=98funcall=E2=80=99 = with no arg). If the user preference is traditional, the *Help* buffer looks like this: FORM can be an Elisp expression (in which case it's passed to `eval'), or a function (in which case it's passed to `funcall' with no arg). A few doc strings have unusual quoting and use \=3DX escape sequences to = display a=20 quoting character X without transformation. For example, in the source c= ode the=20 docstring for texinfo-format-verb might contain this: "For example, @verb\{|@|\} results in @ and @verb\{+@'e?\\=3D`!\\=3D`+} results in @'e?\\=3D`!\\=3D`." For this docstring the *Help* buffer contains the following, regardless o= f user=20 preference for quoting, because the grave accents are escaped: For example, @verb{|@|} results in @ and @verb{+@'e?`!`+} results in @'e?`!`.