From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: Q: text-quoting-style -- is its value a string or a symbol? Date: Mon, 23 Nov 2015 18:18:21 -0800 (PST) Message-ID: <27c69be0-3326-41f5-bfaf-c0398a8e98dd@default> References: <22099.41981.70381.495217@retriever.mtv.corp.google.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1448331531 26753 80.91.229.3 (24 Nov 2015 02:18:51 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 24 Nov 2015 02:18:51 +0000 (UTC) Cc: Emacs-devel To: Xue Fuqiao , "T.V Raman" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Nov 24 03:18:34 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 1a13Bh-0003v7-89 for ged-emacs-devel@m.gmane.org; Tue, 24 Nov 2015 03:18:33 +0100 Original-Received: from localhost ([::1]:35584 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a13Bh-0000hj-Mj for ged-emacs-devel@m.gmane.org; Mon, 23 Nov 2015 21:18:33 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:48008) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a13Be-0000ec-69 for emacs-devel@gnu.org; Mon, 23 Nov 2015 21:18:31 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a13Bb-0002D2-1F for emacs-devel@gnu.org; Mon, 23 Nov 2015 21:18:30 -0500 Original-Received: from userp1040.oracle.com ([156.151.31.81]:24075) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a13Ba-0002CW-QF for emacs-devel@gnu.org; Mon, 23 Nov 2015 21:18:26 -0500 Original-Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id tAO2INLq009125 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Tue, 24 Nov 2015 02:18:24 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userv0022.oracle.com (8.13.8/8.13.8) with ESMTP id tAO2INkE031318 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Tue, 24 Nov 2015 02:18:23 GMT Original-Received: from abhmp0019.oracle.com (abhmp0019.oracle.com [141.146.116.25]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id tAO2INt5015025; Tue, 24 Nov 2015 02:18:23 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: userv0022.oracle.com [156.151.31.74] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-Received-From: 156.151.31.81 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:195153 Archived-At: > > Reading the online documentation for text-quoting-style --- it's hard > > to tell if the expected value is a string or a symbol. >=20 > A symbol. >=20 > In (info "(elisp) Keys in Documentation"): >=20 > To use the traditional `grave' style, put the line `(setq > text-quoting-style 'grave)' into your `~/.emacs' file. 1. Why is this in the node that is about "Substituting Key Bindings in Documentation"? IIUC, this variable is not about that topic. Just because you might make use of this variable in the implementation of `substitute-command-keys', that is no reason to document it here. 2. What does this mean? "the style used to generate text quotes." Generate text quotes? What are "text quotes"? What generates them? This means nothing, to me. And the doc string says something quite different, but just as incomprehensible: "Style to use for single quotes when generating text." Generating text or generating "text quotes" (whatever they might be)? And what or who does this generating? And when? And where is does the generated result (whatever it might be) end up? The doc for this variable is quite unclear. 3. Why is this not a _user option_, instead of an internal variable? Doesn't it affect what a user sees? Judging by the instructions for a user about how to change the behavior, it seems to be something a user can use, to change how quoted thingies (whatever the thingies might be) are quoted. If it should be a user option, please make it so. And then please document it in the _Emacs_ manual. And then change the instructions for modifying the behavior to mention using Customize, instead of telling users to put (setq ...) in their init files.