From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Paul Eggert Newsgroups: gmane.emacs.bugs Subject: bug#23372: 25.0.93; text-quoting-style missing from manual and from customize Date: Mon, 25 Apr 2016 15:26:18 -0700 Organization: UCLA Computer Science Department Message-ID: References: <87wpnlq1xu.fsf@gmail.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="------------C134BBE9A282F952038D6309" X-Trace: ger.gmane.org 1461623245 32374 80.91.229.3 (25 Apr 2016 22:27:25 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 25 Apr 2016 22:27:25 +0000 (UTC) Cc: 23372@debbugs.gnu.org To: "N. Jackson" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Apr 26 00:27:14 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1auoyH-0004XP-OT for geb-bug-gnu-emacs@m.gmane.org; Tue, 26 Apr 2016 00:27:13 +0200 Original-Received: from localhost ([::1]:35230 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1auoyD-0000Tf-VA for geb-bug-gnu-emacs@m.gmane.org; Mon, 25 Apr 2016 18:27:09 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59234) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1auoyA-0000Rw-CA for bug-gnu-emacs@gnu.org; Mon, 25 Apr 2016 18:27:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1auoy6-0005yf-9I for bug-gnu-emacs@gnu.org; Mon, 25 Apr 2016 18:27:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:34658) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1auoy6-0005yb-5q for bug-gnu-emacs@gnu.org; Mon, 25 Apr 2016 18:27:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1auoy6-0003sH-1b for bug-gnu-emacs@gnu.org; Mon, 25 Apr 2016 18:27:02 -0400 X-Loop: help-debbugs@gnu.org In-Reply-To: <87wpnlq1xu.fsf@gmail.com> Resent-From: Paul Eggert Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 25 Apr 2016 22:27:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 23372 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 23372-submit@debbugs.gnu.org id=B23372.146162318714845 (code B ref 23372); Mon, 25 Apr 2016 22:27:01 +0000 Original-Received: (at 23372) by debbugs.gnu.org; 25 Apr 2016 22:26:27 +0000 Original-Received: from localhost ([127.0.0.1]:46995 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1auoxX-0003rM-Ib for submit@debbugs.gnu.org; Mon, 25 Apr 2016 18:26:27 -0400 Original-Received: from zimbra.cs.ucla.edu ([131.179.128.68]:58262) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1auoxW-0003r7-7r for 23372@debbugs.gnu.org; Mon, 25 Apr 2016 18:26:26 -0400 Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 6339E161262; Mon, 25 Apr 2016 15:26:20 -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 txpXPES_lld9; Mon, 25 Apr 2016 15:26:19 -0700 (PDT) Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 1E473161282; Mon, 25 Apr 2016 15:26:19 -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 mgqhbiHDHQ9f; Mon, 25 Apr 2016 15:26:19 -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 0596C161262; Mon, 25 Apr 2016 15:26:18 -0700 (PDT) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.0 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:116830 Archived-At: This is a multi-part message in MIME format. --------------C134BBE9A282F952038D6309 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit When text-quoting-style was introduced, Stefan Monnier (then the maintainer) did not see the need the the variable at all, and wrote "At the very least it should not be a Custom var." See: https://lists.gnu.org/archive/html/emacs-devel/2015-08/msg01020.html Eventually I vaguely recall that Stefan was persuaded to put up with the variable. Still, I think he's right that it's not suitable for a user option. I installed the attached patch to try to document this better. Since it's intended for experts, the variable is documented in the reference manual, not the user manual. --------------C134BBE9A282F952038D6309 Content-Type: application/x-patch; name="0001-Say-why-text-quoting-style-is-not-a-user-option.patch" Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename*0="0001-Say-why-text-quoting-style-is-not-a-user-option.patch" RnJvbSA0YTcyODJkN2MwNWUyOGYzNjA0OGJhNTZiYmI4Mzk2OWQyODA2OTc5IE1vbiBTZXAg MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBQYXVsIEVnZ2VydCA8ZWdnZXJ0QHBlbmd1aW4uY3Mu dWNsYS5lZHU+CkRhdGU6IE1vbiwgMjUgQXByIDIwMTYgMTU6MTk6NTUgLTA3MDAKU3ViamVj dDogW1BBVENIXSBTYXkgd2h5IHRleHQtcXVvdGluZy1zdHlsZSBpcyBub3QgYSB1c2VyIG9w dGlvbgoKKiBkb2MvbGlzcHJlZi9oZWxwLnRleGkgKEtleXMgaW4gRG9jdW1lbnRhdGlvbik6 CiogZXRjL05FV1M6IERvY3VtZW50IHdoeSB0ZXh0LXF1b3Rpbmctc3R5bGUgaXMgbm90IGEK Y3VzdG9taXphYmxlIHZhcmlhYmxlIChCdWcjMjMzNzIpLgotLS0KIGRvYy9saXNwcmVmL2hl bHAudGV4aSB8IDQgKysrKwogZXRjL05FV1MgICAgICAgICAgICAgIHwgMyArKy0KIDIgZmls ZXMgY2hhbmdlZCwgNiBpbnNlcnRpb25zKCspLCAxIGRlbGV0aW9uKC0pCgpkaWZmIC0tZ2l0 IGEvZG9jL2xpc3ByZWYvaGVscC50ZXhpIGIvZG9jL2xpc3ByZWYvaGVscC50ZXhpCmluZGV4 IDBiODE4MmMuLjU4YTExZjIgMTAwNjQ0Ci0tLSBhL2RvYy9saXNwcmVmL2hlbHAudGV4aQor KysgYi9kb2MvbGlzcHJlZi9oZWxwLnRleGkKQEAgLTM2Miw2ICszNjIsMTAgQEAgS2V5cyBp biBEb2N1bWVudGF0aW9uCiBiZWZvcmUgRW1hY3MgdmVyc2lvbiAyNS4gIFRoZSBkZWZhdWx0 IHZhbHVlIEBjb2Rle25pbH0KIGFjdHMgbGlrZSBAY29kZXtjdXJ2ZX0gaWYgY3VydmVkIHNp bmdsZSBxdW90ZXMgYXJlIGRpc3BsYXlhYmxlLCBhbmQKIGxpa2UgQGNvZGV7Z3JhdmV9IG90 aGVyd2lzZS4KKworVGhpcyB2YXJpYWJsZSBjYW4gYmUgdXNlZCBieSBleHBlcnRzIG9uIHBs YXRmb3JtcyB0aGF0IGhhdmUgcHJvYmxlbXMKK3dpdGggY3VydmVkIHF1b3Rlcy4gIEFzIGl0 IGlzIG5vdCBpbnRlbmRlZCBmb3IgY2FzdWFsIHVzZSwgaXQgaXMgbm90IGEKK3VzZXIgb3B0 aW9uLgogQGVuZCBkZWZ2YXIKIAogQGRlZnVuIHN1YnN0aXR1dGUtY29tbWFuZC1rZXlzIHN0 cmluZwpkaWZmIC0tZ2l0IGEvZXRjL05FV1MgYi9ldGMvTkVXUwppbmRleCA3YmVkY2VkLi5h NTA0NjljIDEwMDY0NAotLS0gYS9ldGMvTkVXUworKysgYi9ldGMvTkVXUwpAQCAtMTQ3Miw3 ICsxNDcyLDggQEAgU2V0IGl0IHRvICdjdXJ2ZScgZm9yIGN1cnZlZCBzaW5nbGUgcXVvdGVz LCB0byAnc3RyYWlnaHQnIGZvciBzdHJhaWdodAogYXBvc3Ryb3BoZXMsIGFuZCB0byAnZ3Jh dmUnIGZvciBncmF2ZSBhY2NlbnQgYW5kIGFwb3N0cm9waGUuICBUaGUKIGRlZmF1bHQgdmFs dWUgbmlsIGFjdHMgbGlrZSAnY3VydmUnIGlmIGN1cnZlZCBzaW5nbGUgcXVvdGVzIGFyZQog ZGlzcGxheWFibGUsIGFuZCBsaWtlICdncmF2ZScgb3RoZXJ3aXNlLiAgVGhlIG5ldyB2YXJp YWJsZSBhZmZlY3RzCi1kaXNwbGF5IG9mIGRpYWdub3N0aWNzIGFuZCBoZWxwLCBidXQgbm90 IG9mIGluZm8uCitkaXNwbGF5IG9mIGRpYWdub3N0aWNzIGFuZCBoZWxwLCBidXQgbm90IG9m IGluZm8uICBBcyB0aGUgdmFyaWFibGUgaXMKK25vdCBpbnRlbmRlZCBmb3IgY2FzdWFsIHVz ZSwgaXQgaXMgbm90IGEgdXNlciBvcHRpb24uCiAKICsrKwogKiogc3Vic3RpdHV0ZS1jb21t YW5kLWtleXMgbm93IHJlcGxhY2VzIHF1b3Rlcy4KLS0gCjIuNS41Cgo= --------------C134BBE9A282F952038D6309--