From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!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: Mon, 2 Jan 2017 13:59:55 -0800 (PST) Message-ID: References: <38bd87fc-e9d5-43c1-9687-e66faf993c7e@default> <0c1fb227-fad9-4410-a08d-96602eb39db3@default> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1483394482 21036 195.159.176.226 (2 Jan 2017 22:01:22 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 2 Jan 2017 22:01:22 +0000 (UTC) To: 20462@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jan 02 23:01:14 2017 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cOAfF-0003nC-UB for geb-bug-gnu-emacs@m.gmane.org; Mon, 02 Jan 2017 23:01:10 +0100 Original-Received: from localhost ([::1]:59213 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cOAfI-0006IJ-JT for geb-bug-gnu-emacs@m.gmane.org; Mon, 02 Jan 2017 17:01:12 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50499) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cOAfC-0006Hr-Ey for bug-gnu-emacs@gnu.org; Mon, 02 Jan 2017 17:01:07 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cOAf8-0000eG-Jx for bug-gnu-emacs@gnu.org; Mon, 02 Jan 2017 17:01:06 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:52619) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1cOAf8-0000eA-Gl for bug-gnu-emacs@gnu.org; Mon, 02 Jan 2017 17:01:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1cOAf8-00031O-9u for bug-gnu-emacs@gnu.org; Mon, 02 Jan 2017 17:01:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 02 Jan 2017 22:01:02 +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.14833944088155 (code B ref 20462); Mon, 02 Jan 2017 22:01:02 +0000 Original-Received: (at 20462) by debbugs.gnu.org; 2 Jan 2017 22:00:08 +0000 Original-Received: from localhost ([127.0.0.1]:39785 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cOAeG-00027C-8Z for submit@debbugs.gnu.org; Mon, 02 Jan 2017 17:00:08 -0500 Original-Received: from userp1040.oracle.com ([156.151.31.81]:32739) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cOAeD-000213-SV for 20462@debbugs.gnu.org; Mon, 02 Jan 2017 17:00:06 -0500 Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id v02Lxvju021277 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for <20462@debbugs.gnu.org>; Mon, 2 Jan 2017 21:59:58 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserv0021.oracle.com (8.13.8/8.14.4) with ESMTP id v02LxvXi011249 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for <20462@debbugs.gnu.org>; Mon, 2 Jan 2017 21:59:57 GMT Original-Received: from abhmp0011.oracle.com (abhmp0011.oracle.com [141.146.116.17]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id v02LxuWB004713 for <20462@debbugs.gnu.org>; Mon, 2 Jan 2017 21:59:57 GMT In-Reply-To: <0c1fb227-fad9-4410-a08d-96602eb39db3@default> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 12.0.6753.5000 (x86)] X-Source-IP: aserv0021.oracle.com [141.146.126.233] 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:127687 Archived-At: In addition, I think it would be good if the doc for the mode either mentioned whether the mode is currently on or (at least) mentioned the associated variable, letting users know that the value of that variable will tell them whether it is currently on or off. (They might also need to be told that they need to examine the variable value in the appropriate buffer. Or else clicking the variable link in the doc for the function should evaluate it in the proper buffer (same buffer that the function doc was invoked from).