From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#52007: 26.3; Doc of `define-globalized-minor-mode' and global(ized) minor modes Date: Sat, 20 Nov 2021 22:44:23 +0000 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="24361"; mail-complaints-to="usenet@ciao.gmane.io" To: 52007@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Nov 20 23:45:11 2021 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1moZ6d-00066Z-IY for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 20 Nov 2021 23:45:11 +0100 Original-Received: from localhost ([::1]:42866 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1moZ6c-00056M-KU for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 20 Nov 2021 17:45:10 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:50768) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1moZ6U-00056D-IA for bug-gnu-emacs@gnu.org; Sat, 20 Nov 2021 17:45:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:60504) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1moZ6U-0002ll-8d for bug-gnu-emacs@gnu.org; Sat, 20 Nov 2021 17:45:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1moZ6T-0004xw-Ro for bug-gnu-emacs@gnu.org; Sat, 20 Nov 2021 17:45:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 20 Nov 2021 22:45:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 52007 X-GNU-PR-Package: emacs X-Debbugs-Original-To: "bug-gnu-emacs@gnu.org" Original-Received: via spool by submit@debbugs.gnu.org id=B.163744827819036 (code B ref -1); Sat, 20 Nov 2021 22:45:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 20 Nov 2021 22:44:38 +0000 Original-Received: from localhost ([127.0.0.1]:43817 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1moZ66-0004wy-9K for submit@debbugs.gnu.org; Sat, 20 Nov 2021 17:44:38 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:44310) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1moZ61-0004wj-90 for submit@debbugs.gnu.org; Sat, 20 Nov 2021 17:44:37 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:50702) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1moZ61-0004wO-0N for bug-gnu-emacs@gnu.org; Sat, 20 Nov 2021 17:44:33 -0500 Original-Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]:62340) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1moZ5y-0002iO-Bk for bug-gnu-emacs@gnu.org; Sat, 20 Nov 2021 17:44:32 -0500 Original-Received: from pps.filterd (m0246631.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.16.1.2/8.16.1.2) with SMTP id 1AKKIBvX003729 for ; Sat, 20 Nov 2021 22:44:26 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : subject : date : message-id : content-type : content-transfer-encoding : mime-version; s=corp-2021-07-09; bh=nC5ADKorE8oK2/hvjUXfpMhYWZz3uwHVh+PveJgdH4s=; b=iPrA3QonGniSiGal5JblfpeDvsxzjOvnXhqglYSZ9sntmpZZumz1HveouefdPEG6JHBp 2GrMuZEfcOlwNI40D/mhe3z1CzmWZ5t/nmxFhVHAKTSm8j6POCfsfC5ZhFYlchZz3+s/ UCKXeCSi1xvnnSYvQSoLkF2kaLHAAG6K5+eGYXpJqvnWIBHN6HLohJZHjgCECMjYCFc9 KOyV1f9SGQJcihSeSL+QcEhfPLOmwUPIjCUGjQr6LAF9EAjwnwaOtt1iSqgi4NyARAkL QdrSwU4DbS0eEB1HwjtXXXbLUuZ2Mzdlv8hSlBdNDbRnaEYcP/XDG2H2EUEk3GCqqAlT SQ== Original-Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by mx0b-00069f02.pphosted.com with ESMTP id 3ceqt22nsk-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sat, 20 Nov 2021 22:44:26 +0000 Original-Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.1.2/8.16.1.2) with SMTP id 1AKMaRBv123311 for ; Sat, 20 Nov 2021 22:44:25 GMT Original-Received: from nam10-dm6-obe.outbound.protection.outlook.com (mail-dm6nam10lp2101.outbound.protection.outlook.com [104.47.58.101]) by userp3030.oracle.com with ESMTP id 3cep4uxu6a-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sat, 20 Nov 2021 22:44:25 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=OLwztdeMMd06OVz6L4ulr30GFS39CEEejhbqxnE7VKEcO/kkhglwA7OqXmETQOm8Dz1T0fNyYMwloJsE37Hu8Ee7Q9pwqV8+00fpCS3TbyHHHU1NzQ1U4q8hge7/I++90h4lcJBYx+NhVXs1AyEwc2lo6H9NWcxXZedj0ii+4jAULj5LddC/eTMvPzaa1cDVcrXHW9yr/n9d6LeTi6Eh8uYrLmIe42muYNpWTLa9RHo4YEUOhSw7LQ6qudiIw0CfEUs6mPQjnRB5JHPL3Yv8DBwQV74QbuhksMYnocRaRdvw4btc94MrYAyUKNSLJ9+h/IaZhXsAVFTC/sb8ISG+Uw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=nC5ADKorE8oK2/hvjUXfpMhYWZz3uwHVh+PveJgdH4s=; b=eFi+Hne5UCKed2EZqfw5NGXulHumw9O30Epu2OnpHGo5vTLPJaMmM6rOwMtpxxuxyrDDQrCtrrlLu0225GWSKoN3llhMjwuicyeQYUL5xMr5abJEvEj+i2+7M7OyiRq0JxbTnBX0PTyDhV1Z7lAt/ionrLLFySGLQUM+hatWlnb/g2cJOLIGZTsqRKvbZ5kivpc6wXX5OaCesF6GFe5Cf6TaPf4qnfLqL/gKv/s2VNPdBvt7sW+9/OWbCFDiwsmMjgyI0FCq+L43MkCLSrJoqOC4k2XvQSZyYoLiB3rqnalihTUGB2Nemmn3j/DiAME7yh7BSSiLPT839WrzWHbyLg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com; dkim=pass header.d=oracle.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=nC5ADKorE8oK2/hvjUXfpMhYWZz3uwHVh+PveJgdH4s=; b=SxlzMKQ2vB1M0BztiaToVeYfqkXk26YJOgGpaM6LfWpDCO8Rr8BesgAYrtXhXYL7vyeCRIkkEzE2UaLK6Gi6AyGaAAHnkY3FybFdjftbwkviW8BNOK4Ft9IHfhlv/UN//mIoVgk9LN76891WbUEK1+G07EQFmtpH9i8g+Kqap8g= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by SJ0PR10MB5664.namprd10.prod.outlook.com (2603:10b6:a03:3da::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4713.22; Sat, 20 Nov 2021 22:44:23 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::4588:646c:e330:8bc0]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::4588:646c:e330:8bc0%7]) with mapi id 15.20.4713.022; Sat, 20 Nov 2021 22:44:23 +0000 Thread-Topic: 26.3; Doc of `define-globalized-minor-mode' and global(ized) minor modes Thread-Index: AdfeXz7OcZHuD8yNSvCGxAGAhpPXwQ== Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 4b6f35b0-b3e9-4a3c-f62d-08d9ac774c6a x-ms-traffictypediagnostic: SJ0PR10MB5664: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:6108; x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: uuAAKmtBpc9haBodVU0Qq4hzhJgbm7+fRstVn9xMpF9qQxjgmR+ErWifp7KB+yHKey5P0H7sIrW2nrTXG7FN7eZmXtVRFnikffKr/PzWGQqv1GfDHDKXh5eBYlzXx2pEtMs6IypDGXtJsIZOm1W+jBTR1VEVBbedna4qz6CxbulF9bbqxMZiyUAbpAxnkpiKZEt6GU7Rrhzih8dHCBGRyh5HNc3j2JTSf27skvugcu+/5PgCByiIBhd370acrThwPWul6JlpzX6Xnf6D8p+a/SSU06Vr9beRiiObia/tRN1ChdNaR08oQazc/t7ojyxmfSgjJKaLTFSmv4vPq5iu2SfrqBM7EvdZQgpDqYr4RwhA6wTQ0eeD3OcFBOM0zrC/B22ebcSnQpo+9dJXteDcI/xT19zhEnBzTeFIECQ06dncdtWWYN9bFhiiGQsFWhKIpk4ap3RbXA8/rSVotUCtXG11E0Fv8o4n/cZv73pfnW2v5he4/LDOGIXFwmqeQVlZtBoVqHvI9Q57e0jDCEBHnPAz3cqN7n9fcEcPgIwPAWkqGNV+O2rqLvXnww38TNRZQtYLm2V14NjkZzthBqKWvWGH/9PDnC96P8y/krZl5buAtfgQY0MzQW4BGQUdE5RlKS2742vCf9yI0Erahr3aTxRobSQ/iqhEdOX9pf44vjDI8rM28yJrEG4ZA3sZvb9pR2agpQCCmDqwfCUBx1zlcetHZf8/F3gYTn2bFqMAzqk= x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SJ0PR10MB5488.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(366004)(66476007)(66556008)(44832011)(64756008)(66446008)(33656002)(6506007)(186003)(7696005)(6916009)(9686003)(38100700002)(316002)(76116006)(8936002)(45080400002)(66946007)(8676002)(52536014)(122000001)(71200400001)(2906002)(86362001)(26005)(5660300002)(38070700005)(55016002)(508600001)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: wegRFhhuxnHWgI3sYjBfKNxgpVvgRygmjMTGKhUg/gw4I9H440sS1LgxkCvrs6H+t9r0RBmCB2B/ct+t/o/Q0rsjDyPQNfHNA+gBy3XZmlKaEyaJxwA9rJphkXuaagQBrmf3zDJujkw0lggHDEGoataNx1feEP2Q5VaWn9Bm+QOvtv+N/jFRuNhwZuyCGAtfo+70nqjxR+9FHknD9a6UxYZ/g07ft8yowZm5+bQCZWmfJ8WMmBwRE/VUg3Vl4LDnoJf5L/jhgNSSVvqgeYmVcd4Z/B6hRp+rvbQlb7omkZ5FIwUASO+x3ZxLNkhGQZYSEMDftgQl2MYiT+0pIKNzUGOs8kDxN0s5pwA1w56SA87YIReXFhhMXGeoMGqCYwB9FE67AscAz6llqjxk5wwCo6SM9cdASYRtAMQOx48dvi5MYTVB6QIzFj+Xrxs3dFTtLJyszKg6KLqvA8ow0/WWck8chdcsImGT9bP619EtGebabpc9sJ//5sVzGoKukgnb4KX/z3GNLtx3a5mrPvKKlnH+38o1y93Hk3P8rQ8JpFMbL9rvE3C1sNDDDn7SGbvSz0aa5bdhNfvW953UzX4KGuxy8JXDvdqkvFWHCBJcU3B00CV7vkGbSy2/ModAv/MOICkzGijt0Z8KQwLUF1Dc0E75sdtrlsB8iV9Jw5J9pLPn6ignRcYGXCb5MLX01VbUDV/CNNT/OqEJQQvIsCLjopERrvnwJnATPTUQZMq64g8pI2yvy6mNZFnEEz wKPDBzBE7rWQD7qW/a5MGtF45PgKq9YIocTQesHXHbyr76zViD3C+vpW6aLewVd9KZZ97ZdstLJeYLcjxiazh483JCXWGSkyWb X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: SJ0PR10MB5488.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 4b6f35b0-b3e9-4a3c-f62d-08d9ac774c6a X-MS-Exchange-CrossTenant-originalarrivaltime: 20 Nov 2021 22:44:23.1286 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: loQ4pT+6xF/PkTYOT3h/7ltt9Iw3Ti+1Ie0cFBBVoh0W6DpazPNOHMPAJ5/bpdiOtcrgsXHNjJdrO2wTbLBAFg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SJ0PR10MB5664 X-Proofpoint-Virus-Version: vendor=nai engine=6300 definitions=10174 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 phishscore=0 malwarescore=0 mlxlogscore=999 bulkscore=0 mlxscore=0 suspectscore=0 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2110150000 definitions=main-2111200145 X-Proofpoint-GUID: TzjNytglREHU4bYMhm3MuKFmRH6VY-wu X-Proofpoint-ORIG-GUID: TzjNytglREHU4bYMhm3MuKFmRH6VY-wu Received-SPF: pass client-ip=205.220.177.32; envelope-from=drew.adams@oracle.com; helo=mx0b-00069f02.pphosted.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:220525 Archived-At: AFAICT, neither the doc strings nor the Elisp manual (node `Defining Minor Modes') tells you how, from Lisp, to turn OFF a global(ized) minor mode. It tells you how to turn it ON from Lisp, and it tells you that you can use the Customize UI to turn it on and off. But it doesn't tell you how to turn it OFF, i.e., to turn off the mode in all buffers. The doc for a globalized minor mode `foo-mode' says this: With prefix ARG, enable Global-Foo mode if ARG is positive; otherwise, disable it. If called from Lisp, enable the mode if ARG is omitted or nil. The first sentence describes the interactive behavior. The second tells you how to turn it ON from Lisp. How to turn it off? The doc should at least make a connection between the prefix-arg value and the Lisp arg. Please fix this. It should be clear from the docs how to turn the mode off everywhere, as well as on everywhere. This can even be important if some defcustom has a :set that needs to, e.g., turn it off everywhere and then turn the mode back on wherever it was on. Turning on `debug-on-entry' for a global(ized) minor mode, and then using the Customize UI to toggle its option, a user can discover an arg they can pass with Lisp to turn it off. But users shouldn't need to jump through such hoops to find out how to turn it off. In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32) of 2019-08-29 Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd Windowing system distributor `Microsoft Corp.', version 10.0.19042 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''