From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Glenn Morris Newsgroups: gmane.emacs.bugs Subject: bug#26998: 25.2; Please don't curly quote example code in docstring. Date: Fri, 19 May 2017 15:39:51 -0400 Message-ID: <05fug08wl4.fsf@fencepost.gnu.org> References: <877f1czo6p.fsf@gmail.com> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1495222870 13338 195.159.176.226 (19 May 2017 19:41:10 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 19 May 2017 19:41:10 +0000 (UTC) User-Agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/) Cc: 26998@debbugs.gnu.org To: Thierry Volpiatto Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri May 19 21:41:05 2017 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dBnln-0003IJ-IU for geb-bug-gnu-emacs@m.gmane.org; Fri, 19 May 2017 21:41:03 +0200 Original-Received: from localhost ([::1]:60051 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dBnlt-00076B-1z for geb-bug-gnu-emacs@m.gmane.org; Fri, 19 May 2017 15:41:09 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60385) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dBnln-000765-Iq for bug-gnu-emacs@gnu.org; Fri, 19 May 2017 15:41:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dBnlm-0005da-E8 for bug-gnu-emacs@gnu.org; Fri, 19 May 2017 15:41:03 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:52941) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dBnlm-0005dV-62 for bug-gnu-emacs@gnu.org; Fri, 19 May 2017 15:41:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1dBnlm-0003y4-06 for bug-gnu-emacs@gnu.org; Fri, 19 May 2017 15:41:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Glenn Morris Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 19 May 2017 19:41:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 26998 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 26998-submit@debbugs.gnu.org id=B26998.149522280415167 (code B ref 26998); Fri, 19 May 2017 19:41:01 +0000 Original-Received: (at 26998) by debbugs.gnu.org; 19 May 2017 19:40:04 +0000 Original-Received: from localhost ([127.0.0.1]:55618 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dBnkp-0003wX-HR for submit@debbugs.gnu.org; Fri, 19 May 2017 15:40:03 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:40985) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dBnkn-0003w0-Bu for 26998@debbugs.gnu.org; Fri, 19 May 2017 15:40:01 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dBnkh-0005HJ-4w for 26998@debbugs.gnu.org; Fri, 19 May 2017 15:39:55 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:34438) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dBnkf-0005GX-MQ; Fri, 19 May 2017 15:39:53 -0400 Original-Received: from rgm by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1dBnkd-0001I7-WB; Fri, 19 May 2017 15:39:52 -0400 X-Spook: ANC NSA unclassified pipeline Outbreak Ron Brown Twister X-Ran: w6KdWWlmp (Thierry Volpiatto's message of "Fri, 19 May 2017 20:39:10 +0200") X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.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" Xref: news.gmane.org gmane.emacs.bugs:132654 Archived-At: Thierry Volpiatto wrote: > When copying/pasting example code with quotes from a docstring, user have > to replace curly quotes "'" by real quote "'" before evaling code which > is a regression IMO. > > e.g > (defvar bar 1) > (foo 'bar) Is the above supposed to be part of a doc-string? A complete example is always helpful: (defvar my-var nil "Blah. Do stuff: (defvar bar 1) (foo \\='bar) (foo 'bar) ") C-h v my-var So I guess all existing lisp doc-strings everywhere are supposed to be audited for use of ' and \= escapes added where needed. (I believe it has been done for code in Emacs.) This has been discussed several times over on this and other Emacs lists, so there probably isn't anything new left to say.