bug#66703: Broken link to Debbugs User Guide

bug#66703: Broken link to Debbugs User Guide

[Greg Hogan]

The page https://guix.gnu.org/devel/manual/en/html_node/Debbugs-User-Interfaces.html
has a broken link "Debbugs User Guide" to the page
https://guix.gnu.org/devel/manual/en/debbugs-ug/index.html#Top.

bug#66703: Broken link to Debbugs User Guide

[Maxim Cournoyer]

Hi Greg,

Greg Hogan <code@greghogan.com> writes:

> The page https://guix.gnu.org/devel/manual/en/html_node/Debbugs-User-Interfaces.html
> has a broken link "Debbugs User Guide" to the page
> https://guix.gnu.org/devel/manual/en/debbugs-ug/index.html#Top.

There doesn't seem to be an online HTML version of this manual, so the
bug doesn't appear actionable.

It works when using 'info', provided the 'emacs-debbugs' package is
installed.

-- 
Thanks,
Maxim

bug#66703: Broken link to Debbugs User Guide

[John Kehayias via Bug reports for GNU Guix]

merge 66703 58415
thanks

On Mon, Oct 23, 2023 at 10:39 PM, Maxim Cournoyer wrote:

> Hi Greg,
>
> Greg Hogan <code@greghogan.com> writes:
>
>> The page https://guix.gnu.org/devel/manual/en/html_node/Debbugs-User-Interfaces.html
>> has a broken link "Debbugs User Guide" to the page
>> https://guix.gnu.org/devel/manual/en/debbugs-ug/index.html#Top.
>
> There doesn't seem to be an online HTML version of this manual, so the
> bug doesn't appear actionable.
>
> It works when using 'info', provided the 'emacs-debbugs' package is
> installed.

I noticed the broken html link before but never tracked down the correct
link to patch it. But just now a search gave me
<https://elpa.gnu.org/packages/doc/debbugs-ug.html> which looks helpful?

John

bug#66703: Broken link to Debbugs User Guide

[Maxim Cournoyer]

Hi John,

John Kehayias <john.kehayias@protonmail.com> writes:

> merge 66703 58415
> thanks
>
> On Mon, Oct 23, 2023 at 10:39 PM, Maxim Cournoyer wrote:
>
>> Hi Greg,
>>
>> Greg Hogan <code@greghogan.com> writes:
>>
>>> The page https://guix.gnu.org/devel/manual/en/html_node/Debbugs-User-Interfaces.html
>>> has a broken link "Debbugs User Guide" to the page
>>> https://guix.gnu.org/devel/manual/en/debbugs-ug/index.html#Top.
>>
>> There doesn't seem to be an online HTML version of this manual, so the
>> bug doesn't appear actionable.
>>
>> It works when using 'info', provided the 'emacs-debbugs' package is
>> installed.
>
> I noticed the broken html link before but never tracked down the correct
> link to patch it. But just now a search gave me
> <https://elpa.gnu.org/packages/doc/debbugs-ug.html> which looks helpful?

This doesn't look like an 'official' doc to me, but if we'd like to use
it, we'd have to tune the doc/htmlxref.cnf file content.  Would you like
to give it a try?

-- 
Thanks,
Maxim

bug#66703: [PATCH] doc: Remove 'Debbugs User Guide' broken links.

[Vincent Legoll]

Fixes <https://issues.guix.gnu.org/66703>.

* doc/contributing.texi: Remove (x)refs and text about the Debbugs User
Guide.
---

Consensus has not been reached for using the ELPA page, so in the
mean time, remove broken links.

 doc/contributing.texi | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/doc/contributing.texi b/doc/contributing.texi
index 938c8bfdb1..8b0b49e500 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -678,8 +678,7 @@ configuration file:
 @end lisp
 
 For more information, refer to @ref{Bug Reference,,, emacs, The GNU
-Emacs Manual} and @ref{Minor Mode,,, debbugs-ug, The Debbugs User
-Guide}.
+Emacs Manual}.
 
 @node Alternative Setups
 @section Alternative Setups
@@ -2552,9 +2551,6 @@ Bugs within Emacs}).
 To search for bugs, @samp{@kbd{M-x} debbugs-gnu-guix-search} can be
 used.
 
-@xref{Top,,, debbugs-ug, Debbugs User Guide}, for more information on
-this nifty tool!
-
 @node Debbugs Usertags
 @subsection Debbugs Usertags
 
-- 
2.45.2

bug#66703: Broken link to Debbugs User Guide

[John Kehayias via Bug reports for GNU Guix]

Hi Maxim,

Yes, reviving an old one as I try to close some (of my too many) browser
tabs.

On Tue, Oct 31, 2023 at 11:19 AM, Maxim Cournoyer wrote:

> Hi John,
>
> John Kehayias <john.kehayias@protonmail.com> writes:
>
>> merge 66703 58415
>> thanks
>>
>> On Mon, Oct 23, 2023 at 10:39 PM, Maxim Cournoyer wrote:
>>
>>> Hi Greg,
>>>
>>> Greg Hogan <code@greghogan.com> writes:
>>>
>>>> The page <https://guix.gnu.org/devel/manual/en/html_node/Debbugs-User-Interfaces.html>
>>>> has a broken link "Debbugs User Guide" to the page
>>>> <https://guix.gnu.org/devel/manual/en/debbugs-ug/index.html#Top>.
>>>
>>> There doesn't seem to be an online HTML version of this manual, so the
>>> bug doesn't appear actionable.
>>>
>>> It works when using 'info', provided the 'emacs-debbugs' package is
>>> installed.
>>
>> I noticed the broken html link before but never tracked down the correct
>> link to patch it. But just now a search gave me
>> <https://elpa.gnu.org/packages/doc/debbugs-ug.html> which looks helpful?
>
> This doesn't look like an 'official' doc to me, but if we'd like to
> use

What do you mean not "official" exactly? This is listed as one of 2
links for the manual from the homepage of the debbugs package
<https://elpa.gnu.org/packages/debbugs.html> (one for the
package/library I guess, the second for the "user guide").

> it, we'd have to tune the doc/htmlxref.cnf file content.  Would you like
> to give it a try?

I have to admit not knowing about that file until you had mentioned it
and not sure where to start. Any quick pointers or examples of this? Or
do I just add a debbugs entry under emacs where it is set to that link?

(There was a patch from Vincent Legoll that was lost as it was only sent
to the bug number, which goes nowhere:
<https://issues.guix.gnu.org/66703#5> This just removes the reference
though. Adding to the CC here.)

For future reference, related issues:
<https://issues.guix.gnu.org/29593> and
<https://issues.guix.gnu.org/54197>.

Thanks!
John

bug#66703: Broken link to Debbugs User Guide

[Vincent Legoll]

[-- Attachment #1: Type: text/plain, Size: 700 bytes --]

Hello,

On Mon, Dec 9, 2024 at 2:12 AM John Kehayias <john.kehayias@protonmail.com>
wrote:

> (There was a patch from Vincent Legoll that was lost as it was only sent
> to the bug number, which goes nowhere:
>

Yes, I did not use the tool (mumi CLI ?) to reply, so I just sent to the
bug number
hoping it would reach the interested people. I think an easy CC list that
you can
copy/paste would be a nice UI feature for mumi web.


> <https://issues.guix.gnu.org/66703#5> This just removes the reference
> though. Adding to the CC here.)
>

Yep, not knowing what was wanted/useful I just went for the simple Occam
fix.

Thanks for reviving the issue !

-- 
Vincent Legoll

[-- Attachment #2: Type: text/html, Size: 1463 bytes --]