GNU bug report logs - #77969
[PATCH] Add buttons to manuals in some commentary sections

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: emacs; Reported by: Morgan Smith <Morgan.J.Smith@HIDDEN>; Keywords: patch; dated Mon, 21 Apr 2025 18:01:02 UTC; Maintainer for emacs is bug-gnu-emacs@HIDDEN.

Message received at 77969 <at> debbugs.gnu.org:


Received: (at 77969) by debbugs.gnu.org; 26 Apr 2025 14:55:43 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Apr 26 10:55:42 2025
Received: from localhost ([127.0.0.1]:33981 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1u8gwQ-0007LR-DB
	for submit <at> debbugs.gnu.org; Sat, 26 Apr 2025 10:55:42 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:55102)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1u8fF8-0004qg-Vu
 for 77969 <at> debbugs.gnu.org; Sat, 26 Apr 2025 09:06:55 -0400
Received: from fencepost.gnu.org ([2001:470:142:3::e])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <eliz@HIDDEN>)
 id 1u8fF0-0002NW-E6; Sat, 26 Apr 2025 09:06:46 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org;
 s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date:
 mime-version; bh=BvHtzs8yBgY66u+0k/VbecfZuV1HrV8TO4ZylsKwKVs=; b=TCvk85B4SFp1
 Rk2lejtO+6kumHtD5VBFq6+z7Otoq7Z2oogDCmpasAIbMDqENsvyv3DSseA5i7ZbnN0IfGILuJXnP
 hhTsaKLcg8tJ1zHcq/VJwWueF3K4pJxzSpQ+/lzLTt0GJhZcBG8+S02mx0x8p2xk3/UyJoW02mLCi
 kJS6CyAcmouq5FKXxRHsNedR46oNadgVbkQ5/o3PQMGIWAOzXVxiMXXx5VnNRGKKw18JoHhqycvsj
 eSQrIvz94pnl/gCbWNphixgkq4q8LI436hOqmIkALH6i3fAam6t3AEeGbK7Ecx/TB5nRgerWS8Hek
 X66QH3B7UJHt0MsPA76nTA==;
Date: Sat, 26 Apr 2025 16:06:37 +0300
Message-Id: <86plgzt6le.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
To: Morgan Smith <Morgan.J.Smith@HIDDEN>,
 Stefan Kangas <stefankangas@HIDDEN>, Andrea Corallo <acorallo@HIDDEN>,
 Stefan Monnier <monnier@HIDDEN>
In-Reply-To: <CH3PR84MB34245803E90A030D3AC61A8FC5B82@HIDDEN>
 (message from Morgan Smith on Mon, 21 Apr 2025 13:54:47 -0400)
Subject: Re: bug#77969: [PATCH] Add buttons to manuals in some commentary
 sections
References: <CH3PR84MB34245803E90A030D3AC61A8FC5B82@HIDDEN>
X-Spam-Score: 0.7 (/)
X-Debbugs-Envelope-To: 77969
X-Mailman-Approved-At: Sat, 26 Apr 2025 10:55:41 -0400
Cc: tromey@HIDDEN, stephen.berman@HIDDEN, dan@HIDDEN, eli@HIDDEN,
 John Wiegley <johnw@HIDDEN>, terra@HIDDEN, jbw@HIDDEN,
 bug-cc-mode@HIDDEN, occitan@HIDDEN, umerin@HIDDEN,
 rfrancoise@HIDDEN, larsi@HIDDEN, 77969 <at> debbugs.gnu.org, tzz@HIDDEN,
 ohler@HIDDEN
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.3 (/)

> From: Morgan Smith <Morgan.J.Smith@HIDDEN>
> Date: Mon, 21 Apr 2025 13:54:47 -0400
> 
> Tags: patch
> 
> This patch will affect how a lot of packages get presented to the user.
> 
> Run `M-x package-list-packages'.
> 
> Now go down to 'use-package' and press the button (RET) to pull up the
> package summary.
> 
> At the bottom of that summary it says "See the `use-package' info manual
> for more information.".  The "`use-package'" bit is a button will take
> you to a Help buffer describing the macro.  This is not ideal as the
> sentence is talking about the Info manual.
> 
> After my change the sentence will change too "See Info node
> `(use-package)' for more information." where the "`(use-package)'" part
> is a button that takes you to the info manual.

If we want something like this at the beginning of each Lisp package,
we need to augment our conventions and tips to say that.




Information forwarded to bug-gnu-emacs@HIDDEN:
bug#77969; Package emacs. Full text available.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 21 Apr 2025 18:00:18 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Apr 21 14:00:18 2025
Received: from localhost ([127.0.0.1]:38169 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1u6vRF-0004Ul-CF
	for submit <at> debbugs.gnu.org; Mon, 21 Apr 2025 14:00:18 -0400
Received: from lists.gnu.org ([2001:470:142::17]:42212)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <Morgan.J.Smith@HIDDEN>)
 id 1u6vRA-0004O6-Er
 for submit <at> debbugs.gnu.org; Mon, 21 Apr 2025 14:00:10 -0400
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 <Morgan.J.Smith@HIDDEN>)
 id 1u6vR3-0006Ir-PA
 for bug-gnu-emacs@HIDDEN; Mon, 21 Apr 2025 14:00:02 -0400
