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#60587: Patch for adding links to symbols' help documentation Date: Thu, 26 Jan 2023 15:23:09 +0000 Message-ID: References: <86y1qgr1bf.fsf@duenenhof-wilhelm.de> <86tu13qydg.fsf@duenenhof-wilhelm.de> <83h6x2u74b.fsf@gnu.org> <863588rfos.fsf@duenenhof-wilhelm.de> <83o7qw0yjy.fsf@gnu.org> <864jskx6a8.fsf@duenenhof-wilhelm.de> <831qnomh6l.fsf@gnu.org> <86wn5anw04.fsf@duenenhof-wilhelm.de> <874jsdwpvg.fsf@localhost> <87edrhuy7x.fsf@localhost> 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="31006"; mail-complaints-to="usenet@ciao.gmane.io" Cc: "H. Dieter Wilhelm" , Eli Zaretskii , "60587@debbugs.gnu.org" <60587@debbugs.gnu.org>, "monnier@iro.umontreal.ca" To: Ihor Radchenko Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Jan 26 16:24:17 2023 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 1pL46r-0007sZ-Bt for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 26 Jan 2023 16:24:17 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pL46g-0006WF-Pa; Thu, 26 Jan 2023 10:24:07 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pL46c-0006UE-L6 for bug-gnu-emacs@gnu.org; Thu, 26 Jan 2023 10:24:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pL46c-0002ls-Aj for bug-gnu-emacs@gnu.org; Thu, 26 Jan 2023 10:24:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pL46b-0000RQ-PY for bug-gnu-emacs@gnu.org; Thu, 26 Jan 2023 10:24: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: Thu, 26 Jan 2023 15:24:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 60587 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 60587-submit@debbugs.gnu.org id=B60587.16747465971646 (code B ref 60587); Thu, 26 Jan 2023 15:24:01 +0000 Original-Received: (at 60587) by debbugs.gnu.org; 26 Jan 2023 15:23:17 +0000 Original-Received: from localhost ([127.0.0.1]:35912 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pL45s-0000QT-Mo for submit@debbugs.gnu.org; Thu, 26 Jan 2023 10:23:17 -0500 Original-Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]:4192) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pL45p-0000QJ-JT for 60587@debbugs.gnu.org; Thu, 26 Jan 2023 10:23:14 -0500 Original-Received: from pps.filterd (m0333520.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 30QEiGrg026274; Thu, 26 Jan 2023 15:23:13 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-2022-7-12; bh=miEaDG5LHKALTHNyCs6PYWvMsC1kLupFrrq1p6Dv9tk=; b=GMZQ1u44fWgsCthe9YTiAsOAYIYDuYPpBGrPG4SOTxDAkif1eYh0jLs0wybt3xSmoXqp oxplrziRRzwj0WhFfYEb8Lu55T55eW0DQLmi/NE+iSxt3G1lj9d6hbFOTkiyv+bq4wID 5oigrRU1dgVTomhJNr8Lg7LLdXm5QF9bgk67yuWeRuL6E5bct5p8XNHDT/Deh1WQ1xp3 ItxkRMLKPSO7oW2VpQpboALqw1PnkWawX/Nd8p7OihT4rFqJGYX2pKK4sXn2m8ZN5JeT 3p49XApBdsh2rM95rsiOVMy6EfYI3hKBIrUNo7lGvSuXnqwgi6mkvd6YMJ+PrmdfXnJw Eg== Original-Received: from iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta03.appoci.oracle.com [130.35.103.27]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3n883cam8s-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 26 Jan 2023 15:23:12 +0000 Original-Received: from pps.filterd (iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (8.17.1.5/8.17.1.5) with ESMTP id 30QFABRp009070; Thu, 26 Jan 2023 15:23:12 GMT Original-Received: from nam11-dm6-obe.outbound.protection.outlook.com (mail-dm6nam11lp2171.outbound.protection.outlook.com [104.47.57.171]) by iadpaimrmta03.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 3n86g8b9yj-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Thu, 26 Jan 2023 15:23:11 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=aPsf+P9wLGg6IZLeisjb1+wVwlMazjuLgo5Wd8kUlCwQQXqAlfdg5SjwC+dnXxcXyJ3lXN3CgnqWjinC92op55CiGtEdsVYiXHVgG5HIYxCbb8RecAnjVQD4uczcpVpTegiLKdsPbrcRJpKLVULKBCC34dz6YLsuICcryEv80h3ByUMcPaMqHz74FdnU1mAzzrxMELsGKp79CbcCZ8/stSxD8VQWZY+3hoX3zY+XBahdrXFUXhtKM0ruXp1Ow1LgmRmpq3HKEWVhlrushuOzQ/6g4NIjfHLkPJLNvw6xJGqFnA9KZhCOzj/OT1qGLe8wILu5bfVZK8Kh1GaP3BM7BA== 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=miEaDG5LHKALTHNyCs6PYWvMsC1kLupFrrq1p6Dv9tk=; b=Wdfiu5EJk88e0NcSHCgs6oh8siHHxHfJwVnERp+3BgG+5WAh1IEY47/oI3J0F5iJY2MQ6ulInQG4ZDgTCvDqGnZn3JDe8jsh+jkv+CW/1YQ+xWKRew2EmJmX7PCnQeaAToLJgO7AyHq3KVadHZVei36sDXWGr1sloLRwgA6+1At6aciGfTsRj1TL76haacSDVBmmT/2FUjFQ9aRhmnEPbiD/ieLo3KmH3rksGVv5XuzqdXJtaxpBl7q4acBLA4YEsPDsAkdAkDrcVh1cuEbS/h0NqdF5fFG9WMjreZ8Bes5siA3SI+Lk2roNCGcj5ixrTy7BASto6T2xb7ZccDwmvQ== 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=miEaDG5LHKALTHNyCs6PYWvMsC1kLupFrrq1p6Dv9tk=; b=PUcwAhiCFw9Ixhf8Q+ql6AwjbCk7wjdNsb2zT4tBCeB7SG911skREDNQ2HdjRqsZIYlIggAPbuPnwEWL8QUj6SYTOGKJdgsqykQc8HAs0aY5q2Qb3g+7YkCvtXk89x5yOWF4M029tKs+uEUzenN54z1f/1GQome0MUUfzDniJJc= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by DS0PR10MB7150.namprd10.prod.outlook.com (2603:10b6:8:df::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6043.22; Thu, 26 Jan 2023 15:23:10 +0000 Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::7c3c:e53d:5276:ef29]) by SJ0PR10MB5488.namprd10.prod.outlook.com ([fe80::7c3c:e53d:5276:ef29%7]) with mapi id 15.20.6043.022; Thu, 26 Jan 2023 15:23:10 +0000 Thread-Topic: [External] : Re: bug#60587: Patch for adding links to symbols' help documentation Thread-Index: AQHZMZiClFnrfr4If0KHnJXAzBHL6a6wz60w In-Reply-To: <87edrhuy7x.fsf@localhost> Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-traffictypediagnostic: SJ0PR10MB5488:EE_|DS0PR10MB7150:EE_ x-ms-office365-filtering-correlation-id: 8a07a426-4bcf-46ef-c47e-08daffb13b95 x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: Ii1W9m8l9ZkxyUvIjWnXR091zjHSP4otWgFO4hyEE5/KTHhXQjyHxgyOEwSvnKTjcrFX4GrDLRcKyk9MQDfGmB7SmtT5ob+LuCv1lZeqL3fcWKMlwf6BEzpmqdiZ5cpQEuFCiv1HEQVAv6o9XZq+yI0YU3BK7ypSt09EwI+MPhuY8prAc8pq7jhL+HHcIyRGf4/zsWqmezXGS7ay8wyri+0qfJ9ZSLdM6O6Zh1DhhRa97vV6cV8g+r5j5fQFnAxyrubabv8P4CJxsHUGXhSxc1XmZDqtqFIoAUU0fmE3qwH7cjqI9pKcsqG5ZTDnXZs8xSnZPEbFtjURw/OX5m6y2Bzif/FM96uh84Lva+920sgupJYXAbPefsW4nKugV/5H7r7/cVnUANvPIU6t7HUHEGnmjkW+M45ZMhM6L+UwllMQ9Rtop2sDP46vv+EjjLuez/ogSrA/TcTzQVmAIHwBtEmEALlTE5zI18ddkX6VOvZ9mTepdBB2QynXgqLRfhWkRa6zrbDV2+13+yaBmGO0DlqRTuWmj2kch9tXKFWSnUqyuUgZHcCHS1P6gslADpUBVTUuJ67KDS8yHazR2TPDo4S6exGAkYEGvk/Y+72J3g8pqWruaIzHJ9L89nPLAoz85oIQOUoA3B6+Iu376YQa2JMjvJSQ9UlgrmubMAuNQlPqJaHhhBzAKD5BNYnHwIaX1L52wOIST4j8J7gxLktTEw== 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:(13230025)(136003)(346002)(376002)(39860400002)(366004)(396003)(451199018)(316002)(54906003)(52536014)(5660300002)(2906002)(55016003)(4744005)(44832011)(86362001)(33656002)(8936002)(38070700005)(38100700002)(122000001)(64756008)(66946007)(76116006)(66556008)(66446008)(66476007)(8676002)(41300700001)(6916009)(4326008)(71200400001)(7696005)(478600001)(186003)(6506007)(26005)(9686003); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: mcpo2SLVjotbxUsA3Meoizux284leYoBqeZz5UrVkghwgiAlR1MVSRuM/cZKF0VCHeugHZd3a41paUyRr+AK4VU/Z39FP7p30bVKJrFKwe0GhDBMXty9n2Nq8/nDq3qYIFr3oNibm11DA3dVHyZpjvnbOrtR6hv8Nqk3BJly8houlUScSMtZq+kwZQurf0sdeInn4w7wawbkw9m3zfl/cWHBv69NFDU2C0vTvCAbbEiPi9PNgtOL/v8NU4uiU41/qPSwj0pfTxF9gQbsMM2VNxXcOs04+5ufky20RdbDnigj7D8YUEXXxRR/pth/dazMiNyXo/bGmYpC3KzHmV81lQhdROndm01gO6WU1aY6RMKbXI1mM6FyyA8HNCiFOHF7MuKZIImEWCGtwIdVCpuvBT28qFfUmERzKoNnHqvWUcrQmTfj069DCKjUMchmqxNcmeEhFbsZnJ7Bx1wKMH4lrSAu8sh6vk8Rbkra2lS2Bgx8wP8Uqbf9XLRkJpZg7CdIM1j4ErdJQG7+UgUXgGHuMrxXoD2hSjOpijFcyqB871+4+rdCHkUpz1gIxAA+/w9UOz2G6JTM48z2pHnrIEuLn+Xo6aStfOjhx+HxgqO5KN5iNrhSMRG5qjJgLYO+rUeAhPq6NXu9hgaAXDLfTgmAJlFGrED+NqRe0wTyHHV/+0srA+oZYztfEVnNzTxcqiu4lPRywCu8VrpfJfP76bYjsg0ht3o8DHAuoUZaXYf2VLqTjpZCQdMOOSJ+UU wi91kIrCi0bCFBlKDHkDa7iEBVO290143AxRi2usVhVkUI6ZOGZDzLEI/YMj96oFgqdVGNr7x9kM99HoT9fitPTQ+v6/rIxV8R X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: 76AecrmUJW/AfQ+0PEVkf9f2uIwy8N/7bL5bXyGFa8IOtwAPTeUKCv0uNEpGoHqq9AJ8jj0aDGDlSfGlHhJ2mp2XW05Ndu1WN0WVnHVIasv8ZZk7rc7Dv8sJurRsjtyyF5ABQUUpoWx+RDEJFJctexfCU9fTIuyMmQ0U3ZonvLjKmOVJEKIgiwHH+hV9WfVv/3ioJmOQ1nct8eJmjZwopvZPVJJTjDtkKj57Jx+/EboW4OcB3cYPvZz/gDk0EB8DCV+aEET1cCSOsv9cCLHuCwAoShSiGsm88ru983UXJppsWN8IiZG8d++h3qtRkUh5xnZTam948qGg++u1ABvXWc6l9D32/UpcWJtERrRX/etywNv8HQPdy/2FyJTZSLRP3EJh9ZBbUv162I9/IpCF/0/quXNsdUuXfaKEf2ukxQc7jSjsoEQIaZZLsAm7pRzKOZJvHHfRbmgrLCOVkeWyC/XX2M1pVUeNMwB2uA1AhK3at6WFME501itiVnCmbbHs1nU/kxCkBCCswkxE3FdHYREtg4Ia/hbX39M4L2HRltOShxQmlLOIJsY0V4JTC/im6UgGA4e8oE5jy/aH10QElZKeKTIYB1STu/5Ncs0PupGufvnBs1469dgotyob3x7nH7prY5R9bMIzO3H/g6EsmyvTjQ9FxEfIARIAjWDpEPJkAYy7nYfyI5ssuZk0PstBWhJn2JfJMRcGgtGiUN1PTA2/ogZXDRKlDWRczLkU3MoQKA 7rWGH3I9dzvx63pGov5yuF5etgDuTHcxHBDT/9JN+HzLnIhK7TLiIv9xF4sL17vSQ9WlLe0EMDUWv8t+BaRQZzS4Uq5rhHysiy 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: 8a07a426-4bcf-46ef-c47e-08daffb13b95 X-MS-Exchange-CrossTenant-originalarrivaltime: 26 Jan 2023 15:23:09.9999 (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: 8/6WGOqpgmqbLR2XMKp5S89QTXNzZHVxN/JeGIwLRPjnNDZg1gbCXui2dxorihoymnS8mJE+EB2fX2dNS72R3Q== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DS0PR10MB7150 X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.219,Aquarius:18.0.930,Hydra:6.0.562,FMLib:17.11.122.1 definitions=2023-01-26_07,2023-01-25_01,2022-06-22_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 bulkscore=0 spamscore=0 phishscore=0 suspectscore=0 malwarescore=0 adultscore=0 mlxlogscore=999 mlxscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2212070000 definitions=main-2301260149 X-Proofpoint-ORIG-GUID: OxIKaumMtbJ6UUk5mDsvYlspjc_U2cxV X-Proofpoint-GUID: OxIKaumMtbJ6UUk5mDsvYlspjc_U2cxV 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-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:254208 Archived-At: > >> > 2. Instead of putting it on the hook when loading > >> > the code, add/remove it in a :set function. E.g. > >> > (untested):... > >> > > >> > 3. Maybe add a toggle command for the option, so > >> > users can switch the behavior anytime, on the fly. > >> > >> What about using `add-variable-watcher'? > > > > Did you mean for #2: when/where to add the function > > to the hook? Or did you mean use a watcher instead > > of #3, a toggle command? >=20 > Both. Rather than searching for a dedicated "toggle" command, setting > the variable with then trigger the hook addition/removal. Doesn't matter what I think here, and I may be missing your point. But, in case it helps: 1. :set takes care of what you say. And it's specifically for (1) only setting and (2) only user options. 2. I don't see how a watcher provides users with a command, to interactively toggle the value. 3. Cf. the suggestion to use a minor mode.