From unknown Tue Jun 17 22:07:54 2025 X-Loop: help-debbugs@gnu.org Subject: bug#41884: 27.0.91; `C-h f whitespace-mode' doesn't say that it's a minor mode Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 15 Jun 2020 22:37:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 41884 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 41884@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.159226058414157 (code B ref -1); Mon, 15 Jun 2020 22:37:01 +0000 Received: (at submit) by debbugs.gnu.org; 15 Jun 2020 22:36:24 +0000 Received: from localhost ([127.0.0.1]:47632 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jkxiK-0003gG-E2 for submit@debbugs.gnu.org; Mon, 15 Jun 2020 18:36:24 -0400 Received: from lists.gnu.org ([209.51.188.17]:42130) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jkxiI-0003g9-Jl for submit@debbugs.gnu.org; Mon, 15 Jun 2020 18:36:23 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:53140) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jkxiI-0003wL-CO for bug-gnu-emacs@gnu.org; Mon, 15 Jun 2020 18:36:22 -0400 Received: from aserp2120.oracle.com ([141.146.126.78]:57596) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jkxiG-0001fV-FK for bug-gnu-emacs@gnu.org; Mon, 15 Jun 2020 18:36:21 -0400 Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 05FMWkjl129409 for ; Mon, 15 Jun 2020 22:36:13 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2020-01-29; bh=GTrZEnqid2MIaAuS4QpxCzqXg+vS/cH4in9aqM4I2D4=; b=Vus6Ap6mD6AlzSEPxFQJBwQ6Dq9vkiD+tL4jI+wYWpeMdxdUbVCx2IDtVw+j99ER09y3 I1jjOu9kWd9pEzW7n+yEk/4K9HP1HWvyxY1VOAv4vxYTzp0cdnsY04/1SxSGRXBaOqPp 5+WpaIQxUI0Vn0xxBaxldRMAfzwqQPfNIUJTM++heJX92d2aO502a8FjEG61qCo3CnB5 KMCzYdfDmDvsps4SuQYM+UUxOn3hdv7CK46dYS2aC3cVE19oXLT+8OU5v924xULNKDbF KO9PdeDsjAxADsqKpRwF2bK82vU/JSed38o+UgYdFUk8RZDNEkaoD2CtvnxgG1EU/E5K 4g== Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by aserp2120.oracle.com with ESMTP id 31p6e7uh8t-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL) for ; Mon, 15 Jun 2020 22:36:13 +0000 Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 05FMS5bw180157 for ; Mon, 15 Jun 2020 22:36:12 GMT Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userp3030.oracle.com with ESMTP id 31p6s6827w-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 15 Jun 2020 22:36:12 +0000 Received: from abhmp0019.oracle.com (abhmp0019.oracle.com [141.146.116.25]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id 05FMaBve010904 for ; Mon, 15 Jun 2020 22:36:11 GMT MIME-Version: 1.0 Message-ID: <2f814ee0-f472-43f6-878b-a9c9489d771e@default> Date: Mon, 15 Jun 2020 15:36:10 -0700 (PDT) From: Drew Adams X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.5005.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9653 signatures=668680 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 malwarescore=0 suspectscore=1 mlxlogscore=904 adultscore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2004280000 definitions=main-2006150159 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9653 signatures=668680 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 adultscore=0 spamscore=0 impostorscore=0 bulkscore=0 clxscore=1015 malwarescore=0 suspectscore=1 mlxscore=0 phishscore=0 mlxlogscore=927 lowpriorityscore=0 cotscore=-2147483648 priorityscore=1501 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2004280000 definitions=main-2006150159 Received-SPF: pass client-ip=141.146.126.78; envelope-from=drew.adams@oracle.com; helo=aserp2120.oracle.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/06/15 18:36:17 X-ACL-Warn: Detected OS = Linux 3.1-3.10 [fuzzy] X-Spam_score_int: -63 X-Spam_score: -6.4 X-Spam_bar: ------ X-Spam_report: (-6.4 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-1, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H2=-1, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=_AUTOLEARN X-Spam_action: no action X-Spam-Score: -1.3 (-) 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: -2.3 (--) Subject line says it all. The doc string for a minor mode should tell you it's a minor mode. In GNU Emacs 27.0.91 (build 1, x86_64-w64-mingw32) of 2020-04-20 built on CIRROCUMULUS Repository revision: c36c5a3dedbb2e0349be1b6c3b7567ea7b594f1c Repository branch: HEAD Windowing system distributor 'Microsoft Corp.', version 10.0.18362 System Description: Microsoft Windows 10 Pro (v10.0.1903.18362.836) 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 unknown Tue Jun 17 22:07:54 2025 X-Loop: help-debbugs@gnu.org Subject: bug#41884: 27.0.91; `C-h f whitespace-mode' doesn't say that it's a minor mode Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 02 Aug 2020 10:48:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 41884 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams , 41884@debbugs.gnu.org Received: via spool by 41884-submit@debbugs.gnu.org id=B41884.159636524313963 (code B ref 41884); Sun, 02 Aug 2020 10:48:02 +0000 Received: (at 41884) by debbugs.gnu.org; 2 Aug 2020 10:47:23 +0000 Received: from localhost ([127.0.0.1]:41798 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k2BWU-0003cx-QM for submit@debbugs.gnu.org; Sun, 02 Aug 2020 06:47:22 -0400 Received: from mail-yb1-f170.google.com ([209.85.219.170]:36607) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k2BWT-0003Xv-08 for 41884@debbugs.gnu.org; Sun, 02 Aug 2020 06:47:22 -0400 Received: by mail-yb1-f170.google.com with SMTP id n141so16480624ybf.3 for <41884@debbugs.gnu.org>; Sun, 02 Aug 2020 03:47:20 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:in-reply-to:references:mime-version:date:message-id:subject:to; bh=bflp+JEchCzMSPAftrY2vSi05cbHg/3BG0aX+4cmuhs=; b=aECUI8+2s+nSWFZUqPe/v7xYUuV5/3PNan8+vvF+n3jv3Wl+1hvsTLrDafX0660CDD Q/VTXUrvvCtbFpi7D2YnlrJxGB92beWZkyFfkeX4XWe1YNcdqn3fbgsFNEI82VEEWfkj vxRdc5b/WswMulGNwXV1JmxwwFFDI5mAq468Ww9LZaRa7gn9HoLkv8o9b0oX2am/PjYC 2GpZSID5n06wHyZmWD9evoQhR9iFJOzXCoxRk4uFIkLOTIC02QPOSnJSD81vWYmBj7Uy ywKLnclkYJajcuQm2TjdA1/3xihaRg+PpE0G24U3cPDN4xlmno/UWWmjf73J3WqZmsh+ CecQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:in-reply-to:references:mime-version:date :message-id:subject:to; bh=bflp+JEchCzMSPAftrY2vSi05cbHg/3BG0aX+4cmuhs=; b=jLCoJRVS1YPAQaqhOx78q7YeKdHD7KSFEjIWSYJABAqg9uCtosB7a8Lbjgvj8mlmPw zFykeml9hhkSWYuQVjDGqKhvobP9qNvSDqEFYBOiBomTVyyYh7dN0m3Ra+BfB1ZElNdX d9HNmFZ6kC31SWUveU++yq8OHZ54nQB3ndbf8kcaURIHkAvu/TyL3LXErbA7GrSPwF/b 20M+aINxcNDhT/T1ZgnpiqOnoR8v3ffMed19i0YfvIJx4joLvDjHU2YwgqSvm7pvWx2B L3vXtaOcaDWoF3/EaVAACz/IPlB04zNWysITrcmTfa1BVJPRSmiTvBIf4BC3iq2tKWMZ wLhw== X-Gm-Message-State: AOAM5324QQPmmeza1aBuqu6o1JvAfT5R4wHOsgTrcP3jF80qa5b9zMAh EMWmyB9rqIMi/HqUdL543Jr1LspK3AYJ5CFXGgg= X-Google-Smtp-Source: ABdhPJwNbwwv2XcV1CpfEFd6XoBuf02ibqaH61QGNNo6j26oKFYSjCWqCFOrJhg1orzP/hBEegNdRwQsZsiYfd+cTck= X-Received: by 2002:a25:880e:: with SMTP id c14mr18969991ybl.181.1596365235328; Sun, 02 Aug 2020 03:47:15 -0700 (PDT) Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sun, 2 Aug 2020 03:47:14 -0700 From: Stefan Kangas In-Reply-To: <2f814ee0-f472-43f6-878b-a9c9489d771e@default> References: <2f814ee0-f472-43f6-878b-a9c9489d771e@default> MIME-Version: 1.0 Date: Sun, 2 Aug 2020 03:47:14 -0700 Message-ID: Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 0.0 (/) 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 (-) Drew Adams writes: > Subject line says it all. The doc string for a minor mode should tell > you it's a minor mode. Should all minor modes say this? Because there are more examples of modes that don't, such as: - display-line-numbers-mode - whitespace-newline-mode This is just from taking a quick look. Best regards, Stefan Kangas From unknown Tue Jun 17 22:07:54 2025 X-Loop: help-debbugs@gnu.org Subject: bug#41884: 27.0.91; `C-h f whitespace-mode' doesn't say that it's a minor mode Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 02 Aug 2020 14:26:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 41884 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Stefan Kangas Cc: 41884@debbugs.gnu.org, drew.adams@oracle.com Received: via spool by 41884-submit@debbugs.gnu.org id=B41884.159637835329346 (code B ref 41884); Sun, 02 Aug 2020 14:26:01 +0000 Received: (at 41884) by debbugs.gnu.org; 2 Aug 2020 14:25:53 +0000 Received: from localhost ([127.0.0.1]:43090 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k2Evw-0007dG-Of for submit@debbugs.gnu.org; Sun, 02 Aug 2020 10:25:52 -0400 Received: from eggs.gnu.org ([209.51.188.92]:46558) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k2Evv-0007d2-P8 for 41884@debbugs.gnu.org; Sun, 02 Aug 2020 10:25:52 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:50942) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1k2Evp-0004Vh-Qv; Sun, 02 Aug 2020 10:25:45 -0400 Received: from [176.228.60.248] (port=1581 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1k2Evm-0000PD-0B; Sun, 02 Aug 2020 10:25:45 -0400 Date: Sun, 02 Aug 2020 17:25:26 +0300 Message-Id: <833655ceg9.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: (message from Stefan Kangas on Sun, 2 Aug 2020 03:47:14 -0700) References: <2f814ee0-f472-43f6-878b-a9c9489d771e@default> X-Spam-Score: -2.3 (--) 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 (---) > From: Stefan Kangas > Date: Sun, 2 Aug 2020 03:47:14 -0700 > > Drew Adams writes: > > > Subject line says it all. The doc string for a minor mode should tell > > you it's a minor mode. > > Should all minor modes say this? No, they don't. From unknown Tue Jun 17 22:07:54 2025 X-Loop: help-debbugs@gnu.org Subject: bug#41884: 27.0.91; `C-h f whitespace-mode' doesn't say that it's a minor mode Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 02 Aug 2020 16:28:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 41884 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Stefan Kangas , 41884@debbugs.gnu.org Received: via spool by 41884-submit@debbugs.gnu.org id=B41884.159638567316716 (code B ref 41884); Sun, 02 Aug 2020 16:28:02 +0000 Received: (at 41884) by debbugs.gnu.org; 2 Aug 2020 16:27:53 +0000 Received: from localhost ([127.0.0.1]:43262 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k2Gq0-0004LY-TC for submit@debbugs.gnu.org; Sun, 02 Aug 2020 12:27:53 -0400 Received: from userp2120.oracle.com ([156.151.31.85]:57712) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k2Gpx-0004LJ-NB for 41884@debbugs.gnu.org; Sun, 02 Aug 2020 12:27:52 -0400 Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 072GP33j007886; Sun, 2 Aug 2020 16:27:44 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2020-01-29; bh=zFdVH0sry8R4snwtVpIgxcg51nDApjCBw2g3+xAswT4=; b=b+l+LLEKnL2LIj8rBBqHlOtA91jxDL7wJ/0cdX3w173vygICAtnt0ulEt0qgIIYClOnA 7w/TUKDij/m7qNNu2cDkYpUafpt3Dg8TYLdZCDnDryWj0PLizwRR+ybrUGj2ylOhW5EP bx0oejdS80q8VhSZScex2H9kosi7rvKMeSGCodMNgP+R66YVBH8SU+GQ/F0s7n/FYWGe o2uAng75bNVUU3Do9fqbpYnbPwA8nWOPtMAsi3VHi8GmiXEQ49In2OaHfFuVbs2+yToL D5LQLzeFIoLoqm7t2LYAbZItQYdDoHSrzrIfKWvdb2y4N2Z9yDpOlcxVbkAPqTEtEAZf tg== Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by userp2120.oracle.com with ESMTP id 32n11mu5xr-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Sun, 02 Aug 2020 16:27:43 +0000 Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 072GInWd160169; Sun, 2 Aug 2020 16:27:43 GMT Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userp3020.oracle.com with ESMTP id 32nj5nwt1w-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 02 Aug 2020 16:27:43 +0000 Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id 072GRg2N022842; Sun, 2 Aug 2020 16:27:42 GMT MIME-Version: 1.0 Message-ID: <81a68df2-ac5b-47f2-bbfb-1ea37c67426f@default> Date: Sun, 2 Aug 2020 09:27:41 -0700 (PDT) From: Drew Adams References: <2f814ee0-f472-43f6-878b-a9c9489d771e@default> In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.5017.0 (x86)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9701 signatures=668679 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxlogscore=999 mlxscore=0 spamscore=0 phishscore=0 suspectscore=0 adultscore=0 bulkscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2006250000 definitions=main-2008020127 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9701 signatures=668679 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 clxscore=1011 priorityscore=1501 impostorscore=0 lowpriorityscore=0 malwarescore=0 spamscore=0 mlxscore=0 suspectscore=0 mlxlogscore=999 phishscore=0 adultscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2006250000 definitions=main-2008020127 X-Spam-Score: -2.3 (--) 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 (---) > > The doc string for a minor mode should tell > > you it's a minor mode. >=20 > Should all minor modes say this? Because there are more examples of > modes that don't, such as: > - display-line-numbers-mode > - whitespace-newline-mode >=20 > This is just from taking a quick look. Yes, IMO they should. Otherwise, how will users know? (OK, there are ways...) Knowing a command is a minor mode is very important to understanding its use. It's could even be argued that it's the most important thing to know about it. ____ More generally, I think a failing of some minor-mode doc strings is that they don't tell you the basics of what the doc string of `define-minor-mode' tells you, e.g. how to turn the mode on/off, both interactively and from Lisp. This related problem has been taken care of here and there over the years, bit by bit, from bug reports etc. But I think the problem is still present here and there. Anyway, this bug report is only about `whitespace-mode'. If someone wants to fix its problem along with that of other minor-mode commands, please do. From unknown Tue Jun 17 22:07:54 2025 X-Loop: help-debbugs@gnu.org Subject: bug#41884: 27.0.91; `C-h f whitespace-mode' doesn't say that it's a minor mode Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 02 Aug 2020 16:29:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 41884 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Eli Zaretskii , Stefan Kangas Cc: 41884@debbugs.gnu.org, drew.adams@oracle.com Received: via spool by 41884-submit@debbugs.gnu.org id=B41884.159638568716767 (code B ref 41884); Sun, 02 Aug 2020 16:29:01 +0000 Received: (at 41884) by debbugs.gnu.org; 2 Aug 2020 16:28:07 +0000 Received: from localhost ([127.0.0.1]:43267 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k2GqF-0004MN-6z for submit@debbugs.gnu.org; Sun, 02 Aug 2020 12:28:07 -0400 Received: from userp2130.oracle.com ([156.151.31.86]:54596) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1k2GqC-0004Lm-Rr for 41884@debbugs.gnu.org; Sun, 02 Aug 2020 12:28:06 -0400 Received: from pps.filterd (userp2130.oracle.com [127.0.0.1]) by userp2130.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 072GRwDG118467; Sun, 2 Aug 2020 16:27:59 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2020-01-29; bh=TyaUJxWnLCtldQPuBwacb6yzPyDtAYOHxSmB0ASX92Q=; b=O0oNGzo70rAnHCHTYz/pjPZwOZm6fwGe5+qsK1U8TWdpSlJDFQnnAE/2fsqrD73p01Jv PwMsrYPT1+cRYpOh1bNpMSSA8hgVVBplrp+9NBY1HVlWamJAgyh8cghPOzG/nI+dfaZC 9negG7JOX0oKwiuQ+PA1a/qmKXpxYcDRxhC27M+B79Q289uwoEBSSe9EFBUxRqSedMQ1 ND0kV4fegir9uC8Xssm9Wtd5AaIfJtHFfSjiWpPWj8xPlONufQroidOdXkSc6FraGyuQ wIPQMytvbb2/z7tRp0+Wav0X7YPXqhS1IYtrWwcG3vaJkaNj+ztvbmDR24hoMvZOuRt1 rg== Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by userp2130.oracle.com with ESMTP id 32mytquax5-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Sun, 02 Aug 2020 16:27:59 +0000 Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 072GRanE158584; Sun, 2 Aug 2020 16:27:58 GMT Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by userp3030.oracle.com with ESMTP id 32njatxg3u-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 02 Aug 2020 16:27:58 +0000 Received: from abhmp0018.oracle.com (abhmp0018.oracle.com [141.146.116.24]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id 072GRwdh007688; Sun, 2 Aug 2020 16:27:58 GMT MIME-Version: 1.0 Message-ID: <25af197b-05fb-4193-b617-a7d25fe43fd9@default> Date: Sun, 2 Aug 2020 09:27:56 -0700 (PDT) From: Drew Adams References: <<2f814ee0-f472-43f6-878b-a9c9489d771e@default>> <> <<833655ceg9.fsf@gnu.org>> In-Reply-To: <<833655ceg9.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.5017.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9701 signatures=668679 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 bulkscore=0 phishscore=0 mlxlogscore=999 mlxscore=0 spamscore=0 malwarescore=0 adultscore=0 suspectscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2006250000 definitions=main-2008020128 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9701 signatures=668679 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 impostorscore=0 mlxlogscore=999 bulkscore=0 malwarescore=0 spamscore=0 suspectscore=0 adultscore=0 mlxscore=0 priorityscore=1501 lowpriorityscore=0 clxscore=1015 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2006250000 definitions=main-2008020128 X-Spam-Score: -2.3 (--) 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 (---) > > > The doc string for a minor mode should tell > > > you it's a minor mode. > > > > Should all minor modes say this? >=20 > No, they don't. That wasn't Stefan's question. Should they? I think they should. Typically it takes only adding the words "minor mode". In the case of `whitespace-mode' it takes only adding the word "minor": Toggle whitespace visualization (Whitespace minor mode). I can't imagine why we _wouldn't_ want to tell users this in the doc string. ____ [And, for the related problem that crops up wrt minor-mode command doc strings - of not always documenting well how to turn the mode on/off: if someone decides to opt for a simple one-size fits all fix, then that could be to just provide a link to the doc about minor modes in each minor-mode doc string. IOW, once every minor-mode doc string says that it's about a minor mode, a simple link to the doc that tells you about minor modes would take care of lacunae such as the doc string neglecting to tell you clearly how to turn it on/off. (It's still better to give that info directly in the doc string, IMO, but such a link would make sure to cover any such omission.)] From unknown Tue Jun 17 22:07:54 2025 X-Loop: help-debbugs@gnu.org Subject: bug#41884: bug#29497: 26.0.90; doc strings of minor modes Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 30 Jun 2021 13:33:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 41884 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams Cc: 41884@debbugs.gnu.org, 29497@debbugs.gnu.org Received: via spool by 41884-submit@debbugs.gnu.org id=B41884.162505992622958 (code B ref 41884); Wed, 30 Jun 2021 13:33:03 +0000 Received: (at 41884) by debbugs.gnu.org; 30 Jun 2021 13:32:06 +0000 Received: from localhost ([127.0.0.1]:56936 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lyaJx-0005xv-TT for submit@debbugs.gnu.org; Wed, 30 Jun 2021 09:32:06 -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 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-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