Received: from mail-bn8nam11olkn2056.outbound.protection.outlook.com
 ([40.92.20.56] helo=NAM11-BN8-obe.outbound.protection.outlook.com)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <Morgan.J.Smith@HIDDEN>)
 id 1u6vR1-0006Zg-1w
 for bug-gnu-emacs@HIDDEN; Mon, 21 Apr 2025 14:00:01 -0400
ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none;
 b=QAIEME9Zwx1Nv1aeL4Tiq5sNim3GAHIzBmUJu8zu+EZZU6HcQ5bSS4C0KyNRHNyn/uc7O8g8W7hEwlUYulWMOqfY5X78OtMYYoouc3S7z8/unW0Jl/qVOQvPr2TwFh6COn0dn660sZA8wHsU8Pb1Z5qBjYheyHYWppez/JSLi4leOWB1cSSg+DtlhtX8IOvg7+5BbYpM1WML9xn+6B4+yTfk7GmIbOhTyNi9TyYr82qlpKi883pO7pOeUazqwEz0IDBFvvgfJzcZS+LH7GfOejy48elPSd8PfrC4RtzHln4FELaF3ziiAJlap86Nv8Qpxw3dbpl4rKhork9C6zKHyg==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; 
 s=arcselector10001;
 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=SU+sjasf00bB3OKfUfZAHk3Nnxbqo4nzhgipr3QZhz0=;
 b=uZYgssh6OiP9jiHbqvGpY666ISkqrga5x9FxXhtRj316EFPf01IMc71ui1KcwoI6xk2K6CRgt3DsWye6D5CgGn4seBnOnFjEskkYr9R/WvIwaGoebBzWLugubN3ym+YGl0Lxz6OD6wD532NaAsshSnG4PsYu3LiUzOjXU04+V8L7ItCRMID7oI46VDtH9TfJ/Nl1W6R0WPRexNjL92TKvQg6QZR+Q3vyFQgsWbyTJ0BK5XDT6Nh98nlNt1Ne7mYDkVyXSvE4Sa1ErpcLy+PZ2w49efIjizFYNw9tmiptyNvDooNvvmqzV2cJdymDUHc/uDLsHQZWpQWi+ZYyewPi9g==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=none; dmarc=none;
 dkim=none; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=outlook.com;
 s=selector1;
 h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;
 bh=SU+sjasf00bB3OKfUfZAHk3Nnxbqo4nzhgipr3QZhz0=;
 b=WteLvGlYcV8YQ0MZqCllFvSYH4XoF0+bHH/H1P3DjpPCdPC/nmM7cnhC4vm2evxWCiVsv5g/NiDOXMvuuEs4NcFV7QWNaTb/IjoMAAUo6xl+kkKEQeAWYNz3z+JmzygR102OEBsywWkGkScigdRr+g7Yxm+4Bb5dOVCsl6ouayMyDgI5l21+yEdlNNVVx8nwdKQhZnAAxqSuklEyPW0q03ZQNVraqCjyT/dnJRkL8+zvHV5kp+on6QCRV2PiDBd54ASNHppUK3cz1v82Tr1I3WISdYUQo6B/Y9mA8QG1meujEW9hdYcd6JGEHN5s+rf5dcAWBpqLx8ru4csBP0ZngQ==
Received: from CH3PR84MB3424.NAMPRD84.PROD.OUTLOOK.COM (2603:10b6:610:1c4::17)
 by DS7PR84MB3014.NAMPRD84.PROD.OUTLOOK.COM (2603:10b6:8:86::15) with
 Microsoft SMTP Server (version=TLS1_2,
 cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8655.35; Mon, 21 Apr
 2025 17:54:53 +0000
Received: from CH3PR84MB3424.NAMPRD84.PROD.OUTLOOK.COM
 ([fe80::5c77:7a58:48ed:9aef]) by CH3PR84MB3424.NAMPRD84.PROD.OUTLOOK.COM
 ([fe80::5c77:7a58:48ed:9aef%5]) with mapi id 15.20.8655.031; Mon, 21 Apr 2025
 17:54:53 +0000
From: Morgan Smith <Morgan.J.Smith@HIDDEN>
To: bug-gnu-emacs@HIDDEN
Subject: [PATCH] Add buttons to manuals in some commentary sections
X-Debbugs-Cc: Christian Ohler <ohler@HIDDEN>, Christian Ohler
 <ohler@HIDDEN>, John Wiegley <johnw@HIDDEN>, John Wiegley
 <johnw@HIDDEN>, John Wiegley <johnw@HIDDEN>, John
 Wiegley <johnw@HIDDEN>, Justin Talbott <justin@HIDDEN>,
 John Wiegley <johnw@HIDDEN>, John Wiegley
 <johnw@HIDDEN>, John Wiegley <johnw@HIDDEN>, John
 Wiegley <johnw@HIDDEN>, nil <bug-cc-mode@HIDDEN>, Masanobu UMEDA
 <umerin@HIDDEN>, Lars Magne Ingebrigtsen
 <larsi@HIDDEN>, Tom Tromey <tromey@HIDDEN>, Daniel Hackney
 <dan@HIDDEN>, Christian Ohler <ohler@HIDDEN>, Romain Francoise
 <rfrancoise@HIDDEN>, Stephen Berman <stephen.berman@HIDDEN>, Eli
 Barzilay <eli@HIDDEN>, John Wiegley <johnw@HIDDEN>, Ted
 Zlatanov <tzz@HIDDEN>, Morten Welinder <terra@HIDDEN>, Joe Wells
 <jbw@HIDDEN>, Daniel Pfeiffer <occitan@HIDDEN>
Date: Mon, 21 Apr 2025 13:54:47 -0400
Message-ID: <CH3PR84MB34245803E90A030D3AC61A8FC5B82@HIDDEN>
Content-Type: multipart/mixed; boundary="=-=-="
X-ClientProxiedBy: YQXPR0101CA0043.CANPRD01.PROD.OUTLOOK.COM
 (2603:10b6:c00:14::20) To CH3PR84MB3424.NAMPRD84.PROD.OUTLOOK.COM
 (2603:10b6:610:1c4::17)
X-Microsoft-Original-Message-ID: <87v7qxpfh4.fsf@HIDDEN>
MIME-Version: 1.0
X-MS-Exchange-MessageSentRepresentingType: 1
X-MS-PublicTrafficType: Email
X-MS-TrafficTypeDiagnostic: CH3PR84MB3424:EE_|DS7PR84MB3014:EE_
X-MS-Office365-Filtering-Correlation-Id: eb42de9e-ac71-49f2-43c2-08dd80fd9deb
X-MS-Exchange-SLBlob-MailProps: 9qw5+ftluCAM1FFngAzN7XbDJo2G9MNnHjPXCKDuyoP+14liFCs/rHlpBoCSZVcPsTRg6o5IPcJ8XJJZM0CseQcT5RxL7FqQ67lcsN7y5Zgm8GRc8ZlnitRV46Hwy284e8ecQV4yTpc+FpSF5P9EyNM6BoELVOgLqGaFW70H5T2wOk647/VNIOhfsH5T/W+jsRZw/2mi72lPhDITdCvcQY7QxpE4WowX22WHyB/Xc5AlPPgpAEkR0lr+G2uHfaYdYMEZmVVYGBmr+PVPqOw2Do97CrwFIpO4xEupcxm+MrZ/IF6RagwBAXaLgM6HkpDwJnDOSC3t6wgfHR/hIONx2F2E81K1nSLtUWIsfxVHCallS79dICRTcVFnWfoSVu79X5W+Uj69bnmLv1iyfROfXGjJaeoXeBB9kA+7M9b/MImCg6WL3Dwoi18x/6qxHkiHf5XtOSpdhDKBvdS2Gk1HM5D3+1qWcO2tS/4O4m9F6CLwMdTJb4+47q0Oej6Kyz5xAWq3eRY0CBOBnk59UfHCLWDgGFJ2rj2jphBBRNAytcD4ZTejaTltW3iJXFIeIxbSPwej/wIz3WtelCf/74hHgNtNNIZ3kyb4Vg+XNGCBx009bGmvVu0GjbrJYIADI4/9DNTQltn9JTfP9SywT7KBH/NKrUgqDW30RwQaZ9scn794+3cFqLcZp1mTys62J2p7zWUTKOGsowE=
X-Microsoft-Antispam: BCL:0;
 ARA:14566002|461199028|8060799006|5072599009|19110799003|15080799006|7092599003|6092099012|13095399003|440099028|3412199025|41001999003|56899033;
X-Microsoft-Antispam-Message-Info: =?us-ascii?Q?KwJOaHLcy1VTnfSHkvCwLZ+Lyiy/aBPTYW+ioILJazflEvsK+4hauxT4B/6K?=
 =?us-ascii?Q?pHkeum2iU2PwShUw2vrPOWpEKq1IfTJdL/1TYGUPI0yNRIVl4Ey0llN8m2Z4?=
 =?us-ascii?Q?+PEv9UzTK+Je5gj4vDhUzmgfdAS8EhldvZduAj4kGKPXleJjZAhW+na+Ntr7?=
 =?us-ascii?Q?vLExaTgpMPM5duvXe94bTN9JdaZWrww9b+CB4hUdK8cIS4gLU9IluvfHffpn?=
 =?us-ascii?Q?QxqyePkcoznztTwzBlfIUkTqXRkgr9v68MvW6Dj1DOz/Tb2cBUYyLAE2osa1?=
 =?us-ascii?Q?ZZgJHZ8r/dsJgqe2gyI9A8cxCyajus7ZBTvDnvvS8ts5ZlrN8+oJhP/jlPJ8?=
 =?us-ascii?Q?8IyKHiLulmG58coC/PE/6sOE/7ECDpzk76Uwmz/oXOzXOm9laZ4alTE1/k7g?=
 =?us-ascii?Q?/p7hwcQVGGcRqJm6NfAF6VQzv81uTTsaD0uKerag0py46rv11KWOKwilsAc5?=
 =?us-ascii?Q?kjUj2RPJleiWcadzYD7CgcMt7CgT9YLCInNNc47O89fNK/k4czdJOpevmx7e?=
 =?us-ascii?Q?S32xGKpnuD3I4sG/vgeimM7Cbowccmcw5QuULWkg6mzvFzuCu+SHAqRGje1m?=
 =?us-ascii?Q?L6nE898hythD8ADo/WFuWoYptAXjj9Hpj3q30mFC7FglIPaYYRdwAAlbJVpC?=
 =?us-ascii?Q?8WLPN8WcWnjGwXD3UM3QcTHELZXSEMaqY22ZwRdpApxEoirU5uHYmMozuEsv?=
 =?us-ascii?Q?EFrdUpLltI2pgIWJsnC3tWd3kapitDXG5FiQp6tQ82qQoCWRlUm2x60E226I?=
 =?us-ascii?Q?9jGfqg8qAqDI/qWvcEW3MZDUWz3pMmwpi6wyw4tVYIUl6cttqq/loM/vXy6H?=
 =?us-ascii?Q?CP65oxIvSNiXny5gM1aJXwNEXxn7rZaYH6LDASWkvan2oELsgk0bLByyo8dv?=
 =?us-ascii?Q?fvjL1hDkPZ0HCNnlelqf/KDQfkxa3dBfkyGjEC50VJf3IjfILm/nHItSAylU?=
 =?us-ascii?Q?XlsS9Ze8V0fICVxqRYS+lYUv8Fm1ZIqhiAPOSpWgjkZ2y1pZMWD28tjW9nTU?=
 =?us-ascii?Q?IS65WGaoH4Wt1NxJmqKNIC71UhHjRiZNYMpfxTcRRxyi3Wo7s51CtJsyjOmg?=
 =?us-ascii?Q?fSxgI2tRnrEHKODSsDQAeGGBjmwbBv1iliJ1b8KjyNB17jyT8TpBNL6B0ola?=
 =?us-ascii?Q?riV4gP6tfJtti66wNL43zVI7V2V66oLcuFgkoQreFjLQtv07hQUxAgewTx6Q?=
 =?us-ascii?Q?564FUMXpvSdrokLywY+FBEOzW8b9rHZEjOZ+yw=3D=3D?=
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?LD4epeLFlXEodmmDhuPzfUu5LtawJE9CYbXnk+vQW8Q8qEPyEsNm/jBI511R?=
 =?us-ascii?Q?Wu+WiA5o3IMkkI71mrMvr5rN69+cCcbF01BQX96aS2UwRHXzJjTfhTs7ilNZ?=
 =?us-ascii?Q?T3OtaP2uRqexr97hXnH6yCR39F+moMBQi32VhDTqecGbs1rKlCBEe5lpo1wj?=
 =?us-ascii?Q?3aMuevA0xxVOsln3ptvFMAzsJyoNYur+m3nx7SxtbqelA4EXk3gDueshXpNM?=
 =?us-ascii?Q?mjMlaN2AlOT4+BTPYfBxmc1X+XOxY5qGcTFIpp5t7Wu+vM06odIyKfnk4Q82?=
 =?us-ascii?Q?LtYwn5FtOWWk4ZpmCWIwNxk0HbJOcYnw5vFOh0ufk000cj6dhBiXONQzEykR?=
 =?us-ascii?Q?Rr71kscQkajS2TpTHDP1IbDniXdppvmGVMp1tpfT23E2lSeI+K7Szd/wwf/M?=
 =?us-ascii?Q?M3WkrRsG6k19GeddyMWMqmw8dPDqIQyg0sWxDMjhpCbeKZjzcse9i2j4VrYO?=
 =?us-ascii?Q?mzFnUDV+QRJL47aukKSvYSBUSZJB0991DgKY5Z8mHBlPliljYnfTQD77UtRN?=
 =?us-ascii?Q?HxPgzbaTSyj2nLCZsGlDgTEQDeGjCVvPoTsEamZXc52/OypEK3eBzoLjGixx?=
 =?us-ascii?Q?Urj4sMluo6J3W36OF8xEa2OEziE6lfXbjNvIHgJW4cXobTq1FafBwnHOiGeY?=
 =?us-ascii?Q?v+vb14JbR+vEPdw7VhqdxXijI+PHHEhdMIGCS0bzuh+Yg6kmJeebV76aEjKs?=
 =?us-ascii?Q?lXSYfnq00hSDCNF+LI9VrT6d/znIhY1CyqsABpiYXQYIrFIaXaJe7+vrrwSH?=
 =?us-ascii?Q?SDXRSVcqNKrAxGl+rgCpp6f4/UGsXn6jBcgJO5ODv6qw+3YmMC1R0bHmvJ9+?=
 =?us-ascii?Q?LRNnw44lolm3WegXSBw1RjKpJb/IoAvdqFxrEsR0wdtxKh7KDkDKtGFLERob?=
 =?us-ascii?Q?qIjWD8xeXc5DyWF7mgUR4I/6ph9EtFFi1nRHVTEDTYRfk7ujY3epkTgNkuuX?=
 =?us-ascii?Q?C4xZfRmD/fwmhGi+4wsUtjETKjt1GR9AEOkvl1ej8EYZdfyuqk20n9Xbx9jS?=
 =?us-ascii?Q?qLYzzd2SwM69HqgNjdnq9WAPTT10lUfr4APsFV+zCyVhu4YnjqmLOa3cm5Tx?=
 =?us-ascii?Q?9md4RXJ6WUcd7NUR8Lw1ei1RZb3X8wCr8VUW/xeRLEkaxROZkSrn2+DB2zTY?=
 =?us-ascii?Q?zatGW5/kmGtf6DhJpXa9yeobvtzPWJgq2JF+JKRT72WeKy1TmPWOjacooVZO?=
 =?us-ascii?Q?VVYHQYh61GL6Yszu9QDrZOb8GSpOGuQu60U6r5krUoSrwuPffUbSP9dyFqvM?=
 =?us-ascii?Q?reMYrvRMNISAHYCezG2re7/TgGlCiXq62Io/0uzhgQ=3D=3D?=
X-OriginatorOrg: outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: eb42de9e-ac71-49f2-43c2-08dd80fd9deb
X-MS-Exchange-CrossTenant-AuthSource: CH3PR84MB3424.NAMPRD84.PROD.OUTLOOK.COM
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 21 Apr 2025 17:54:53.3767 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa
X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg: 00000000-0000-0000-0000-000000000000
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DS7PR84MB3014
Received-SPF: pass client-ip=40.92.20.56;
 envelope-from=Morgan.J.Smith@HIDDEN;
 helo=NAM11-BN8-obe.outbound.protection.outlook.com
X-Spam_score_int: -20
X-Spam_score: -2.1
X-Spam_bar: --
X-Spam_report: (-2.1 / 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, FREEMAIL_FROM=0.001,
 RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=0.001,
 RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, RCVD_IN_VALIDITY_SAFE_BLOCKED=0.001,
 SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-Spam-Score: 1.0 (+)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.0 (/)

--=-=-=
Content-Type: text/plain

Tags: patch

This patch will affect how a lot of packages get presented to the user.

Run `M-x package-list-packages'.

Now go down to 'use-package' and press the button (RET) to pull up the
package summary.

At the bottom of that summary it says "See the `use-package' info manual
for more information.".  The "`use-package'" bit is a button will take
you to a Help buffer describing the macro.  This is not ideal as the
sentence is talking about the Info manual.

After my change the sentence will change too "See Info node
`(use-package)' for more information." where the "`(use-package)'" part
is a button that takes you to the info manual.



--=-=-=
Content-Type: text/patch
Content-Disposition: attachment;
 filename=0001-Add-buttons-to-manuals-in-some-commentary-sections.patch

From 70b377159ba525f65a626980fbf8bbfb789159a3 Mon Sep 17 00:00:00 2001
From: Morgan Smith <Morgan.J.Smith@HIDDEN>
Date: Mon, 21 Apr 2025 13:10:35 -0400
Subject: [PATCH] Add buttons to manuals in some commentary sections

* lisp/align.el:
* lisp/apropos.el:
* lisp/arc-mode.el:
* lisp/auth-source.el:
* lisp/autorevert.el:
* lisp/bind-key.el:
* lisp/calculator.el:
* lisp/calendar/calendar.el:
* lisp/calendar/icalendar.el:
* lisp/calendar/todo-mode.el:
* lisp/dired-x.el:
* lisp/emacs-lisp/ert.el:
* lisp/emacs-lisp/package.el:
* lisp/gnus/gnus.el:
* lisp/progmodes/cc-mode.el:
* lisp/textmodes/texnfo-upd.el:
* lisp/use-package/use-package-bind-key.el:
* lisp/use-package/use-package-core.el:
* lisp/use-package/use-package-delight.el:
* lisp/use-package/use-package-diminish.el:
* lisp/use-package/use-package-ensure-system-package.el:
* lisp/use-package/use-package-ensure.el:
* lisp/use-package/use-package-jump.el:
* lisp/use-package/use-package-lint.el:
* lisp/use-package/use-package.el:
* test/lisp/emacs-lisp/ert-tests.el:
* test/lisp/emacs-lisp/ert-x-tests.el:
Add button to Info manual in commentary section of file.

It is rendered as a button when the commentary is rendered in
help mode.  Like when a package is viewed using
`package-menu-describe-package'.

It is not rendered as a button by finder as that feature still
needs to be added to finder.
---
 lisp/align.el                                         |  2 ++
 lisp/apropos.el                                       |  2 ++
 lisp/arc-mode.el                                      |  2 ++
 lisp/auth-source.el                                   |  2 +-
 lisp/autorevert.el                                    |  2 ++
 lisp/bind-key.el                                      |  2 +-
 lisp/calculator.el                                    |  2 ++
 lisp/calendar/calendar.el                             |  2 ++
 lisp/calendar/icalendar.el                            |  2 +-
 lisp/calendar/todo-mode.el                            |  2 ++
 lisp/dired-x.el                                       |  4 ++--
 lisp/emacs-lisp/ert.el                                |  2 +-
 lisp/emacs-lisp/package.el                            |  2 ++
 lisp/gnus/gnus.el                                     |  2 ++
 lisp/progmodes/cc-mode.el                             |  4 ++--
 lisp/textmodes/texnfo-upd.el                          | 10 +++++-----
 lisp/use-package/use-package-bind-key.el              |  2 +-
 lisp/use-package/use-package-core.el                  |  2 +-
 lisp/use-package/use-package-delight.el               |  2 +-
 lisp/use-package/use-package-diminish.el              |  2 +-
 lisp/use-package/use-package-ensure-system-package.el |  2 +-
 lisp/use-package/use-package-ensure.el                |  2 +-
 lisp/use-package/use-package-jump.el                  |  2 +-
 lisp/use-package/use-package-lint.el                  |  2 +-
 lisp/use-package/use-package.el                       |  2 +-
 test/lisp/emacs-lisp/ert-tests.el                     |  2 +-
 test/lisp/emacs-lisp/ert-x-tests.el                   |  2 +-
 27 files changed, 42 insertions(+), 24 deletions(-)

diff --git a/lisp/align.el b/lisp/align.el
index 4263dfe0fa0..9db684ec572 100644
--- a/lisp/align.el
+++ b/lisp/align.el
@@ -23,6 +23,8 @@
 
 ;;; Commentary:
 
+;; See Info node `(emacs) Code Alignment'.
+;;
 ;; This mode allows you to align regions in a context-sensitive fashion.
 ;; The classic use is to align assignments:
 ;;
diff --git a/lisp/apropos.el b/lisp/apropos.el
index 0d642bcdab6..fcf09f46446 100644
--- a/lisp/apropos.el
+++ b/lisp/apropos.el
@@ -24,6 +24,8 @@
 
 ;;; Commentary:
 
+;; See Info node `(emacs) Apropos'.
+;;
 ;; The ideas for this package were derived from the C code in
 ;; src/keymap.c and elsewhere.
 
diff --git a/lisp/arc-mode.el b/lisp/arc-mode.el
index 28be1e9c617..583bd6181e9 100644
--- a/lisp/arc-mode.el
+++ b/lisp/arc-mode.el
@@ -24,6 +24,8 @@
 
 ;;; Commentary:
 
+;; See Info node `(emacs) File Archives'.
+;;
 ;; NAMING: "arc" is short for "archive" and does not refer specifically
 ;; to files whose name end in ".arc"
 ;;
diff --git a/lisp/auth-source.el b/lisp/auth-source.el
index 946debca95e..6c22ffecb9e 100644
--- a/lisp/auth-source.el
+++ b/lisp/auth-source.el
@@ -27,7 +27,7 @@
 ;; of providing 5000 options, we'll stick to simple, easy to
 ;; understand options.
 
-;; See the auth.info Info documentation for details.
+;; See the Info node `(auth)' for details.
 
 ;; TODO:
 
diff --git a/lisp/autorevert.el b/lisp/autorevert.el
index e6a12d37ad1..da65fe0c164 100644
--- a/lisp/autorevert.el
+++ b/lisp/autorevert.el
@@ -24,6 +24,8 @@
 
 ;;; Commentary:
 
+;; See Info node `(emacs)Auto Revert'.
+;;
 ;; Introduction:
 ;;
 ;; Whenever a file that Emacs is editing has been changed by another
diff --git a/lisp/bind-key.el b/lisp/bind-key.el
index 12417106783..e5190c2cefa 100644
--- a/lisp/bind-key.el
+++ b/lisp/bind-key.el
@@ -99,7 +99,7 @@
 ;; what the default was.  Also, it will tell you if the key was rebound after
 ;; your binding it with `bind-key', and what it was rebound it to.
 ;;
-;; See the `use-package' info manual for more information.
+;; See Info node `(use-package)' for more information.
 
 ;;; Code:
 
diff --git a/lisp/calculator.el b/lisp/calculator.el
index 337560d38c9..d2fb8b41c25 100644
--- a/lisp/calculator.el
+++ b/lisp/calculator.el
@@ -22,6 +22,8 @@
 
 ;;; Commentary:
 
+;; See Info node `(calc)'.
+;;
 ;; A calculator for Emacs.
 ;; Why should you reach for your mouse to get xcalc (calc.exe, gcalc or
 ;; whatever), when you have Emacs running already?
diff --git a/lisp/calendar/calendar.el b/lisp/calendar/calendar.el
index 08ecd586ec1..5234bfc3135 100644
--- a/lisp/calendar/calendar.el
+++ b/lisp/calendar/calendar.el
@@ -25,6 +25,8 @@
 
 ;;; Commentary:
 
+;; See Info node `(emacs)Calendar/Diary'.
+;;
 ;; This collection of functions implements a calendar window.  It
 ;; generates a calendar for the current month, together with the
 ;; previous and coming months, or for any other three-month period.
diff --git a/lisp/calendar/icalendar.el b/lisp/calendar/icalendar.el
index 9ad393cb061..298d6dd8bde 100644
--- a/lisp/calendar/icalendar.el
+++ b/lisp/calendar/icalendar.el
@@ -26,7 +26,7 @@
 
 ;;; Commentary:
 
-;; This package is documented in the Emacs Manual.
+;; See Info node `(emacs) Importing Diary'.
 
 ;;   Please note:
 ;; - Diary entries which have a start time but no end time are assumed to
diff --git a/lisp/calendar/todo-mode.el b/lisp/calendar/todo-mode.el
index 445f37287c3..5c293ca1b6b 100644
--- a/lisp/calendar/todo-mode.el
+++ b/lisp/calendar/todo-mode.el
@@ -24,6 +24,8 @@
 
 ;;; Commentary:
 
+;; See Info node `(todo-mode)'.
+;;
 ;; This package provides facilities for making and maintaining
 ;; prioritized lists of things to do.  These todo lists are identified
 ;; with named categories, so you can group together thematically
diff --git a/lisp/dired-x.el b/lisp/dired-x.el
index 89390a482f0..d93c594772a 100644
--- a/lisp/dired-x.el
+++ b/lisp/dired-x.el
@@ -26,7 +26,7 @@
 ;;; Commentary:
 
 ;; This is based on Sebastian Kremer's excellent dired-x.el (Dired Extra),
-;; version 1.191, adapted for GNU Emacs.  See the `dired-x' Info manual.
+;; version 1.191, adapted for GNU Emacs.  See the Info node `(dired-x)'.
 
 ;; At load time dired-x.el will install itself and bind some Dired keys.
 ;; Some dired.el and dired-aux.el functions have extra features if
@@ -34,7 +34,7 @@
 
 ;; User customization: M-x customize-group RET dired-x RET.
 
-;; *Please* see the `dired-x' Info manual for more details.
+;; *Please* see the Info node `(dired-x)' for more details.
 
 
 ;;; Code:
diff --git a/lisp/emacs-lisp/ert.el b/lisp/emacs-lisp/ert.el
index b021c4d704c..1f482d754c1 100644
--- a/lisp/emacs-lisp/ert.el
+++ b/lisp/emacs-lisp/ert.el
@@ -47,7 +47,7 @@
 ;; checking the test environment (like availability of features,
 ;; external binaries, etc).
 ;;
-;; See ERT's Info manual `(ert) Top' as well as the docstrings for
+;; See ERT's Info node `(ert) Top' as well as the docstrings for
 ;; more details.  To see some examples of tests written in ERT, see
 ;; the test suite distributed with the Emacs source distribution (in
 ;; the "test" directory).
diff --git a/lisp/emacs-lisp/package.el b/lisp/emacs-lisp/package.el
index a255778af64..a9de0c15e5e 100644
--- a/lisp/emacs-lisp/package.el
+++ b/lisp/emacs-lisp/package.el
@@ -26,6 +26,8 @@
 
 ;;; Commentary:
 
+;; See Info node `(emacs) Packages'.
+;;
 ;; The idea behind package.el is to be able to download packages and
 ;; install them.  Packages are versioned and have versioned
 ;; dependencies.  Furthermore, this supports built-in packages which
diff --git a/lisp/gnus/gnus.el b/lisp/gnus/gnus.el
index 53b7c332ded..7a018360cb0 100644
--- a/lisp/gnus/gnus.el
+++ b/lisp/gnus/gnus.el
@@ -25,6 +25,8 @@
 
 ;;; Commentary:
 
+;; See Info node `(gnus)'.
+
 ;;; Code:
 
 (run-hooks 'gnus-load-hook)
diff --git a/lisp/progmodes/cc-mode.el b/lisp/progmodes/cc-mode.el
index fa3788ba383..a2474977275 100644
--- a/lisp/progmodes/cc-mode.el
+++ b/lisp/progmodes/cc-mode.el
@@ -32,7 +32,7 @@
 ;;; Commentary:
 
 ;; NOTE: Read the commentary below for the right way to submit bug reports!
-;; NOTE: See the accompanying texinfo manual for details on using this mode!
+;; NOTE: See the accompanying Info node `(ccmode)' for usage details!
 ;; Note: The version string is in cc-defs.
 
 ;; This package provides GNU Emacs major modes for editing C, C++,
@@ -46,7 +46,7 @@
 ;; across all modes.  This indentation model is intuitive and very
 ;; flexible, so that almost any desired style of indentation can be
 ;; supported.  Installation, usage, and programming details are
-;; contained in an accompanying texinfo manual.
+;; contained in an accompanying Info node `(ccmode)'.
 
 ;; CC Mode's immediate ancestors were, c++-mode.el, cplus-md.el, and
 ;; cplus-md1.el..
diff --git a/lisp/textmodes/texnfo-upd.el b/lisp/textmodes/texnfo-upd.el
index 51505faa03d..6bbac89df9c 100644
--- a/lisp/textmodes/texnfo-upd.el
+++ b/lisp/textmodes/texnfo-upd.el
@@ -43,11 +43,11 @@
 ;; the `Next', `Previous' and `Up' pointers on @node lines.  Most
 ;; manuals, including those whose Texinfo files adhere to the structure
 ;; described below, don't need these pointers, because makeinfo will
-;; generate them automatically (see the node "makeinfo Pointer
-;; Creation" in the Texinfo manual).  By contrast, due to known bugs
-;; described above, texinfo-update-node etc. could produce incorrect
-;; pointers, and thus make a perfectly valid Texinfo file into an
-;; invalid one.  You _have_ been warned!
+;; generate them automatically (see the Info node `(texinfo) Writing a
+;; Node').  By contrast, due to known bugs described above,
+;; texinfo-update-node etc. could produce incorrect pointers, and thus
+;; make a perfectly valid Texinfo file into an invalid one.  You _have_
+;; been warned!
 ;;
 ;; In brief, the functions for creating or updating nodes and menus, are:
 ;;
diff --git a/lisp/use-package/use-package-bind-key.el b/lisp/use-package/use-package-bind-key.el
index 19dc7e71f7a..9d361be32ee 100644
--- a/lisp/use-package/use-package-bind-key.el
+++ b/lisp/use-package/use-package-bind-key.el
@@ -29,7 +29,7 @@
 ;;
 ;; These keywords are made available by default by requiring `use-package'.
 ;;
-;; See the `use-package' info manual for more information.
+;; See Info node `(use-package)' for more information.
 
 ;;; Code:
 
diff --git a/lisp/use-package/use-package-core.el b/lisp/use-package/use-package-core.el
index 630ee83601c..b9764dd4d54 100644
--- a/lisp/use-package/use-package-core.el
+++ b/lisp/use-package/use-package-core.el
@@ -25,7 +25,7 @@
 ;; This file contains the core implementation of the `use-package'
 ;; macro.
 ;;
-;; See the `use-package' info manual for more information.
+;; See Info node `(use-package)' for more information.
 
 ;;; Code:
 
diff --git a/lisp/use-package/use-package-delight.el b/lisp/use-package/use-package-delight.el
index c3796da3217..bad2b3cf241 100644
--- a/lisp/use-package/use-package-delight.el
+++ b/lisp/use-package/use-package-delight.el
@@ -26,7 +26,7 @@
 ;; by default by requiring `use-package'.  Using it requires the
 ;; `delight' package to be installed (available on GNU ELPA).
 ;;
-;; See the `use-package' info manual for more information.
+;; See Info node `(use-package)' for more information.
 
 ;;; Code:
 
diff --git a/lisp/use-package/use-package-diminish.el b/lisp/use-package/use-package-diminish.el
index 20efa498cd9..3579670c8b7 100644
--- a/lisp/use-package/use-package-diminish.el
+++ b/lisp/use-package/use-package-diminish.el
@@ -26,7 +26,7 @@
 ;; by default by requiring `use-package'.  Using it requires the
 ;; `diminish' package to be installed (available on GNU ELPA).
 ;;
-;; See the `use-package' info manual for more information.
+;; See Info node `(use-package)' for more information.
 
 ;;; Code:
 
diff --git a/lisp/use-package/use-package-ensure-system-package.el b/lisp/use-package/use-package-ensure-system-package.el
index 05f6992f995..4fb3309387c 100644
--- a/lisp/use-package/use-package-ensure-system-package.el
+++ b/lisp/use-package/use-package-ensure-system-package.el
@@ -29,7 +29,7 @@
 ;; requires the `system-packages' package to be installed (available
 ;; on GNU ELPA).
 ;;
-;; See the `use-package' info manual for more information.
+;; See Info node `(use-package)' for more information.
 
 ;;; Code:
 
diff --git a/lisp/use-package/use-package-ensure.el b/lisp/use-package/use-package-ensure.el
index 6e698218c7c..24263fee25e 100644
--- a/lisp/use-package/use-package-ensure.el
+++ b/lisp/use-package/use-package-ensure.el
@@ -25,7 +25,7 @@
 ;; Provides support for the :ensure and :pin keywords, which are made
 ;; available by default by requiring `use-package'.
 ;;
-;; See the `use-package' info manual for more information.
+;; See Info node `(use-package)' for more information.
 
 ;;; Code:
 
diff --git a/lisp/use-package/use-package-jump.el b/lisp/use-package/use-package-jump.el
index f82d1629281..323a11bfa88 100644
--- a/lisp/use-package/use-package-jump.el
+++ b/lisp/use-package/use-package-jump.el
@@ -27,7 +27,7 @@
 ;; initialization.  If it was autoloaded, it will not work.
 ;; Improvements are needed.
 ;;
-;; See the `use-package' info manual for more information.
+;; See Info node `(use-package)' for more information.
 
 ;;; Code:
 
diff --git a/lisp/use-package/use-package-lint.el b/lisp/use-package/use-package-lint.el
index 8494440474c..9a4de70becc 100644
--- a/lisp/use-package/use-package-lint.el
+++ b/lisp/use-package/use-package-lint.el
@@ -24,7 +24,7 @@
 
 ;; Provides the command `M-x use-package-lint'.
 ;;
-;; See the `use-package' info manual for more information.
+;; See Info node `(use-package)' for more information.
 
 ;;; Code:
 
diff --git a/lisp/use-package/use-package.el b/lisp/use-package/use-package.el
index 439ca814f0a..4a0168bbf2a 100644
--- a/lisp/use-package/use-package.el
+++ b/lisp/use-package/use-package.el
@@ -37,7 +37,7 @@
 ;; difficult to manage.  Yet with this utility my total load time is
 ;; just under 1 second, with no loss of functionality!
 ;;
-;; See the `use-package' info manual for more information.
+;; See Info node `(use-package)' for more information.
 
 ;;; Code:
 
diff --git a/test/lisp/emacs-lisp/ert-tests.el b/test/lisp/emacs-lisp/ert-tests.el
index d138240b0f8..45b4e7bd002 100644
--- a/test/lisp/emacs-lisp/ert-tests.el
+++ b/test/lisp/emacs-lisp/ert-tests.el
@@ -22,7 +22,7 @@
 ;;; Commentary:
 
 ;; This file is part of ERT, the Emacs Lisp Regression Testing tool.
-;; See ert.el or the texinfo manual for more details.
+;; See ert.el or the Info node `(ert)' for more details.
 
 ;;; Code:
 
diff --git a/test/lisp/emacs-lisp/ert-x-tests.el b/test/lisp/emacs-lisp/ert-x-tests.el
index 7b7abf1ba7e..c6e67828878 100644
--- a/test/lisp/emacs-lisp/ert-x-tests.el
+++ b/test/lisp/emacs-lisp/ert-x-tests.el
@@ -23,7 +23,7 @@
 ;;; Commentary:
 
 ;; This file is part of ERT, the Emacs Lisp Regression Testing tool.
-;; See ert.el or the texinfo manual for more details.
+;; See ert.el or the Info node `(ert)' for more details.
 
 ;;; Code:
 
-- 
2.49.0


--=-=-=--




Acknowledgement sent to Morgan Smith <Morgan.J.Smith@HIDDEN>:
New bug report received and forwarded. Copy sent to ohler@HIDDEN, ohler@HIDDEN, johnw@HIDDEN, johnw@HIDDEN, johnw@HIDDEN, johnw@HIDDEN, justin@HIDDEN, johnw@HIDDEN, johnw@HIDDEN, johnw@HIDDEN, johnw@HIDDEN, bug-cc-mode@HIDDEN, umerin@HIDDEN, larsi@HIDDEN, tromey@HIDDEN, dan@HIDDEN, ohler@HIDDEN, rfrancoise@HIDDEN, stephen.berman@HIDDEN, eli@HIDDEN, johnw@HIDDEN, tzz@HIDDEN, terra@HIDDEN, jbw@HIDDEN, occitan@HIDDEN, bug-gnu-emacs@HIDDEN. Full text available.
Report forwarded to ohler@HIDDEN, ohler@HIDDEN, johnw@HIDDEN, johnw@HIDDEN, johnw@HIDDEN, johnw@HIDDEN, justin@HIDDEN, johnw@HIDDEN, johnw@HIDDEN, johnw@HIDDEN, johnw@HIDDEN, bug-cc-mode@HIDDEN, umerin@HIDDEN, larsi@HIDDEN, tromey@HIDDEN, dan@HIDDEN, ohler@HIDDEN, rfrancoise@HIDDEN, stephen.berman@HIDDEN, eli@HIDDEN, johnw@HIDDEN, tzz@HIDDEN, terra@HIDDEN, jbw@HIDDEN, occitan@HIDDEN, bug-gnu-emacs@HIDDEN:
bug#77969; Package emacs. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Sat, 26 Apr 2025 15:00:01 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.