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#20462: 25.0.50; A minor mode's doc string should say it is [local/global] a minor mode Date: Thu, 30 Apr 2015 06:47:58 -0700 (PDT) Message-ID: <0c1fb227-fad9-4410-a08d-96602eb39db3@default> References: <38bd87fc-e9d5-43c1-9687-e66faf993c7e@default> 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 1430401775 17569 80.91.229.3 (30 Apr 2015 13:49:35 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 30 Apr 2015 13:49:35 +0000 (UTC) To: Glenn Morris , 20462@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Apr 30 15:49:22 2015 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 1Ynoq6-0006dy-6C for geb-bug-gnu-emacs@m.gmane.org; Thu, 30 Apr 2015 15:49:18 +0200 Original-Received: from localhost ([::1]:43926 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ynoq5-0007wJ-Jt for geb-bug-gnu-emacs@m.gmane.org; Thu, 30 Apr 2015 09:49:17 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:58503) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ynopw-0007m9-4n for bug-gnu-emacs@gnu.org; Thu, 30 Apr 2015 09:49:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Ynops-0003JY-1j for bug-gnu-emacs@gnu.org; Thu, 30 Apr 2015 09:49:08 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:47144) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ynopr-0003JR-Ua for bug-gnu-emacs@gnu.org; Thu, 30 Apr 2015 09:49:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1Ynopr-0005iB-IP for bug-gnu-emacs@gnu.org; Thu, 30 Apr 2015 09:49:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 30 Apr 2015 13:49:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 20462 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 20462-submit@debbugs.gnu.org id=B20462.143040169021861 (code B ref 20462); Thu, 30 Apr 2015 13:49:03 +0000 Original-Received: (at 20462) by debbugs.gnu.org; 30 Apr 2015 13:48:10 +0000 Original-Received: from localhost ([127.0.0.1]:57115 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Ynooz-0005gX-J9 for submit@debbugs.gnu.org; Thu, 30 Apr 2015 09:48:10 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:19318) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Ynoow-0005g1-MY for 20462@debbugs.gnu.org; Thu, 30 Apr 2015 09:48:07 -0400 Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t3UDlxmx002148 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 30 Apr 2015 13:47:59 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserv0022.oracle.com (8.13.8/8.13.8) with ESMTP id t3UDlx32002938 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Thu, 30 Apr 2015 13:47:59 GMT Original-Received: from abhmp0006.oracle.com (abhmp0006.oracle.com [141.146.116.12]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id t3UDlxKu003323; Thu, 30 Apr 2015 13:47:59 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: aserv0022.oracle.com [141.146.126.234] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:102282 Archived-At: > (define-globalized-minor-mode foo auto-fill-mode 'ignore) > C-h foo > Toggle Auto-Fill mode in all buffers. >=20 > 1) It's a minor mode (you can't toggle a major mode, nor sensibly > apply it to all buffers). > 2) It's global ("all buffers"). > (define-minor-mode blah nil) > C-f blah > Toggle Blah mode on or off. > 1) It's a minor mode (you can't toggle a major mode) > 2) Since it does not say it affects all buffers, don't assume it > does. Irrelevant to this bug report. A command that toggles something, including toggling a mode, is not necessarily a minor-mode command.=20 See, for example, the misnamed `use-hard-newlines' command of bug #20464. It happens to be a minor-mode command. But with that name it might just as well not have been. And there is no way to tell from its doc string that it has anything to do with a minor mode. `define-globalized-minor-mode' and `define-minor-mode' should explicitly add something to the doc string to make clear that the command is not just some command that toggles. They should explicitly mention "minor mode".