From unknown Wed Jun 18 00:29:12 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#29497 <29497@debbugs.gnu.org> To: bug#29497 <29497@debbugs.gnu.org> Subject: Status: 26.0.90; doc strings of minor modes Reply-To: bug#29497 <29497@debbugs.gnu.org> Date: Wed, 18 Jun 2025 07:29:12 +0000 retitle 29497 26.0.90; doc strings of minor modes reassign 29497 emacs submitter 29497 Drew Adams severity 29497 wishlist thanks From debbugs-submit-bounces@debbugs.gnu.org Tue Nov 28 23:47:21 2017 Received: (at submit) by debbugs.gnu.org; 29 Nov 2017 04:47:21 +0000 Received: from localhost ([127.0.0.1]:35543 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eJuHJ-0000Nb-7A for submit@debbugs.gnu.org; Tue, 28 Nov 2017 23:47:21 -0500 Received: from eggs.gnu.org ([208.118.235.92]:58153) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eJuHE-0000NH-Ef for submit@debbugs.gnu.org; Tue, 28 Nov 2017 23:47:16 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eJuH8-0004un-3G for submit@debbugs.gnu.org; Tue, 28 Nov 2017 23:47:11 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:35141) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1eJuH8-0004ug-0D for submit@debbugs.gnu.org; Tue, 28 Nov 2017 23:47:10 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:49075) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eJuH6-0005DO-OY for bug-gnu-emacs@gnu.org; Tue, 28 Nov 2017 23:47:09 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eJuH3-0004qc-K1 for bug-gnu-emacs@gnu.org; Tue, 28 Nov 2017 23:47:08 -0500 Received: from userp1040.oracle.com ([156.151.31.81]:49381) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1eJuH3-0004q7-BQ for bug-gnu-emacs@gnu.org; Tue, 28 Nov 2017 23:47:05 -0500 Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id vAT4l3LN028627 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 29 Nov 2017 04:47:03 GMT Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userv0022.oracle.com (8.14.4/8.14.4) with ESMTP id vAT4l2uv026862 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Wed, 29 Nov 2017 04:47:03 GMT Received: from abhmp0019.oracle.com (abhmp0019.oracle.com [141.146.116.25]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id vAT4l28I023991 for ; Wed, 29 Nov 2017 04:47:02 GMT MIME-Version: 1.0 Message-ID: Date: Tue, 28 Nov 2017 20:47:01 -0800 (PST) From: Drew Adams To: bug-gnu-emacs@gnu.org Subject: 26.0.90; doc strings of minor modes X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4615.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0022.oracle.com [156.151.31.74] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) Other bug reports have requested that minor-mode doc strings follow more closely what `define-minor-mode' has to say about minor modes. This request adds to that. How about trying to have `C-h f' somehow detect minor-mode commands (at least those created by `define-minor-mode', and change the first line of help output. Instead of something like this: abbrev-mode is an interactive compiled Lisp function in `abbrev.el'. It might say something like this: abbrev-mode is a compiled minor-mode command in `abbrev.el'. Or perhaps the fact that the command is a minor-mode command could just be added systematically to the doc string itself. Indicating to users in some way that the command is a minor-mode command would be helpful. In GNU Emacs 26.0.90 (build 3, x86_64-w64-mingw32) of 2017-10-13 built on LAPHROAIG Repository revision: 906224eba147bdfc0514090064e8e8f53160f1d4 Windowing system distributor 'Microsoft Corp.', version 6.1.7601 Recent messages: For information about GNU Emacs and the GNU system, type C-h C-a. Configured using: 'configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3'' Configured features: XPM JPEG TIFF GIF PNG RSVG SOUND NOTIFY ACL GNUTLS LIBXML2 ZLIB TOOLKIT_SCROLL_BARS From debbugs-submit-bounces@debbugs.gnu.org Thu Jan 10 18:35:09 2019 Received: (at control) by debbugs.gnu.org; 10 Jan 2019 23:35:09 +0000 Received: from localhost ([127.0.0.1]:54388 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ghjqu-0006Sc-Mx for submit@debbugs.gnu.org; Thu, 10 Jan 2019 18:35:09 -0500 Received: from eggs.gnu.org ([209.51.188.92]:38340) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ghjqt-0006S1-1H for control@debbugs.gnu.org; Thu, 10 Jan 2019 18:35:07 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]:50052) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ghjqn-00037t-QZ for control@debbugs.gnu.org; Thu, 10 Jan 2019 18:35:01 -0500 Received: from rgm by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1ghjqn-0001TR-O3 for control@debbugs.gnu.org; Thu, 10 Jan 2019 18:35:01 -0500 Subject: control message for bug 29497 To: X-Mailer: mail (GNU Mailutils 2.99.98) Message-Id: From: Glenn Morris Date: Thu, 10 Jan 2019 18:35:01 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) merge 20462 29497 From debbugs-submit-bounces@debbugs.gnu.org Mon Jun 15 19:06:23 2020 Received: (at control) by debbugs.gnu.org; 15 Jun 2020 23:06:23 +0000 Received: from localhost ([127.0.0.1]:47653 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jkyBL-0004S1-0F for submit@debbugs.gnu.org; Mon, 15 Jun 2020 19:06:23 -0400 Received: from eggs.gnu.org ([209.51.188.92]:43256) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jkyBJ-0004Rm-2O for control@debbugs.gnu.org; Mon, 15 Jun 2020 19:06:21 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:45643) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jkyBD-0006Pj-Sb for control@debbugs.gnu.org; Mon, 15 Jun 2020 19:06:15 -0400 Received: from rgm by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1jkyB1-0006Lt-St for control@debbugs.gnu.org; Mon, 15 Jun 2020 19:06:05 -0400 Subject: control message for bug 41884 To: X-Mailer: mail (GNU Mailutils 2.99.98) Message-Id: From: Glenn Morris Date: Mon, 15 Jun 2020 19:06:03 -0400 X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) forcemerge 20462 41884 From debbugs-submit-bounces@debbugs.gnu.org Wed Jun 30 09:32:05 2021 Received: (at 29497) by debbugs.gnu.org; 30 Jun 2021 13:32:06 +0000 Received: from localhost ([127.0.0.1]:56934 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lyaJx-0005xg-FY for submit@debbugs.gnu.org; Wed, 30 Jun 2021 09:32:05 -0400 Received: from quimby.gnus.org ([95.216.78.240]:58162) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lyaJq-0005oy-S3; Wed, 30 Jun 2021 09:31:59 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Content-Type:MIME-Version:Message-ID:In-Reply-To:Date: References:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=kBYB9KJe7pLI2FWw070FlbVs7BP2P4uJ9oOL2I1dhME=; b=k0MCpnc+SJTB4hUCp1Vf2Jaonl 3AEG+PtZBq6kvrDvZ0TnXCU4l8XDjEOI8Y3RtOeoZwIyXms3wyF+6RxUtE9TDzIzAxxZ1+cF3jk0f LoqoFVdqIRPDmIaWqpWyt3x186lJFbHXOU7RNY0mqeSqbZ0rpV+FoWunVO/MGJ7DiX14=; Received: from cm-84.212.220.105.getinternet.no ([84.212.220.105] helo=elva) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1lyaJg-0002CT-AS; Wed, 30 Jun 2021 15:31:52 +0200 From: Lars Ingebrigtsen To: Drew Adams Subject: Re: bug#29497: 26.0.90; doc strings of minor modes References: <2f814ee0-f472-43f6-878b-a9c9489d771e@default> X-Now-Playing: Jim O'Rourke's _To Magnetize Money and Return a Roving Eye (2)_: "To Magnetize Money and Return a Roving Eye pt2" Date: Wed, 30 Jun 2021 15:31:47 +0200 In-Reply-To: <2f814ee0-f472-43f6-878b-a9c9489d771e@default> (Drew Adams's message of "Mon, 15 Jun 2020 15:36:10 -0700 (PDT)") Message-ID: <878s2r4gxo.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Drew Adams writes: > Subject line says it all. The doc string for a minor mode should tell > you it's a minor mode. I've now added this to the Emacs 28 minor mode doc strings. Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 29497 Cc: 41884@debbugs.gnu.org, 29497@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Drew Adams writes: > Subject line says it all. The doc string for a minor mode should tell > you it's a minor mode. I've now added this to the Emacs 28 minor mode doc strings. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Wed Jun 30 09:32:11 2021 Received: (at control) by debbugs.gnu.org; 30 Jun 2021 13:32:11 +0000 Received: from localhost ([127.0.0.1]:56941 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lyaK2-00061v-Qb for submit@debbugs.gnu.org; Wed, 30 Jun 2021 09:32:11 -0400 Received: from quimby.gnus.org ([95.216.78.240]:58176) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lyaJw-0005t7-3G for control@debbugs.gnu.org; Wed, 30 Jun 2021 09:32:05 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org; s=20200322; h=Subject:From:To:Message-Id:Date:Sender:Reply-To:Cc: MIME-Version:Content-Type:Content-Transfer-Encoding:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=6V6iVdOjidIAS8w5ZuNdbOJ2C5bTtdDslUklnBD6JvI=; b=CqPw+1LmQ6sv1nas9m+KbXReuR c9IJabl7R8yLZrcexr/fMf+HXTh5PRAoCchyLPjS6wALyeF41/hLIkWeMZiH0F/BC97XczOB8I7YK J3EUBY4F3i9ymsGHLspJELqnB5ufN7Rt6C0fYHrVpO5ILfBlnxFtB3NeoXoL4cdz1wJU=; Received: from cm-84.212.220.105.getinternet.no ([84.212.220.105] helo=elva) by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1lyaJn-0002Ca-JD for control@debbugs.gnu.org; Wed, 30 Jun 2021 15:31:58 +0200 Date: Wed, 30 Jun 2021 15:31:55 +0200 Message-Id: <877dib4gxg.fsf@gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #29497 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: close 29497 28.1 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) close 29497 28.1 quit From unknown Wed Jun 18 00:29:12 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Thu, 29 Jul 2021 11:24:04 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator