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: Fri, 20 Jan 2023 21:59:27 +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> 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="24332"; mail-complaints-to="usenet@ciao.gmane.io" Cc: "60587@debbugs.gnu.org" <60587@debbugs.gnu.org>, "monnier@iro.umontreal.ca" To: "H. Dieter Wilhelm" , Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Jan 20 23:00: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 1pIzQn-00065w-8T for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 20 Jan 2023 23:00:17 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pIzQd-0002y0-9p; Fri, 20 Jan 2023 17:00: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 1pIzQa-0002xG-KA for bug-gnu-emacs@gnu.org; Fri, 20 Jan 2023 17:00:04 -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 1pIzQY-0002Np-Hv for bug-gnu-emacs@gnu.org; Fri, 20 Jan 2023 17:00:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pIzQY-0000HY-4E for bug-gnu-emacs@gnu.org; Fri, 20 Jan 2023 17:00:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 20 Jan 2023 22:00:02 +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.1674251979970 (code B ref 60587); Fri, 20 Jan 2023 22:00:02 +0000 Original-Received: (at 60587) by debbugs.gnu.org; 20 Jan 2023 21:59:39 +0000 Original-Received: from localhost ([127.0.0.1]:47371 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pIzQB-0000FZ-AE for submit@debbugs.gnu.org; Fri, 20 Jan 2023 16:59:39 -0500 Original-Received: from mx0a-00069f02.pphosted.com ([205.220.165.32]:57870) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pIzQ8-0000FP-KD for 60587@debbugs.gnu.org; Fri, 20 Jan 2023 16:59:37 -0500 Original-Received: from pps.filterd (m0246617.ppops.net [127.0.0.1]) by mx0b-00069f02.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 30KJxeBH025641; Fri, 20 Jan 2023 21:59:35 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=GidDNdZYH6pHWWVZiMEQ83tmMEfBFliAngBvOVSWcoQ=; b=KVkPGZDA8qdpMOXbrrKJ+OR1I55IBhOjp0vD9rqDYo12EHxksWNhTMC2sDOwrloks1e+ zpwOCo0jvNWNeB4BOXgheARJi3LqcYtkwmDW+fKCtVuWRoVRYbc0cG70XPmbLUAqvDnv Vyo64vYWXzj3De0cY8cJHbCSg6UjNXgv0MLULP+s2ozK5FkaZ4UkijI/MR1mmR/TFN5L D8+hDUreLAAtk53JOUIDWMMXbb3RWI0NUZOIbht0w6y7YKx2c8Zo1qL3alhA+/tXSxhY w3+a7FaK8mmUJE8DdPaEbee1ScEsq10n+kqMdfWIopidudGnkjKCm101wJ9Sls9NF5JC 2g== Original-Received: from phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com (phxpaimrmta02.appoci.oracle.com [147.154.114.232]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3n3mxtds4y-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 20 Jan 2023 21:59:35 +0000 Original-Received: from pps.filterd (phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com [127.0.0.1]) by phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com (8.17.1.5/8.17.1.5) with ESMTP id 30KKe5If000984; Fri, 20 Jan 2023 21:59:34 GMT Original-Received: from nam02-sn1-obe.outbound.protection.outlook.com (mail-sn1nam02lp2040.outbound.protection.outlook.com [104.47.57.40]) by phxpaimrmta02.imrmtpd1.prodappphxaev1.oraclevcn.com (PPS) with ESMTPS id 3n74d35ymn-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 20 Jan 2023 21:59:34 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=LX2c5njiLCJaQ/jRoO5cVpyxitW1d0ol9BZyYXJ2c0PUJqyD9uekjHu0Jeyh6kiCtG77WxGuMjTKPqIXTk5jGF/eT+NL8vdDDK3tsAiz451pKTq4MGCwO2lY/sZ4kp48+XwOlCaSu3U7+AGHoCbaiD9eJ6DCmGb3mfKk0CoZAJ325kvEz0okQpTEKdvEb4/5Ne2QEnH1f/En29HRFMSM7A1gDpPi8ygfumQmwPc8H+PWw4hYgNYos7Ob4AqKsoTfXzg3LSIG+t8KPA9rHcW8j+382Lpdes2ZjLWmyqhqPUkkijo2uiLh64ZhaTCqnPopCL0Ky8rOtN6ix3D1xPYTcA== 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=GidDNdZYH6pHWWVZiMEQ83tmMEfBFliAngBvOVSWcoQ=; b=PR5XVXe+M2zXfQeD0zYLvPYdaqt6ewl1CpOCwErZdZaau9Ts1UPY6upPdNpXSZT9hETTYoTa9qdydOjg/KwFU7Yb54xUlQmVDnDEWvZCUhHiNavAbFSRHdT3eTnnXUE1nP2sbtSqNJZvWvw98ktih2PuKfizTswXjTjqQO1+K/tz2QW4Yj39f5yaG3CrAix4cWfBdcjxB/sQo9Anm3Uhza4RTAW+e/7k0t4Rh27NAqqUq6DWsoMTTIaVsuKU2dQMZeajFD9pnVtHRjHL1Q4cdD/rcxM96UQXQEiqJrEqMWku3+w5fjGWaecboPxGLcjkWkjldOr+TQWA9vWp7zUjTQ== 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=GidDNdZYH6pHWWVZiMEQ83tmMEfBFliAngBvOVSWcoQ=; b=nsIBKiY0GpSiX/NORi39PYrupq/z+cMxv0cue/8GQZsXc1ylkMDfekuIQqFEsPiyoC+4SCXKMoSsMpZwxUEUCA+kYtrn1rkCgXX1JEFXxL+fGqTjEnxEAJEa1/5Dfw7WKWysZyNfLx5yMeHOPZsOu7KHceWPyyeoFDj6DP/XiPw= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by CH0PR10MB4937.namprd10.prod.outlook.com (2603:10b6:610:c5::24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6043.7; Fri, 20 Jan 2023 21:59:27 +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.007; Fri, 20 Jan 2023 21:59:27 +0000 Thread-Topic: [External] : bug#60587: Patch for adding links to symbols' help documentation Thread-Index: AQHZLROoSswej+9Mc0yojxbTs2n74a6n2AxQ In-Reply-To: <864jskx6a8.fsf@duenenhof-wilhelm.de> Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-traffictypediagnostic: SJ0PR10MB5488:EE_|CH0PR10MB4937:EE_ x-ms-office365-filtering-correlation-id: babc9084-cade-4818-3939-08dafb319998 x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: U9HckSPUqotrhuJjOPp/XAvzCeIOma0OAxQlLt2J0xqBu68hxlxOK1TZs5QIzWMnN88wH1MVdIzYYwPvV8QxLKuCgXD4gEOkW9WtXP/LhjEHZI/ab4yCPoCgGrOnIHFCNhIbPtnlHm+L+gWmheObK6wlS47dks5kqJ7rJsB6wNZMF+LLWYI/rUtbCvG7vgzCjwWyG3seWlxNJkj2HL6xZCJ56UAqzktMIHlm2UsSa8kNv+jfKswsUwqgUlpUxEJzn+K6peqmQ82zjegMKxetHd+axbbnE8lHNqhTo8sTLGUoiLHJiImfbOgtGRWYkjS0l3lv/RqfVbaApTo0H+EVghMmmcpSAjtjH0GZTm2pC0Jry/lC5IzXgbWrppJFk4m7Gsx0ilbLHgc6r6ptsjWkb6jJaOkIHg/q7cOFGy26rYk5sNBGK+Pr4HVonfwmxBwjVWT7fbZ8eG+e0B5V7UM8HxX0uC3x9nR8DPk6Msa7mPXG7l0o+kBO3CABF/CFtLmIlili8M424FaVAFSoq35dp+Kf6gpLxF/gLZ5JJcVZ5K454NFMFhZ+9FjsLHth6v8pSRDYIOmhF8267pRzvuPp6Yo/KqDkpFE+YhL0RdOERwsJngaEK+0IDi/BObd2H7sZ9PRBGeYNpLURIPBru8i1tMkbTB736BdyZbxXsUt0QuVexobsvZIucDi40hDCVsHen06Bj2Dio+j+BpoVMno7Jg== 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:(13230022)(39860400002)(396003)(136003)(366004)(376002)(346002)(451199015)(5660300002)(8676002)(4326008)(7696005)(66476007)(64756008)(316002)(66446008)(66556008)(8936002)(52536014)(33656002)(6506007)(122000001)(41300700001)(38070700005)(71200400001)(54906003)(55016003)(110136005)(9686003)(2906002)(44832011)(86362001)(478600001)(26005)(186003)(38100700002)(76116006)(66946007); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: BjuoahOVuL0A5RrF6jtfgEP+46ZQMUbY9haXP1bQUmRq9ZgHLfO/gBCebtjQLVI5JjZfWr3cT8vR6wfVkVZNgfyY+gO9XGEnnMZBKpH/+Dw399sp07T+rh4Z9enSrZVKbZhEvjK+exmN/ZwNgPPdmKF6lCsFRkUI8TMJi6nU8CpDK1A+2WCwm+C1g5HiofOG3MDDrEYsIeuV+sUIlQjhvyAuXvtQGSfzIjHjjApftlrQGRMHbFQM8ykTGBOJ6+E0C57hzflyRuD9iQ76ARKpG+KaCfpbOjKO0mmvXrfA4HnKGwG7BEe9qjgy11q9QwRSjorQOnghQZpd4OADizObOTlIYCHHVUNAFo0VV5K7fnexoX+Yz1ZNdHao3sczxMiFTQ5IO9xXLjI9ZvzCI7N/703PWC0/wU+TQFaA8Qa6TakA339gE7lYqkZfFYBjwPUsOIWNvd97CRfn8fJt5YPGl0qtCVzPyFR9kyFBD3zYu3+5YeoeW6XwhgCUlB+hBsAT6Cmjz18JOK0DoMsSu0AZcZdvMmhL0VlQ/dlc/PyFpsoRzPjlPNemlUovtGStB9Qy+28hk8Bx6TBCF6G6FDaBRY4hqX1Kf6OB2mykHS0KN+a6tcrcwcpWJDPq2Z0kbnG0DW/twczgpzAJ5SgU5cRjERpOqEeKSsbSoeIdvJY0WRo0TGqx2zR8M7fuXvF3nfsyXLnMwrJi98gxKqx+dOHl96pXCiZAij2ro00Exvyoy3a9OOegXORtdjVEO7 wyWJrwP2J3HsHAcgVxEIJp1tDy1yx0r/13JA5rb3Fg5xH8WyJOvMDjQXOfR4yXczBbob98DhBBrM49Hc38gFFs8RqJ9gMvRz8Z X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: T6i/QUbSzUpK1PF47QckmV0X2Jn++UhDFf88V5rhE4e6eczkg/qYqbx8jl9uLo6EwQzMmax1Hw4tSU3GzucNy/Nqw5TDAKKVs0kcLP76ot+N5Y3Qw8B8ZBVJgDcdc0Ym/v+6jfBa3yEpM36sXAfDnmk2og3Dd1D/8Yo08nRalMIRc0/jOR32g7psOj2XLHUgWhaqLOyIxSv0+NocMb/s/sf6OZEpjeBCQ2u9aE7PimR9DPgi0cOHHTw8rjXYumTMAu5IA/e08c7Dkd+HBTsNL/jLFMTpEL5onfVfLppbjS9WzqkaJOn3aHJUpUKMznJj9oIrtt8ryv87DoOkSCc6ddKDAYjWd3Wm7b7KnRZilLnukjgfiy1FXFOehL+L3KoaNfsxp/YBlKe6IBKqK/Pr0/2oBCqy/3qzWI/TZpxuhwMz3blX/fLGIWnkmWgl5561PXj1fGrXQpjh4M4FfnhKfBt4vNP07EipC0vCmlEvYbs6/Ftys+FQxjGHeug/mryV/rib263oTzQcbHQ6O/e+Weaz5y4/bi1BPuMCDZzScyemNQeH+whRRBjUUbap4RSobtLGCWawF/TT8dsERMoSiceqzogH75lYyQd1hslkJMb7disga77p83okV5p1tU59pMVcgd69HkKaI1mwLJnP1tj4/RlCVDN+iGMRmK91BSEeWyqeRaxjApM3j+4Sog7u5+BdqkYDTOozR3xA25EcX/3WOleAB8pYyttz+bWN7r1VX4 qurb094haOUdDV4p1lM3kwTVsuafGCUoUJKOByqeg8ffQ7CxZM+UsgBYF7qJpemqX2YngM77+lsd2qxPtSP0fwQIZgX6jJxj+h 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: babc9084-cade-4818-3939-08dafb319998 X-MS-Exchange-CrossTenant-originalarrivaltime: 20 Jan 2023 21:59:27.4737 (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: CMRb4ft6S8wB/Ym4RtDAYj/2PFP67amEnWYEZbOWlsnsMpOb4Ps6cEAe15FmnOLLu/iBagf56QZQJkFEaCWn5A== X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH0PR10MB4937 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-20_11,2023-01-20_01,2022-06-22_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxscore=0 phishscore=0 spamscore=0 mlxlogscore=975 bulkscore=0 malwarescore=0 adultscore=0 suspectscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2212070000 definitions=main-2301200210 X-Proofpoint-GUID: 9uRJApjDnXccdA4EKa0ymbtvNrwiZRJ1 X-Proofpoint-ORIG-GUID: 9uRJApjDnXccdA4EKa0ymbtvNrwiZRJ1 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:253808 Archived-At: Caveat: I'm not following this thread; sorry. A quick look at your patch shows this: The commands @kbd{C-h f} and @kbd{C-h v}, also described above +(@xref{Name Help}), in an Info buffer can be replaced by @kbd{Ret} or +@kbd{mouse-1} on quoted symbol names. I think it's wrong to say that `mouse-1' does that. At least I hope it's wrong, and that you correctly used the behavior that `mouse-1' only does that if option `mouse-1-click-follows-link' is non-nil. I also disagree with calling these "buttons". I think that Info calls them "links". E.g., in (info)Help-Xref you see this: Such a cross reference looks like this: *Note Overview of Texinfo: (texinfo)Top. (After following this link, type 'l' to ^^^^ get back to this node.) And just the name of the above-mentioned option should make clear that these things are presented to users as "links", not "buttons". Its doc says: Non-nil means that clicking Mouse-1 on a link ^^^^ follows the link. ^^^^ The active bit of text is referred to as a "link", and so is the relation between this source location and the destination reached. You click a link to follow that link to its destination. Elisp may refer to creating a "button" for this, but for users we should call them "links", not "buttons".