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: Please stop putting curly quotes into doc strings! Date: Wed, 9 Sep 2015 15:24:50 -0700 Organization: UCLA Computer Science Department Message-ID: <55F0B1B2.80104@cs.ucla.edu> References: <55EA4821.2050401@yandex.ru> <55EBC5B8.80208@cs.ucla.edu> <55EE1B01.3010201@cs.ucla.edu> <55EEDBE7.8050903@yandex.ru> <55EEE97F.1040008@cs.ucla.edu> <55EF5FE3.4020209@yandex.ru> <55EF763E.5060500@cs.ucla.edu> <22000.36504.734886.651251@retriever.mtv.corp.google.com> 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 1441837536 28869 80.91.229.3 (9 Sep 2015 22:25:36 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 9 Sep 2015 22:25:36 +0000 (UTC) Cc: emacs-devel@gnu.org To: "T.V Raman" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Sep 10 00:25:27 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 1ZZnnu-0008B1-4A for ged-emacs-devel@m.gmane.org; Thu, 10 Sep 2015 00:25:22 +0200 Original-Received: from localhost ([::1]:45968 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZZnno-00069Z-CK for ged-emacs-devel@m.gmane.org; Wed, 09 Sep 2015 18:25:16 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:53389) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZZnnV-0005mG-P7 for emacs-devel@gnu.org; Wed, 09 Sep 2015 18:24:58 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZZnnQ-0003dV-RK for emacs-devel@gnu.org; Wed, 09 Sep 2015 18:24:57 -0400 Original-Received: from zimbra.cs.ucla.edu ([131.179.128.68]:33549) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZZnnQ-0003dL-KR for emacs-devel@gnu.org; Wed, 09 Sep 2015 18:24:52 -0400 Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id C76C816104F; Wed, 9 Sep 2015 15:24:51 -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 m9PZaARE9vlO; Wed, 9 Sep 2015 15:24:51 -0700 (PDT) Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 1B7AD16106A; Wed, 9 Sep 2015 15:24:51 -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 kesQ4aIae3tQ; Wed, 9 Sep 2015 15:24:51 -0700 (PDT) Original-Received: from Penguin.CS.UCLA.EDU (Penguin.CS.UCLA.EDU [131.179.64.200]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id 037A1161065; Wed, 9 Sep 2015 15:24:51 -0700 (PDT) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Thunderbird/38.1.0 In-Reply-To: <22000.36504.734886.651251@retriever.mtv.corp.google.com> 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:189779 Archived-At: On 09/09/2015 12:55 PM, T.V Raman wrote: > The only thing I'm asking for is that curly quotes in files where > they exist be removed so the codebase goes back to a pristine state. That is too strong. Although I already removed almost all the curved=20 quotes I introduced into doc strings, there were a few justifiable=20 exceptions. For example, when the code is about curved quotes=20 themselves it is fine for its documentation strings to use curved=20 quotes. Here's the doc string for text-quoting-style: Style to use for single quotes when generating text. `curve' means quote with curved single quotes \\=3D=E2=80=98like this\= \=3D=E2=80=99. `straight' means quote with straight apostrophes \\=3D'like this\\=3D'= . `grave' means quote with grave accent and apostrophe \\=3D`like this\\= =3D'. The default value nil acts like `curve' if curved single quotes are displayable, and like `grave' otherwise. The two curved quotes in this docstring are good, because they show the=20 user what curved quotes look like.