From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: [Emacs-diffs] master 9ce1d38: Use curved quotes in core elisp diagnostics Date: Tue, 18 Aug 2015 21:24:49 -0400 Message-ID: References: <20150816160149.9416.80132@vcs.savannah.gnu.org> <55D1043C.3030909@yandex.ru> <20150816225346.GA5367@acm.fritz.box> <55D2C080.2000806@cs.ucla.edu> Reply-To: rms@gnu.org NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: ger.gmane.org 1439947530 7938 80.91.229.3 (19 Aug 2015 01:25:30 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 19 Aug 2015 01:25:30 +0000 (UTC) Cc: emacs-devel@gnu.org To: Paul Eggert Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Aug 19 03:25:15 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 1ZRs7r-0005pJ-Iu for ged-emacs-devel@m.gmane.org; Wed, 19 Aug 2015 03:25:11 +0200 Original-Received: from localhost ([::1]:60210 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZRs7r-0003cN-0Z for ged-emacs-devel@m.gmane.org; Tue, 18 Aug 2015 21:25:11 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57818) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZRs7Y-0003TJ-Jo for emacs-devel@gnu.org; Tue, 18 Aug 2015 21:24:53 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZRs7X-0001aN-Pq for emacs-devel@gnu.org; Tue, 18 Aug 2015 21:24:52 -0400 Original-Received: from fencepost.gnu.org ([208.118.235.10]:39762) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZRs7W-0001Zj-Ad; Tue, 18 Aug 2015 21:24:50 -0400 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1ZRs7V-0002EA-P9; Tue, 18 Aug 2015 21:24:49 -0400 In-reply-to: <55D2C080.2000806@cs.ucla.edu> (message from Paul Eggert on Mon, 17 Aug 2015 22:20:00 -0700) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.10 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:188925 Archived-At: [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > > what benefit is there in putting > > any real curly quotes into those doc strings? > Format strings are easier to read and use, particularly by novices, if > characters typically stand for themselves. The issue at hand is doc strings in the source code, not format strings. Those are a different issue. > ... To get the number of bytes, use ‘string-bytes’. ... > Users can cut this text from *Help* and paste it directly into their source > code's doc strings; this is simpler than having to change those quotation marks It's a bad practice to copy text from a help buffer into a doc string in the source code. There are several constructs used in source code doc strings that get converted into something different in a help buffer. So if you want to copy one doc string into another, you should copy from source code. I doubt that case arises very often, though. If the user's new function is so similar to an existing function that he wants to copy from its doc string, he probably wrote his function by modifying the code of that function, and probably already has its doc string. -- Dr Richard Stallman President, Free Software Foundation (gnu.org, fsf.org) Internet Hall-of-Famer (internethalloffame.org) Skype: No way! See stallman.org/skype.html.