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

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 77969 in the body.
You can then email your comments to 77969 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Morgan Smith <Morgan.J.Smith <at> outlook.com>
To: bug-gnu-emacs <at> gnu.org
Subject: [PATCH] Add buttons to manuals in some commentary sections
Date: Mon, 21 Apr 2025 13:54:47 -0400

[Message part 1 (text/plain, inline)]

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.

[0001-Add-buttons-to-manuals-in-some-commentary-sections.patch (text/patch, attachment)]

Message #8 received at 77969 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Morgan Smith <Morgan.J.Smith <at> outlook.com>,
 Stefan Kangas <stefankangas <at> gmail.com>, Andrea Corallo <acorallo <at> gnu.org>,
 Stefan Monnier <monnier <at> iro.umontreal.ca>
Cc: tromey <at> redhat.com, stephen.berman <at> gmx.net, dan <at> haxney.org, eli <at> barzilay.org,
 John Wiegley <johnw <at> gnu.org>, terra <at> gnu.org, jbw <at> bigbird.bu.edu,
 bug-cc-mode <at> gnu.org, occitan <at> esperanto.org, umerin <at> flab.flab.fujitsu.junet,
 rfrancoise <at> gnu.org, larsi <at> gnus.org, 77969 <at> debbugs.gnu.org, tzz <at> lifelogs.com,
 ohler <at> gnu.org
Subject: Re: bug#77969: [PATCH] Add buttons to manuals in some commentary
 sections
Date: Sat, 26 Apr 2025 16:06:37 +0300

> From: Morgan Smith <Morgan.J.Smith <at> outlook.com>
> 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.

Message #11 received at 77969 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 77969 <at> debbugs.gnu.org, Morgan.J.Smith <at> outlook.com, acorallo <at> gnu.org,
 stefankangas <at> gmail.com, monnier <at> iro.umontreal.ca
Subject: Re: bug#77969: [PATCH] Add buttons to manuals in some commentary
 sections
Date: Sat, 10 May 2025 12:34:34 +0300

tags 77969 wontfix
close 77969
thanks

No comments within 2 weeks, so I presume we don't want to install
this, and I'm therefore closing this bug.

> Cc: tromey <at> redhat.com, stephen.berman <at> gmx.net, dan <at> haxney.org, eli <at> barzilay.org,
>  John Wiegley <johnw <at> gnu.org>, terra <at> gnu.org, jbw <at> bigbird.bu.edu,
>  bug-cc-mode <at> gnu.org, occitan <at> esperanto.org, umerin <at> flab.flab.fujitsu.junet,
>  rfrancoise <at> gnu.org, larsi <at> gnus.org, 77969 <at> debbugs.gnu.org, tzz <at> lifelogs.com,
>  ohler <at> gnu.org
> Date: Sat, 26 Apr 2025 16:06:37 +0300
> From: Eli Zaretskii <eliz <at> gnu.org>
> 
> > From: Morgan Smith <Morgan.J.Smith <at> outlook.com>
> > 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.
> 
> 
> 
> 

Previous Next

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