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: Sun, 22 Jan 2023 22:09:28 +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> <86lelvvdj1.fsf@duenenhof-wilhelm.de> <834jsjkt16.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="15602"; mail-complaints-to="usenet@ciao.gmane.io" Cc: "60587@debbugs.gnu.org" <60587@debbugs.gnu.org>, "monnier@iro.umontreal.ca" To: Eli Zaretskii , "H. Dieter Wilhelm" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Jan 22 23:10:33 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 1pJiXo-0003t4-Rq for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 22 Jan 2023 23:10:33 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pJiXO-00086g-S9; Sun, 22 Jan 2023 17:10: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 1pJiXK-00086G-O8 for bug-gnu-emacs@gnu.org; Sun, 22 Jan 2023 17:10:02 -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 1pJiXK-0005L6-Fe for bug-gnu-emacs@gnu.org; Sun, 22 Jan 2023 17:10:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pJiXK-0002ZE-A7 for bug-gnu-emacs@gnu.org; Sun, 22 Jan 2023 17:10: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: Sun, 22 Jan 2023 22:10: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.16744253749804 (code B ref 60587); Sun, 22 Jan 2023 22:10:02 +0000 Original-Received: (at 60587) by debbugs.gnu.org; 22 Jan 2023 22:09:34 +0000 Original-Received: from localhost ([127.0.0.1]:52755 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pJiWr-0002Y4-GC for submit@debbugs.gnu.org; Sun, 22 Jan 2023 17:09:33 -0500 Original-Received: from mx0b-00069f02.pphosted.com ([205.220.177.32]:30024) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pJiWp-0002Xu-NE for 60587@debbugs.gnu.org; Sun, 22 Jan 2023 17:09:32 -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 30MLE8s7007842; Sun, 22 Jan 2023 22:09:31 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=vORBVSeuVov43q+I2dD4xEq4MrcvEw92EKMFobWZMJU=; b=qYb7l4XQ8QM7OUzVfdb2k2oMOPADKJricAxz0b90IqVZRCASHFKjJD6csh8m+utVMyH1 r6qQO6IPWVEvlOd8K3jOWCiixJceu6zCs0vPU5PdUAuTjef0C+jXplLNQOgmBTF5H+Xx 7ty4MbKlF4KcrELslugcLeMbKjzMij27VI1kJwJJYd27kWFypV1Orz2LLJNgl69PKkel e1zIxF9kUYY9QiqkIYUICQ8sMHYUB7c+dcaqZNHORkqQeeHH9rBLvk83P+fIN5KCdsyI 6+OiIy2QFJbuh1o+W7jQG+pxn8cCwrSy27OsXUx5sIfrxWbtcMyjEWrIoG3cmFdVbAU+ DQ== Original-Received: from iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (iadpaimrmta01.appoci.oracle.com [130.35.100.223]) by mx0b-00069f02.pphosted.com (PPS) with ESMTPS id 3n883c1ns9-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 22 Jan 2023 22:09:31 +0000 Original-Received: from pps.filterd (iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com [127.0.0.1]) by iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (8.17.1.5/8.17.1.5) with ESMTP id 30MLomoF013835; Sun, 22 Jan 2023 22:09:30 GMT Original-Received: from nam12-dm6-obe.outbound.protection.outlook.com (mail-dm6nam12lp2175.outbound.protection.outlook.com [104.47.59.175]) by iadpaimrmta01.imrmtpd1.prodappiadaev1.oraclevcn.com (PPS) with ESMTPS id 3n86g93bxm-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 22 Jan 2023 22:09:30 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=RTGIL90nxKG6zoa64Yad9BkjM6CxBfBxz7Wo1NpaVIddIBh3lE8FLdK8Om0ddvSBEWip0cmEhDk8Gd0mTJGpqKpMCDjTdU9GHmtP78NuDzgszntbTA2BdeMTb1Gx4HX8LNLhi1vNtnVw5EsSQtF8HVxU1B6aMkJfnaFCI15n9DSHxNs0LdVDrbGKn5D/YYvIYhrcgfRf8Fro2Rxd6bEGb2n9Cn4nk7WAQZ/cfxPorU937x7wLrSYJAM+O8D0DH0kHT4Tn0VUmV2pTG1qz3+zEC7Vz33jAg135koi1ylBSF9pCjhcAxoXjnyuZF5TBwiNNe+JP0JHYBR4xFzRPwndng== 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=vORBVSeuVov43q+I2dD4xEq4MrcvEw92EKMFobWZMJU=; b=fETwSCoOZc8K0cLiTyzlso989OZRUxgLlZBS2f1fTfihI0ynDAOJ2XQGYuqog/QnbiL01rDqh9wKao1nZZgNPVIXXNpC2J5kzOxrt8ta0yu7kVHs6ngiTaN7XWn7CCZZYtVBjDHnoGtp/4j5IyH3bYlzMWMPQ2+doFRkCo0++OAnzfzboclODxTOf3jCIUKikSOTxZouMPYih8GTJiIGedevQkjdg42eIJEK1FnMvTdcSQSfORJOYL547nbo4RLfss/noAr7RK/OKU6Uwc5KGM7BBdMF2V/KuQh7bl1tYVmoPONqvS98rAagVtZbQT0PP4GUyyHEe30cIwuJ3rkURg== 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=vORBVSeuVov43q+I2dD4xEq4MrcvEw92EKMFobWZMJU=; b=lBg0Xrl9jkR/nVTWjDyLbWA6f2wNHIp31XmNg0AIZnsF6TNsGW8fAbzkR9xB3yWn2sXQRrW9/lc+XYwdvYiZ5uJHGfR66e7xwC2N9SX5ULClVD66D5Mw/3B+aRuBh9k7EkilAHTfKy6vWUM36nP2vPkfU63tC5UQ7JeBS1kGRlw= Original-Received: from SJ0PR10MB5488.namprd10.prod.outlook.com (2603:10b6:a03:37e::19) by PH0PR10MB4470.namprd10.prod.outlook.com (2603:10b6:510:41::24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6043.16; Sun, 22 Jan 2023 22:09:28 +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.014; Sun, 22 Jan 2023 22:09:28 +0000 Thread-Topic: [External] : bug#60587: Patch for adding links to symbols' help documentation Thread-Index: AQHZLicEoXNYvVke2U2LVe2hSCnHWa6q/QbQ In-Reply-To: <834jsjkt16.fsf@gnu.org> Accept-Language: en-US Content-Language: en-US x-ms-publictraffictype: Email x-ms-traffictypediagnostic: SJ0PR10MB5488:EE_|PH0PR10MB4470:EE_ x-ms-office365-filtering-correlation-id: cede5881-7d28-43d8-bf5c-08dafcc5546d x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: wWi29wD2AWEy0HJenxrm6RUF1rXo9Ufi9YfrMJ2ZkZh79CZPJsceVXrqVOSKsc2Xc8urg6ZR7f7jMOKCfSyqPBP9ZaFYYaYAVJNb8e8eg7SwbG4S+AoIVH36h7kDCy3CykAQFu1y60cOAFXNBGyHXxQGWFad3KBeT15gRXBJTIVyZ8EacEdlLqYFrPLClj3PpMwx1lxUgWeVfW6De42cDUOG3RYgr9f4tjBGHVCN0HVmGBi2IDGPfT19etAJkz3F6TXsaLNgsa2BowuH/Anpj2+UprD7KmrGOd6H4K522tD+akLRCwIMgZY7Bc/qHt08/Um//UumlVlI2gVjYlUtxM7orwJHrp1Qp4d8emaixMHHoWhdayZx3vFveTvfVsx8q6tYeG+pz4OcmIHevX2ojzYRNhj87wcMTAVSae/8YkPsEsVEG/cYuptWZokdzkE16Urnqn77Zi134lARZsRd8Qk4PNiR4ttqvBTpzRWSnZ6LHhpqKQDrg+o9BM0fX0EniYDoK0hXSn5413+yzhIiz4GSiCT4cDsJsfxhx843jPLNCCs4mDe5YyT12r04zbkud1VQaGMCXNDfju+UnUXL2MfTSMXRgBlK47TzysGuvmSvXVgMVD7x1Zq+xt+ixWWJWCphlIVul+6yxm64WehUbwwk7M8yHslIAU2fHGEcOZ/kYCfAfRX1TppaQs+iwntY1PjYhl9rp0N8VB3bMvKlWQ== 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)(396003)(39860400002)(136003)(346002)(366004)(376002)(451199015)(38070700005)(55016003)(33656002)(86362001)(316002)(110136005)(54906003)(76116006)(66556008)(66476007)(66446008)(64756008)(26005)(186003)(9686003)(478600001)(6506007)(71200400001)(7696005)(66946007)(122000001)(38100700002)(83380400001)(8936002)(52536014)(41300700001)(2906002)(8676002)(4326008)(5660300002)(44832011); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: /BlXfpHToL9f0NTwzsNjU4L3oPn1OjmvzD+kDct3aCi/QAbXQhhIGe8gsxWemInh9ipso4JtNGTngf19WLq8m9xc3Yij7paKNOAfHkOAKgPR1QQcGzbYUgMuPiv7t/PHcW6qf7bZZmcMs4S29tWCcq9xslf9Jt2/N121ij6sdNcfLwGv04K2eE2iXv9jphlOUnprsp5xX/n5h3FMbuhbAdNXapwuns56Yxvy/utolR04l9S0SgPOAph2rchJHfUQJ3VoZ86A94uTLejo7j/jiPiQH+Dp1KbKEE4MRqHmqObYmQ8oAIfjb3Y9CLIK0wGoulaXrDdjvtAmHX4jsC0nSOTjp8ePLiAEXh60KGOu5fC4EjMndnOsBLg13ZAPQwAgmIehbDCG2KuEkCJtkjLkyXar+ULk0Xs7+BTvc9u/QXYVFUPyJUvrEJ4mTSiYHeiv+zuWSevjz1r13twnYgEEZQVu41cAw8t6FxRtY7R5fXlG53+GfXthNIJzp9ZblYv1lWV+8QEGss46WAEGihsT3kR2bfCKzHkgcKMjBRHZj9XMcwRnE5JDkhxzTAUsgqmJrh2UY5s5D38syj0QH0ZpE3F5YVh6vjC5oJAQyoczmSQW8fVRNwt3JVIU3J2LqInpaZFzfxsU3Cr4mPDyUD69fUc2JovUZPCyUS6n+9j6cbmW6KD+E+54WuHOQVxbUCK4ypeXWknDJ7XxK8KfL1Btk4zanBzPlzOXRqSyIoA4L98EH0p735a7xHZt7y 1cCLSC97C4Rp1vxOhnsMo5hzojPPj3KwvrL2rve+Jq71xn214uPXP/uczIklrPXHAm2qVTcerLprM9HiABCxFkM1I34zNVMrPv X-MS-Exchange-AntiSpam-ExternalHop-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-ExternalHop-MessageData-0: Ofk26nqnInggHqr+mpiDJ6fCkP75oqsfGyyHjwAkXQ4FpFVwx7OrSx9SCD3p+QLQU+Fh1TG4pSMhHpeR8YeaHC+0R/Ng4CjDazzPeS0wfuevq4RxT0kkPhA3tAjIva2mEYQepuWFraxBZgCGHtGVc43L+EOcb4xyrdKnreJhvaBzGM0bjwIXdR2p2r1CReIs5OhkQjSXl3WWWyhTguOmqFTnKM7h5QmROi9Ea+FKGhxQCJkQKIIzL8IxNFyIpVXK3U4wunLsVg5rRiCbeLwAwsjftHYhBIiGjMUrqht3mLtOHxkekXXiMObmpcYJ0YukULbrvV0Rua25BPFAxNn7fXwSe4W+K5rTkbs8M6BWNyEvL3yPXp64p3C4K33unmA+HpHGbWxrJef3QU9spLcliohSZVSCpP+bfSzbiAXPS7P2HRFM8G0OaEBvyjOD4+I1TkQYs+xxTUoc9cJ1if2CQyDAYUT86gNbZDfBrUFQ+s+A9fF6i/2VfldTic3kfZrye8DK8FOibLt3hnBEcv4FvSNcgy5NRtUZDx7CVPuQfuU+fh0RFuh9KmovNp8e84FGgSc0cVVKzZe/NibzooKQyLEUONOiJfHWX7bh2aHeWQi+ScSxd7dleCDwSWAXNxuoIT3FxuG9E2BG6cnjmeAVaHv58iuqskvzA1bgXQIvufwGNzy05vC0WxTIMw5vr3V+8Tk0YQdfuWqoBNYJQdWxaRbYrFOxQG7tqAXbRnNX+OKtyP 80FB3F9Xgs6YTAqkmUQhcI46ENSETjGIjFDbEmv4ROEuVhueTMCd+kgu/5+BxNnnLvv3ZAf9P8XrGeemqkB51GqNX1TV5QdOQN 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: cede5881-7d28-43d8-bf5c-08dafcc5546d X-MS-Exchange-CrossTenant-originalarrivaltime: 22 Jan 2023 22:09:28.0957 (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: EWzd8b+uGVVzl/5uhTsLOPuBe2eo6JJ5lm0lYD2cf7+pgRKwB2VcyEyRgLdlSF+j6sRdSyG8quXE+90dWg7B3g== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH0PR10MB4470 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-22_18,2023-01-20_01,2022-06-22_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 bulkscore=0 phishscore=0 mlxlogscore=963 adultscore=0 mlxscore=0 suspectscore=0 spamscore=0 malwarescore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2212070000 definitions=main-2301220217 X-Proofpoint-ORIG-GUID: _NTbHI8PuzGVhEP0mQ2mz-INlwC-eyeX X-Proofpoint-GUID: _NTbHI8PuzGVhEP0mQ2mz-INlwC-eyeX 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:253963 Archived-At: > > Shouldn't I address the concern of Drew, as well? That a "button" is a > > certain technical implementation of linking which might not be known by ^^^^^^^^^^^^^^^^^^^^^^ > > the reader. Maybe a term like "link button" or "link-button" conveys - > > at the same time - the well known concept and correct technique, > > different from an Info link (or "cross reference")? >=20 > I think "button" is problematic,=20 Did you perhaps mean _not_ problematic? I said it's problematic, and you don't seem to agree with me. Or maybe you meant only "button" in "link button". In that case, I agree with you. We should just say "link". > and have no idea why Drew thinks we > should use another term here. Another term than "button"? Or "link-button"? Drew thinks we should use the same standard term we use everywhere - including in Info: for users it's a link, not a button. It may be implemented in Elisp by something Elisp calls a "button" (not a great name, but not important here) - but that's now what Emacs calls it in communicating with users. In particular, it's not how the Info docs refer to it. For users it's a link. > The code does insert buttons, right? The code implements links by inserting what Elisp calls "buttons", yes. Is how the code implements links what's important here? > If the user types "M-x describe-text-properties RET", > will he/she see that there's a button at point? Dunno what Dieter's code shows for that. But this is what doing that on an xref link in Info shows: There are text properties here: font-lock-face info-xref fontified t help-echo [Show] mouse-face highlight I wouldn't say that a user is told there's a button there.