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: 26.3; Doc of `MODE-' things created by `define-globalized-minor-mode' Date: Sat, 21 Aug 2021 15:46:38 +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="33725"; mail-complaints-to="usenet@ciao.gmane.io" To: 50146@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Aug 21 17:47:18 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 1mHTDK-0008Zx-3U for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 21 Aug 2021 17:47:18 +0200 Original-Received: from localhost ([::1]:46856 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mHTDI-0003Iz-6W for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 21 Aug 2021 11:47:16 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:49776) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mHTD4-0003G3-Tp for bug-gnu-emacs@gnu.org; Sat, 21 Aug 2021 11:47:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:54410) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mHTD4-0003Q9-Lb for bug-gnu-emacs@gnu.org; Sat, 21 Aug 2021 11:47:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mHTD4-0005kf-IW for bug-gnu-emacs@gnu.org; Sat, 21 Aug 2021 11:47:02 -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 15:47:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 50146 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.162956081522093 (code B ref -1); Sat, 21 Aug 2021 15:47:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 21 Aug 2021 15:46:55 +0000 Original-Received: from localhost ([127.0.0.1]:37723 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mHTCw-0005kH-Ve for submit@debbugs.gnu.org; Sat, 21 Aug 2021 11:46:55 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:49968) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mHTCv-0005k9-Bu for submit@debbugs.gnu.org; Sat, 21 Aug 2021 11:46:53 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:49774) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mHTCv-00036B-45 for bug-gnu-emacs@gnu.org; Sat, 21 Aug 2021 11:46:53 -0400 Original-Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]:63112) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mHTCq-0003I2-Ck for bug-gnu-emacs@gnu.org; Sat, 21 Aug 2021 11:46:52 -0400 Original-Received: from pps.filterd (m0246627.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.16.1.2/8.16.0.43) with SMTP id 17L5SoeF020621 for ; Sat, 21 Aug 2021 15:46:45 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=NuvcTuD7kW5o4gy5CMHVk+WO/MM8x1XKKt2VPs0FwK4=; b=u1OxzP4GQRFtjY5M3r+O65as4x55jXRrgsJZcNdFZgcyRtglAEkDC9ftZxMcg8pXw5oQ Y7Spk13UcBsA2g74Qc+sH6t38wO0ORECwlXW1j+4FImlhHpXNgXK6KLGtcK4iF4Xy54S EVO0reQkoL4AHEIoHH03Ne2wx2RJaCjkoIZ8T9fJANM2kJDlBPKcEkGvS1VBGGCOuHh0 GB+u9orpF5G2wXXAyaQBqq5h0GMXrErOqhT2mWj5sUXS0eAIXtAHrZEE/TuVAg+MMxai o++8eUSmqN1psxBixOmTvLq0u9V3zzNVmBULH/WUoya6SzAFFNmFhtwSr4K3QVUbWpid kA== 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-2020-01-29; bh=NuvcTuD7kW5o4gy5CMHVk+WO/MM8x1XKKt2VPs0FwK4=; b=i5HkEwWJnvcwteOfzhrkMd/7dqe4/P+74J9ud5a7/btsvLoG0TCaxyI7y3SGHSiR7jUh fvBNZR+bCNTGINPAmXUD38YzSEaCmNuYcPJ1ZZTyQir8KKdj3/cgnBJ6xh5bgAw5YAGQ ISaXN8InHM3kzV1dD4YwqFLZkuTVQR5XHNoSDF7QMrG+Guu+fZkyJu4UAZzVgCe08Kri mfgM3XDL6PDvbcpO452jNVz/zMLKEPyNK7HC7srN2tdBHsyddHWZGvlHHOBeyDOd9vqI 98LihXI1YjjCOviTO0LyUqLCa1QYCDHWnImV83w/aRVhUktqzt+1xHOa1+Cqmg8jXR+4 Pg== Original-Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by mx0b-00069f02.pphosted.com with ESMTP id 3ajub60gdc-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sat, 21 Aug 2021 15:46:44 +0000 Original-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 17LFjJGh061984 for ; Sat, 21 Aug 2021 15:46:43 GMT Original-Received: from nam11-bn8-obe.outbound.protection.outlook.com (mail-bn8nam11lp2175.outbound.protection.outlook.com [104.47.58.175] (may be forged)) by userp3030.oracle.com with ESMTP id 3ajpks2bpy-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sat, 21 Aug 2021 15:46:43 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Qrc8LS+pdGb9z5YLUjWiRFPnmhhPtz70DVOSKpPO3nK2vR+7eN8DJ974AmMEXUau3DkIWu5YvwudTHEJH7mewlb9c/H9JJVSlJzVHWn7RkP6isnmVxROtJvjC4HmZLLHpFUhi41LKe9n420E2OEIZH/ubmDe78jxIBji3wYY3GpvEkGH6ihUp4Eq7YkqRD4i+5jPaA8mmiO6xCYZw687KX50MS3qPGSI/nLkjrP+gwIENpr616UipHqv4GN6P/60Li7KMpkntvKUiZLKadWyQpabZa0CbIa3hr/+fi5GU1mYCbxqiOeiNK5FGTAqNdjo9KtpXiYQssPzOacxhyqPTA== 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=NuvcTuD7kW5o4gy5CMHVk+WO/MM8x1XKKt2VPs0FwK4=; b=E39g5XRXAqX+9hHimDYDA2R6TQTnQ4hvKxKzDBok3N6bsARPiRvJdYNUHGTEF8DXZyOKprn4zNwogRMa1z9wz0fVukKQswCAjTXcBUm4BuIdRoUIUwm6jN5JQssjPQk7aeD+ROHLsZj+vCEOvUcHk9y2KBIm6cC0hJSBXc0QXkIxD/okOsSBodvBf2A7v7vg9+270w5qXbZ5P0UObehJ8yn8BH2dEe63IWRttvONZ0TFKRrOB4n+wtnauzbaZPdQ60IGgWz0MKH6nm4Zh4PYCUGYz8IC76HyUkOZQSEY1yQw0r77F3lLpXZeokitTaQreOWfeDjIhcU/NAWdRo8HHg== 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=NuvcTuD7kW5o4gy5CMHVk+WO/MM8x1XKKt2VPs0FwK4=; b=N8bwDxgCi8poxwK/xPit2VGJPjfzgHJzVx/bCbeo22LToUqoGcPZHQYTWDnG2iWVC9820E7Gf3+VMqwLk0SsQaO7o85vQnfM8OZHEnKS9MFo2BpnK7nVFVo0ewomLv/grRdAldVI8Upd6c7d1paNhIDekZrHclAWAcoXsRhhLJU= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by SJ0PR10MB5648.namprd10.prod.outlook.com (2603:10b6:a03:3e2::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4436.19; Sat, 21 Aug 2021 15:46:38 +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 15:46:38 +0000 Thread-Topic: 26.3; Doc of `MODE-' things created by `define-globalized-minor-mode' Thread-Index: AdeWo5pu7r6bQUevRviMztayLyTq6A== 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: 0d156542-2456-4352-611b-08d964badd1b x-ms-traffictypediagnostic: SJ0PR10MB5648: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:10000; x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: 3vjrXf5Q214drJTsVSnsdMmeQOUK/OijOaXIoVm/8D6xu2ZF1PJKmR0e0BqNwaLYeAlzfof/Ceg+bVsj7W9KHlzIfm7FigEu/UFBFYD4/nYuk1ZRa9EnxswNCGvac06KuE2OPVzu8FF+eHrZA14J622g1THNP+4G3LW3DybMvm4K/Aul/+EB50Qzxrl9HmonuBW0EdGif3U4Ywko97cpps+OlfW42xIxIkw0qqauvC4gmUbdFxidlUjDiOBvnGWqQHs0BF5NqF+1Vx5isK4z0Xh8eUc65ZJEJ8y2cL89Mkts2iBrw9BPf1GQUufKd8PaVW1Qk5rIH8FT5DbItzikfsmWGMrHV3WvPEYgdvurZiqTwaoTpG3LLERs6mdwbzRXMhRTagRl0KiJxrfOdrC468wLHmV1R1sB5D88a/rm2Fu0QvS98560uufLUTJhElSHit8HMQ+X18R4B8rF2yYnDijYyqfhUiniAdnhqTNuNjxxsCXsuXx7H7g6oblYeX5812IutGBpO5kffiQiE7C0ZWimdEmxybFbAat2tbVEJILKrW+wVFVRA2F1x9EAhZO5YiNgk47FvEV1Hn2+asmTgOvMxSmrVfu6xnrUIHqLgiDryOC/be2SDsIoBVSPsrFeLe4tTZQIxwYckJ2/kwO2mgSalfhADA27eYoLtK3cSQd97WxIKkI2SQBObE3pDw6QA56VqrAIKIH8VFPgzmJGEvd1JHMnBKBLvoT9Q9tGMUA= 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)(396003)(346002)(39860400002)(366004)(376002)(478600001)(8676002)(66476007)(76116006)(2906002)(26005)(66946007)(66556008)(38070700005)(64756008)(55016002)(9686003)(83380400001)(33656002)(5660300002)(122000001)(38100700002)(7696005)(52536014)(186003)(45080400002)(316002)(6506007)(66446008)(44832011)(71200400001)(86362001)(8936002)(6916009)(81973001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: qSZvSRTyHLx1zKybZvchhCjQ8T4RJFaHEwY98abO3f66Tht2DSc68YO+XB9pgE37Y8rMQFMxgD1TAc82nIGr8RsJWtF8I5VGV5ZhgPH+JfyehBNoqK/cVr1Kj5mAMFx8WxoQv5FlPvCo7SSUrMHPqA1F6zeE2/kdLrtUC8jPkoSB5sMclikOir7RWxb3dpSMBYEeE57OvY08ybyf8zpooN++iS0LxVjZ+TZNrT7jkWZ7OCKS0MXFJAUmMKqgqLpEl5WWb0u5czLgyr0D3oc8eqn2s4dzOm1szbogLNGStgApmtTh68O1xXZMI+st/Q0/Lk+wPyWD5hiPt8Ij2xrX+UdxRFBbU9enci9BPm3dUNTDkhm/dVgAScGf4aLUgS/UN2NJ8SICKF+3VH7uGlVUHacu2/9iPVaD7E+6oAsTZOaOInT/of2VHlpoxE/mpmWE8F4qV9j1aEdjuymbveCuJbCtmR4dj4oGwXZ1TIcqRR+ohml6ZQek5/Ao16HqbUFED4cMBJAPY1VN3eRbV633quP+xlJ9fkgnf6VVnbXDfV0KbJWKFNtmk1z4lD+y3RSgG5JlzHURRec5D04/PFitCNc3E7eIWCx00+1k+OwwSHtj7skKzfuSaNAjVz9bfx3m6seaTlpslAU3m5ay54JhKuvJY/Xej0LjquMbDRmQX9l35F7vsIBzb3vZgLVbbPvy8ns1GxJ4sF41Icj3k9z6vOpa80tfjsjCvJTzaJ1CLXbBw8ydgtQMlKjNts G/+XtiSbQyiTu1Pk0r6my93+/yywPbiDi1T5HX9SbyJCvZHC2+JuC+CbE4M4sa7U7nYv0P1qbZi8RItvMy92VqsDsiGkoAt76C 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: 0d156542-2456-4352-611b-08d964badd1b X-MS-Exchange-CrossTenant-originalarrivaltime: 21 Aug 2021 15:46:38.4834 (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: SxZVjGYJZfNU9Y80G3K207qZPsI2r1jig5Yko6QFKzqhouAGuvI8PD8BxsnZks4d1sWmvXbRw0yRN3jlwo90Pw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SJ0PR10MB5648 X-Proofpoint-Virus-Version: vendor=nai engine=6300 definitions=10083 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 phishscore=0 malwarescore=0 mlxscore=0 bulkscore=0 mlxlogscore=999 suspectscore=0 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2107140000 definitions=main-2108210097 X-Proofpoint-GUID: GPVTzJZ-5waytff5_lwh1Qu-EmFoxXbG X-Proofpoint-ORIG-GUID: GPVTzJZ-5waytff5_lwh1Qu-EmFoxXbG Received-SPF: pass client-ip=205.220.165.32; envelope-from=drew.adams@oracle.com; helo=mx0a-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_BL=0.001, RCVD_IN_MSPIKE_L3=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:212371 Archived-At: A user can be puzzled by `C-h v' and `C-h f' completion showing the names of variables and functions that get created by macro `define-globalized-minor-mode'. `C-h v' and `C-h f' are primary means of discovery. If a user chooses such a name from completion she's not helped, but further pushed into puzzlement. She'll see something like this: foo-mode-set-explicitly is a Lisp function in 'foobar.el'. (foo-mode-set-explicitly) And clicking that file-name link won't help at all, but will add to the confusion. Can we not fix this somehow? If nothing really reasonable can be found to fix this, maybe a kludge improvement would be to at least add a doc string to such a created thing, which says that the thing was created by `define-globalized-minor-mode' and perhaps points to that macro. And perhaps that doc string could point to the corresponding mode command, so users can consult its doc (which won't mention the thing created, but at least might get users closer to what's going on). 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''