From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Artur Malabarba 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 16:36:04 +0100 Message-ID: References: <38bd87fc-e9d5-43c1-9687-e66faf993c7e@default> <0c1fb227-fad9-4410-a08d-96602eb39db3@default> Reply-To: bruce.connor.am@gmail.com NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 X-Trace: ger.gmane.org 1430408243 6372 80.91.229.3 (30 Apr 2015 15:37:23 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 30 Apr 2015 15:37:23 +0000 (UTC) Cc: 20462@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Apr 30 17:37:18 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 1YnqWb-0003Ry-Ng for geb-bug-gnu-emacs@m.gmane.org; Thu, 30 Apr 2015 17:37:17 +0200 Original-Received: from localhost ([::1]:44563 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YnqWa-0000hL-Vc for geb-bug-gnu-emacs@m.gmane.org; Thu, 30 Apr 2015 11:37:17 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60988) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YnqWR-0000Ub-6p for bug-gnu-emacs@gnu.org; Thu, 30 Apr 2015 11:37:11 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YnqWM-0002pJ-F5 for bug-gnu-emacs@gnu.org; Thu, 30 Apr 2015 11:37:07 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:47757) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YnqWM-0002pB-Ax for bug-gnu-emacs@gnu.org; Thu, 30 Apr 2015 11:37:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1YnqWL-0001XS-QK for bug-gnu-emacs@gnu.org; Thu, 30 Apr 2015 11:37:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Artur Malabarba Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 30 Apr 2015 15:37:01 +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.14304081835835 (code B ref 20462); Thu, 30 Apr 2015 15:37:01 +0000 Original-Received: (at 20462) by debbugs.gnu.org; 30 Apr 2015 15:36:23 +0000 Original-Received: from localhost ([127.0.0.1]:57732 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YnqVe-0001Vx-6T for submit@debbugs.gnu.org; Thu, 30 Apr 2015 11:36:23 -0400 Original-Received: from mail-lb0-f169.google.com ([209.85.217.169]:35502) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1YnqVX-0001Vb-0S for 20462@debbugs.gnu.org; Thu, 30 Apr 2015 11:36:16 -0400 Original-Received: by lbbuc2 with SMTP id uc2so47570998lbb.2 for <20462@debbugs.gnu.org>; Thu, 30 Apr 2015 08:36:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:reply-to:sender:in-reply-to:references:date:message-id :subject:from:to:cc:content-type; bh=cXOa3i66agcutTnsHf6lmNogPx05SO4Do2KLhLRzCS0=; b=pXHYJSOAMXz9W7+AjG+00Fi9ORGczqUcbN7lw85tMEKGvUhtCm8iPPbz0O2aPN2VD3 uF3qikVpN8l77+6KfKn5OC82Vk3ijiwtwN+gS+86vpCwuoCV1MLinvt3+wTza7vKehzN kdB3sDMoYZxVjue6+FTf8+oWvxRWM+ZNyWYWhjIsUvpyF3cTxqfSI1Pu4aw+w2qUZC+l buFR0HwAhEXSsS/u9GczrCp1tir7vnmPMBaVQSngwcJTAs8bdsZGNpXMrz8sb23IAloz F1aIueTvWSgwR9rh8Orm4C/hEaS5v1HTeX68Zn6+tFnCh3egm0kt3H7WLx2gaWVhja5v zPSQ== X-Received: by 10.152.87.204 with SMTP id ba12mr4466990lab.35.1430408164779; Thu, 30 Apr 2015 08:36:04 -0700 (PDT) Original-Received: by 10.25.150.1 with HTTP; Thu, 30 Apr 2015 08:36:04 -0700 (PDT) In-Reply-To: <0c1fb227-fad9-4410-a08d-96602eb39db3@default> X-Google-Sender-Auth: 5e2Q0PTYPqHQO_V3VWtZz0uaoZ0 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:102293 Archived-At: 2015-04-30 14:47 GMT+01:00 Drew Adams >> (define-globalized-minor-mode foo auto-fill-mode 'ignore) >> C-h foo >> Toggle Auto-Fill mode in all buffers. >> >> 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. I agree with Drew here. The fact that this information can be inferred (deciphered, perhaps) from the docstring doesn't mean that it shouldn't be included explicitly. Even more so where it comes minor modes, which are commands that even the most basic users will interact with (and probably read).