From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#23649: 24.5; `customize-mode' Date: Sun, 29 May 2016 14:40:58 -0700 (PDT) Message-ID: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1464558150 14183 80.91.229.3 (29 May 2016 21:42:30 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 29 May 2016 21:42:30 +0000 (UTC) To: 23649@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun May 29 23:42:17 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 1b78TR-0008SN-0k for geb-bug-gnu-emacs@m.gmane.org; Sun, 29 May 2016 23:42:17 +0200 Original-Received: from localhost ([::1]:57021 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b78TM-0001vy-QW for geb-bug-gnu-emacs@m.gmane.org; Sun, 29 May 2016 17:42:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52817) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b78TH-0001ul-2V for bug-gnu-emacs@gnu.org; Sun, 29 May 2016 17:42:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1b78TC-0001Bo-TL for bug-gnu-emacs@gnu.org; Sun, 29 May 2016 17:42:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:34337) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b78TC-0001Bk-Pj for bug-gnu-emacs@gnu.org; Sun, 29 May 2016 17:42:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1b78TC-00050O-Ik for bug-gnu-emacs@gnu.org; Sun, 29 May 2016 17:42:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 29 May 2016 21:42:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 23649 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.146455808119185 (code B ref -1); Sun, 29 May 2016 21:42:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 29 May 2016 21:41:21 +0000 Original-Received: from localhost ([127.0.0.1]:46674 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1b78SW-0004zN-N6 for submit@debbugs.gnu.org; Sun, 29 May 2016 17:41:20 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:33408) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1b78ST-0004z9-Oo for submit@debbugs.gnu.org; Sun, 29 May 2016 17:41:18 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1b78SN-00016B-Os for submit@debbugs.gnu.org; Sun, 29 May 2016 17:41:12 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:36289) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b78SN-000166-Lw for submit@debbugs.gnu.org; Sun, 29 May 2016 17:41:11 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52612) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b78SL-0001sG-DV for bug-gnu-emacs@gnu.org; Sun, 29 May 2016 17:41:10 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1b78SH-000152-4D for bug-gnu-emacs@gnu.org; Sun, 29 May 2016 17:41:08 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:40719) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b78SG-00014x-S4 for bug-gnu-emacs@gnu.org; Sun, 29 May 2016 17:41:05 -0400 Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u4TLf2Ca008132 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sun, 29 May 2016 21:41:02 GMT Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userv0021.oracle.com (8.13.8/8.13.8) with ESMTP id u4TLf1mQ011953 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sun, 29 May 2016 21:41:02 GMT Original-Received: from abhmp0006.oracle.com (abhmp0006.oracle.com [141.146.116.12]) by aserv0122.oracle.com (8.13.8/8.13.8) with ESMTP id u4TLexK9030011 for ; Sun, 29 May 2016 21:41:00 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6744.5000 (x86)] X-Source-IP: userv0021.oracle.com [156.151.31.71] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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:118840 Archived-At: The doc string is incorrect: 1. It says, "If a prefix C-u was given..." Besides the fact that we write `C-u', not C-u, this is wrong because it suggests that the prefix arg must be a plain `C-u', that you cannot, for example, use `M-9', `C--', or even `C-u 3'. It should just say "If a prefix arg is given..." 2. It is not true that the options you get are related to the current major mode, or even to any major mode. It would be OK to say this as a first line, if the rest of the doc string made clear that the options can be related to a minor mode, that is, MODE can name a minor, not just a major mode. What the doc should say is that it customizes options related to MODE, which can name a major or a minor mode, and that by default MODE is the current major mode. (This also takes care of specifying the argument and thus behavior when called from Lisp, something missing from the doc string now.) Example mode-string, corrected: "Customize options related to a major or minor mode. By default the current major mode is used. With a prefix argument or if the current major mode has no known group, you are prompted for the MODE to customize." 3. The prompt is thus incorrect as well: the candidates are not necessarily major-mode names. It should just say "Mode: ". See also bugs #11299 and #11301, which have not been addressed. In GNU Emacs 24.5.1 (i686-pc-mingw32) of 2015-04-11 on LEG570 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --prefix=3D/c/usr --host=3Di686-pc-mingw32'