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#50146: [External] : Re: bug#50146: 26.3; Doc of `MODE-' things created by `define-globalized-minor-mode' Date: Sat, 21 Aug 2021 16:25:59 +0000 Message-ID: References: <83y28uyeje.fsf@gnu.org> 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="14918"; mail-complaints-to="usenet@ciao.gmane.io" Cc: "50146@debbugs.gnu.org" <50146@debbugs.gnu.org> To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Aug 21 18:27:33 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 1mHTqG-0003dq-0K for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 21 Aug 2021 18:27:32 +0200 Original-Received: from localhost ([::1]:34526 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mHTqD-0007AW-W9 for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 21 Aug 2021 12:27:30 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:53930) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mHTpm-0006h2-KB for bug-gnu-emacs@gnu.org; Sat, 21 Aug 2021 12:27:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:54434) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mHTpm-0004YH-9G for bug-gnu-emacs@gnu.org; Sat, 21 Aug 2021 12:27:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mHTpl-0006iY-Ru for bug-gnu-emacs@gnu.org; Sat, 21 Aug 2021 12:27:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 21 Aug 2021 16:27:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 50146 X-GNU-PR-Package: emacs Original-Received: via spool by 50146-submit@debbugs.gnu.org id=B50146.162956316725758 (code B ref 50146); Sat, 21 Aug 2021 16:27:01 +0000 Original-Received: (at 50146) by debbugs.gnu.org; 21 Aug 2021 16:26:07 +0000 Original-Received: from localhost ([127.0.0.1]:37747 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mHTos-0006hN-T0 for submit@debbugs.gnu.org; Sat, 21 Aug 2021 12:26:07 -0400 Original-Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]:24626) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mHToq-0006hC-Qk for 50146@debbugs.gnu.org; Sat, 21 Aug 2021 12:26:05 -0400 Original-Received: from pps.filterd (m0246632.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.16.1.2/8.16.0.43) with SMTP id 17L5T9ed031576; Sat, 21 Aug 2021 16:26:04 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : references : in-reply-to : content-type : content-transfer-encoding : mime-version; s=corp-2021-07-09; bh=5qXgWWj50t8RstZkYTObVhJTtBWEiyuIWA7C4iaC1YQ=; b=lMzYXoL4FTNVXlLg4K7obxXtS7FVfxsnHoMjTIzznIW9YTMWI5y2r8wixZ9yEQxQBfy6 1Apjk7xhk9e6YGpoTLr83xecS80S251HEpZrWMVLWgoMcjSjlidkJrhEUcIfCTzWO3Ml hzhjv8uQ5V0HEiOwGc0Y+UReHiT/ec78E1cEFWZXm8yWmuSyq8r0gDcf4ZFc2n7LovA9 8Wqu8TDFEVAlwLYHS5brRWrE/sVBMm7ZKcKq69sdH6Z8WkBY1ZendSY5iDK7w3LQyk0n kec2tWee7v/6F+97nBmyJ1Hmh5OxzJWPIB2dPS9+YvE8g6yUdOzV8z9HcN6uwJmXUIlL 2Q== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : references : in-reply-to : content-type : content-transfer-encoding : mime-version; s=corp-2020-01-29; bh=5qXgWWj50t8RstZkYTObVhJTtBWEiyuIWA7C4iaC1YQ=; b=d2LpVtULoFvsjsGOvwiOUFHBwmCMVCdADON/jl5nUMcTyGY+nKxyRrJlxqWgTdhIG89v jXatiSyfsuIGoEnLaPzYwvTAFwGDeN67+4hrcscucQX3OJHRkoV4UPlBt3IOEsLkdqi7 CQKgetfwr0bz/mYopEkHkwP1VtbEjBqcbCgZOfTujKrOS2dlZVlhMV+CuHZ8srsA0wKb rtPIzoYjNobhSjs34VXlE4MaL4AxHNkWDOWS/gRG7rxwJdH2VeXjXhfn1mimNDpFjwu5 Mv4LzD+q+Tmkg/Ng+m++2ZNruMm0EUPNUXNsNIwEneAWhPRLMigr9a9FqmQtu0VZaItR YQ== Original-Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by mx0b-00069f02.pphosted.com with ESMTP id 3aju7vgh3h-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 21 Aug 2021 16:26:03 +0000 Original-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 17LGFFi3101884; Sat, 21 Aug 2021 16:26:03 GMT Original-Received: from nam11-bn8-obe.outbound.protection.outlook.com (mail-bn8nam11lp2169.outbound.protection.outlook.com [104.47.58.169]) by userp3020.oracle.com with ESMTP id 3ajrtm6rek-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 21 Aug 2021 16:26:02 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=UjOadIzfYGPUL5CpsdPk6aSkILDaciit5vTiKLQvjApYpJD2SqIAABwOaHj0EEyvwMt5quLeoQWyEECf/1sRuPzKWJBZc1b1uLQbesHHHX/y0IWRFOColCHAFQU5VIcOcBVBN7flUbcajAp3hz3dRsWyl1nMHEl5XFsDw9Fj9ar9b5lHiJ46tQ0YmgeU5QvxGQb7NSx0O0fcne47fLzZL+SHDKsWpdmSluZyzfzNfsuGn+oqrJepu5rBsrYTNFNbT+KZcOI7jNaGHSUIisn+CjNGiNHr8C7CTTQRDcbu/L1CnDQtVEtfGmERLiH0/d5pQfBo5bhIr1YnIvA/IP3eSA== 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-SenderADCheck; bh=5qXgWWj50t8RstZkYTObVhJTtBWEiyuIWA7C4iaC1YQ=; b=Q55vdYtDgHZtsB3N8SipeCDxJHpCJ096oClDyyPdu+WOJq5OQ7eKt9adg/zNe1PFG8swkiQ3GUvxpjW4ZgHZltcTiVUyYAXdK3u6C0GlIVROPlPqQkyl+isVZP8nBrzB0aqWwXZNPNriZdWovc9tDJ4XgXLPRi84BG/g1ZRlds/fVVvxMqLttAVfk8Un1qDR8tYVZ1EM8g0PwpM9O2XuSQxe5i65HFwjMzAQtjy3p0NuVJ9LJXmNIT/6MqlcAkcUa23sY6Ft+yBXA2gUiyZm1NTteYTlGUhz7Jq/hMHRn9VlL7SWqW7xZI/2glKiQASbHtoBi/FvZNBvgOgwrOzaBg== 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=5qXgWWj50t8RstZkYTObVhJTtBWEiyuIWA7C4iaC1YQ=; b=Dq8FOxq/HOtn+8Dxm3M32pBaUEVngOApzNNxmYByHTgpGwgnnQEhzdzH2JDbnhjTTEm0L7CuQrAtSEppYZhUUuF1WMmM8nZttIlq4g9QDQjsCO22qM98OwZjP/reFFEj/NIKCRTLFh7QaBnncJNyqp3Hs2C0Rw0xE8P5M48Nv4Y= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by BY5PR10MB3955.namprd10.prod.outlook.com (2603:10b6:a03:1f7::24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4436.22; Sat, 21 Aug 2021 16:25:59 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::a59e:fa26:ffe4:615b]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::a59e:fa26:ffe4:615b%3]) with mapi id 15.20.4436.022; Sat, 21 Aug 2021 16:25:59 +0000 Thread-Topic: [External] : Re: bug#50146: 26.3; Doc of `MODE-' things created by `define-globalized-minor-mode' Thread-Index: AdeWo5pu7r6bQUevRviMztayLyTq6AAAfl2KAACqxDA= In-Reply-To: <83y28uyeje.fsf@gnu.org> Accept-Language: en-US Content-Language: en-US authentication-results: gnu.org; dkim=none (message not signed) header.d=none;gnu.org; dmarc=none action=none header.from=oracle.com; x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: e3eb97ec-f5eb-4b39-10cc-08d964c05c46 x-ms-traffictypediagnostic: BY5PR10MB3955: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:8882; x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: v3uBSIerIZAxN2dtn3oYvhGgaxxAXPnQoYcemtZufHVJl71xEGBPjGucrDgaW40z5cPdPGdZhm4HIzJYqw24GiZxPBy0onktAeTyb2qnug4VtTlt/OL+BWp+R6a5PQcYoa5HpJ0ZI0gCPU1LElCeedMWZHcZy3zp8AZdqwwXwIwZvrux8W18H/YNDjUJHwTLYDOpPseZOKNvz/atrFdfWnzshzKfZLmRAHW6GwA7pNr+DDe59Nzlvgc7tmblpOBfQZQ7RM+sDeC7NhYM4BvzbRWfR8yothXjcxkt752K4EL0BzsN7rrdz9UGGw+USWLy4FWZNVMeyvZYKcRXT8A6BtKDUZ8Ut42jHWA3DGjifuL8rTNkJM7gaP2YtKhgAVBeCWWiJPu1D7GWHUszYaoFqz+httwqUfW4fI040rz/CyhC9L4RLXZW2nuluqSSERUgIqBhDeqZsniKb0L/4QwqELjPrCVxzfkxfx10LXdCBAnvtyIpcWanq6mV2GgaeFfVv2F4ybFcWT/Vdr2b23lgJaqakTqhNayJXWqfKifccu3OenrJdzkRXxLlwHYyU4UF5XXdEazvG/j6EnDZlv5CtCnBGaCSMiWcBfzACRPv5cyvofL6WS0I4XBqpBqz3nDBJdOcjlbk9tZDyHwKsCBkWZpU5EIYYmpFgJ/n9oGdYII8Tl9aDnl2NEP8rMANbbCH85OPuQ4pj1B953aCQgLvn10MLK5IviGlCk8o9ASFtY4= 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:(136003)(376002)(346002)(366004)(396003)(39860400002)(66476007)(66556008)(44832011)(86362001)(66446008)(66946007)(38100700002)(52536014)(64756008)(316002)(76116006)(9686003)(55016002)(478600001)(71200400001)(33656002)(7696005)(4326008)(6506007)(6916009)(26005)(186003)(8676002)(38070700005)(8936002)(5660300002)(2906002)(122000001)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: fzUQ0yxhY1W1k28cPNUCsocghPj8smuCXPevqBYohVCPmznJMFTFvzpnITkqTw5KoaBG9DJQ6oD8JQlrEuMgCka42ZomWfPDfcvlYbBUp3PUkjIU9lfH44LiCeFmiaar6e9YQAd53l5B3aEJAA5AlWZVWkAth9CB8A2ercv8dmtfi3grqYztkQn21mRDnJ1Rf/sPVacIOPR0FdvM+3Zxglv3aJ/2WWuRfJkZA+DG3RyuXTSyxfHIGwmEwqC5gpkEBodvVaD09JFl0wsnk8Hk7UDZA5gPzH8mn3CCj6aalxtu/32Kz0dPjEODC/6eTTllYujvQS+KSTWJ85U8ngeGODPCXWVTxm4iEgCMAt+2zdzsJ0/TM77OZai8bZg8sPad8bcR7+BK3WjLq+tfv5MBlZUhZ9rI1U0eyORUToO135Yvw8mzgICNImpnk2I96Pa0KraIqaPzyHqck8cFdpjhV8rcYcpc1X3Qdy9972fwvLzVcs2lW60AoUgDuHOsH9ds6/ewPb9eC3G1AeKkm0gDXAaO5Qe4ta6JbT5cR0+S4R6k7KA2Ly3OXBW4rpgchTy4yBBA5fFEqgu1cjq2upPpnvGdN3uW3CI2kYlawxswJ2eQc0E5/9sy+iGxbtRy3JMf04jSj81FxOGfUEyCCJ8r78P2pdZWzIAoNpQfSAef/ZXT2uuTYgfhFqpDJygVZxpmgW95HgTFZ2IZAoCM25xIf9zdW/xUUJ5yzt0LjTfOt7VzQCtc+QEZeuNXXD 39dOLbCTrrOU8Y0PYjdltz4r9LxMVqK/BFe6MwOrBDfQybL090joCTvPB1+cE2sB21fbC6co4Ivdo+SXwsg6MjpOB6c8XgaZV6 x-ms-exchange-transport-forked: True 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: e3eb97ec-f5eb-4b39-10cc-08d964c05c46 X-MS-Exchange-CrossTenant-originalarrivaltime: 21 Aug 2021 16:25:59.2447 (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: LUEqhexLe+8a7D64Zonb5EnRDJE+Pmi2rv0c+h9RmnqbMWaYu1V7OuXnjWU9FsqvvTFoTHoJahgYS/NskO1OOg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: BY5PR10MB3955 X-Proofpoint-Virus-Version: vendor=nai engine=6300 definitions=10083 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxlogscore=999 phishscore=0 bulkscore=0 adultscore=0 suspectscore=0 mlxscore=0 spamscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2107140000 definitions=main-2108210101 X-Proofpoint-ORIG-GUID: nNm-BRFdnybf3zH6I6vXBQbJEe412Gd9 X-Proofpoint-GUID: nNm-BRFdnybf3zH6I6vXBQbJEe412Gd9 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:212375 Archived-At: > Please provide a specific example or two. I tried looking at > global-visual-line-mode, and didn't see anything like what you > describe. emacs -Q (define-minor-mode foo-mode "..." :init-value nil :global t :group 'convenience) (defun turn-on-foo-mode () "..." (foo-mode 1)) (define-globalized-minor-mode foo-global-mode foo-mode turn-on-foo-mode :group 'convenience) C-h f foo TAB ___ You see this in *Completions*: Click on a completion to select it. In this buffer, type RET to select the completion near point. Possible completions are: foo-global-mode foo-global-mode-check-buffers foo-global-mode-cmhh foo-global-mode-enable-in-buffers foo-mode foo-mode-set-explicitly footnote-mode ___ `foo-mode-set-explicitly' is created by the macro. If you click that name in *Completions* you see this: ___ foo-mode-set-explicitly is a Lisp function. (foo-mode-set-explicitly) Not documented. ___ Same thing, if you use `C-h v foo TAB' and choose `foo-mode-set-explicitly': the help for the var is just as vacuous. These automatically created things seems like noise, for users. If they're intended to be under the covers then maybe they should be more under the covers. If they're intended to be usable by, or understandable to, users, then maybe they should have some doc that at least tries to dispel some of the possible confusion.