GNU bug report logs - #22543
404 in Manualpage

Previous Next

Package: guix;

Reported by: Nils Gillmann <niasterisk <at> grrlz.net>

Date: Wed, 3 Feb 2016 13:42:01 UTC

Severity: normal

Done: ludo <at> gnu.org (Ludovic Courtès)

Bug is archived. No further changes may be made.

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

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

View this report as an mbox folder, status mbox, maintainer mbox


Report forwarded to bug-guix <at> gnu.org:
bug#22543; Package guix. (Wed, 03 Feb 2016 13:42:02 GMT) Full text and rfc822 format available.

Acknowledgement sent to Nils Gillmann <niasterisk <at> grrlz.net>:
New bug report received and forwarded. Copy sent to bug-guix <at> gnu.org. (Wed, 03 Feb 2016 13:42:02 GMT) Full text and rfc822 format available.

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

From: Nils Gillmann <niasterisk <at> grrlz.net>
To: bug-guix <at> gnu.org
Subject: 404 in Manualpage
Date: Wed, 03 Feb 2016 14:41:04 +0100
The manual page
https://www.gnu.org/software/guix/manual/html_node/Requirements.html#Requirements

contains a link to

https://www.gnu.org/software/guix/manual/gnutls-guile/Guile-Preparations.html#Guile-Preparations

which give a 404. I am not familiar with what's supposed to be there, a
quick search for "gnutls-guile/Guile-Preparations.html" in duckduckgo gives me
http://www.gnutls.org/manual/gnutls-guile/Guile-Preparations.html as one
of 2 results.

Should I fix the link to this one and send in a patch?

Thanks,
-- 
ng/ni*
vcard: http://krosos.sdf.org




Information forwarded to bug-guix <at> gnu.org:
bug#22543; Package guix. (Sat, 13 Feb 2016 00:27:02 GMT) Full text and rfc822 format available.

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

From: Leo Famulari <leo <at> famulari.name>
To: Nils Gillmann <niasterisk <at> grrlz.net>
Cc: 22543 <at> debbugs.gnu.org
Subject: Re: bug#22543: 404 in Manualpage
Date: Fri, 12 Feb 2016 19:26:28 -0500
On Wed, Feb 03, 2016 at 02:41:04PM +0100, Nils Gillmann wrote:
> The manual page
> https://www.gnu.org/software/guix/manual/html_node/Requirements.html#Requirements
> 
> contains a link to
> 
> https://www.gnu.org/software/guix/manual/gnutls-guile/Guile-Preparations.html#Guile-Preparations
> 
> which give a 404. I am not familiar with what's supposed to be there, a
> quick search for "gnutls-guile/Guile-Preparations.html" in duckduckgo gives me
> http://www.gnutls.org/manual/gnutls-guile/Guile-Preparations.html as one
> of 2 results.
> 
> Should I fix the link to this one and send in a patch?

Yes, please!




Information forwarded to bug-guix <at> gnu.org:
bug#22543; Package guix. (Sun, 14 Feb 2016 11:16:01 GMT) Full text and rfc822 format available.

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

From: Alex Kost <alezost <at> gmail.com>
To: Nils Gillmann <niasterisk <at> grrlz.net>
Cc: 22543 <at> debbugs.gnu.org
Subject: Re: bug#22543: 404 in Manualpage
Date: Sun, 14 Feb 2016 14:15:13 +0300
Nils Gillmann (2016-02-03 16:41 +0300) wrote:

> The manual page
> https://www.gnu.org/software/guix/manual/html_node/Requirements.html#Requirements
>
> contains a link to
>
> https://www.gnu.org/software/guix/manual/gnutls-guile/Guile-Preparations.html#Guile-Preparations
>
> which give a 404. I am not familiar with what's supposed to be there, a
> quick search for "gnutls-guile/Guile-Preparations.html" in duckduckgo gives me
> http://www.gnutls.org/manual/gnutls-guile/Guile-Preparations.html as one
> of 2 results.
>
> Should I fix the link to this one and send in a patch?

I don't think you can send a patch for this.  According to
<https://www.gnu.org/software/guix/manual/>:

  (This page generated by the gendocs.sh¹ script.)

This "gendocs.sh" uses "texi2html" to convert our texinfo documentation
(see "doc/guix.texi" in the guix git repo) to the html page.  In
"guix.texi" the link you are talking about is a usual link to the
"gnutls-guile" manual.  I didn't look at "texi2html" but I believe by
default it just assumes that all the manuals are placed at
"www.gnu.org/software/<package>/manual/", so for "external" manuals the
generated links are false.  For example, there are also wrong links to
Geiser and Magit-Popup manuals.

So I think it's a general thing for all generated manuals that are
placed on "gnu.org".

¹ http://git.savannah.gnu.org/cgit/gnulib.git/plain/build-aux/gendocs.sh

-- 
Alex




Information forwarded to bug-guix <at> gnu.org:
bug#22543; Package guix. (Tue, 16 Feb 2016 09:57:01 GMT) Full text and rfc822 format available.

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

From: Nils Gillmann <niasterisk <at> grrlz.net>
To: Leo Famulari <leo <at> famulari.name>
Cc: 22543 <at> debbugs.gnu.org, Alex Kost <alezost <at> gmail.com>
Subject: Re: bug#22543: 404 in Manualpage
Date: Tue, 16 Feb 2016 10:56:05 +0100
Leo Famulari <leo <at> famulari.name> writes:

> On Wed, Feb 03, 2016 at 02:41:04PM +0100, Nils Gillmann wrote:
>> The manual page
>> https://www.gnu.org/software/guix/manual/html_node/Requirements.html#Requirements
>> 
>> contains a link to
>> 
>> https://www.gnu.org/software/guix/manual/gnutls-guile/Guile-Preparations.html#Guile-Preparations
>> 
>> which give a 404. I am not familiar with what's supposed to be there, a
>> quick search for "gnutls-guile/Guile-Preparations.html" in duckduckgo gives me
>> http://www.gnutls.org/manual/gnutls-guile/Guile-Preparations.html as one
>> of 2 results.
>> 
>> Should I fix the link to this one and send in a patch?
>
> Yes, please!

So you think I should (and can?) fix it, while alex replies:

>> I don't think you can send a patch for this.  According to
>> <https://www.gnu.org/software/guix/manual/>:
>>
>>  (This page generated by the gendocs.sh¹ script.)

>> This "gendocs.sh" uses "texi2html" to convert our texinfo documentation
>> (see "doc/guix.texi" in the guix git repo) to the html page.  In
>> "guix.texi" the link you are talking about is a usual link to the
>> "gnutls-guile" manual.  I didn't look at "texi2html" but I believe by
>> default it just assumes that all the manuals are placed at
>> "www.gnu.org/software/<package>/manual/", so for "external" manuals the
>> generated links are false.  For example, there are also wrong links to
>> Geiser and Magit-Popup manuals.
>>
>> So I think it's a general thing for all generated manuals that are
>> placed on "gnu.org".
>>
>> ¹ http://git.savannah.gnu.org/cgit/gnulib.git/plain/build-aux/gendocs.sh
>>
>> -- 
>> Alex

Okay, so I guess it's related to #22651 and it#s not fixable the
way I want to (edit the source), or at least what I would want to
do is not optimal and it should be fixed in some other way.

Didn't look into it yet, but should we follow #22651 for the 404s?
-- 
ng




Information forwarded to bug-guix <at> gnu.org:
bug#22543; Package guix. (Wed, 17 Feb 2016 09:30:02 GMT) Full text and rfc822 format available.

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

From: Alex Kost <alezost <at> gmail.com>
To: Nils Gillmann <niasterisk <at> grrlz.net>
Cc: 22543 <at> debbugs.gnu.org, Leo Famulari <leo <at> famulari.name>
Subject: Re: bug#22543: 404 in Manualpage
Date: Wed, 17 Feb 2016 12:29:25 +0300
Nils Gillmann (2016-02-16 12:56 +0300) wrote:

>>> I don't think you can send a patch for this.  According to
>>> <https://www.gnu.org/software/guix/manual/>:
>>>
>>>  (This page generated by the gendocs.sh¹ script.)
>
>>> This "gendocs.sh" uses "texi2html" to convert our texinfo documentation
>>> (see "doc/guix.texi" in the guix git repo) to the html page.  In
>>> "guix.texi" the link you are talking about is a usual link to the
>>> "gnutls-guile" manual.  I didn't look at "texi2html" but I believe by
>>> default it just assumes that all the manuals are placed at
>>> "www.gnu.org/software/<package>/manual/", so for "external" manuals the
>>> generated links are false.  For example, there are also wrong links to
>>> Geiser and Magit-Popup manuals.
>>>
>>> So I think it's a general thing for all generated manuals that are
>>> placed on "gnu.org".
>>>
>>> ¹ http://git.savannah.gnu.org/cgit/gnulib.git/plain/build-aux/gendocs.sh
>
> Okay, so I guess it's related to #22651 and it#s not fixable the
> way I want to (edit the source), or at least what I would want to
> do is not optimal and it should be fixed in some other way.
>
> Didn't look into it yet, but should we follow #22651 for the 404s?

As I see it, these issues about online manual are totally unrelated to
Guix itself.  If there is something to do about it, it should be done in
some other place (where .texi files are converted into html pages for
gnu.org).

-- 
Alex




Reply sent to ludo <at> gnu.org (Ludovic Courtès):
You have taken responsibility. (Sun, 21 Feb 2016 21:31:02 GMT) Full text and rfc822 format available.

Notification sent to Nils Gillmann <niasterisk <at> grrlz.net>:
bug acknowledged by developer. (Sun, 21 Feb 2016 21:31:02 GMT) Full text and rfc822 format available.

Message #22 received at 22543-done <at> debbugs.gnu.org (full text, mbox):

From: ludo <at> gnu.org (Ludovic Courtès)
To: Alex Kost <alezost <at> gmail.com>
Cc: 22543-done <at> debbugs.gnu.org, Nils Gillmann <niasterisk <at> grrlz.net>
Subject: Re: bug#22543: 404 in Manualpage
Date: Sun, 21 Feb 2016 22:30:40 +0100
The broken links stem from missing/incomplete cross-reference info for
‘makeinfo’ in the ‘htmlxref.cnf’ config file (info "(texinfo) HTML Xref
Configuration").

Commit 49e0ca9 adds this file to the repo, taken from Texinfo 6.1 and
modified to fix some of the links (like GnuTLS) and include others
(Shepherd, Guile-Avahi, etc.)

When we update the manual for the next release, everything will be
alright hopefully.  In the meantime, it’s easier to leave things as is,
and hopefully not too much of an issue.

Thanks,
Ludo’.




Information forwarded to bug-guix <at> gnu.org:
bug#22543; Package guix. (Mon, 22 Feb 2016 11:32:01 GMT) Full text and rfc822 format available.

Message #25 received at 22543-done <at> debbugs.gnu.org (full text, mbox):

From: Alex Kost <alezost <at> gmail.com>
To: ludo <at> gnu.org (Ludovic Courtès)
Cc: 22543-done <at> debbugs.gnu.org, Nils Gillmann <niasterisk <at> grrlz.net>
Subject: Re: bug#22543: 404 in Manualpage
Date: Mon, 22 Feb 2016 14:31:21 +0300
Ludovic Courtès (2016-02-22 00:30 +0300) wrote:

> The broken links stem from missing/incomplete cross-reference info for
> ‘makeinfo’ in the ‘htmlxref.cnf’ config file (info "(texinfo) HTML Xref
> Configuration").
>
> Commit 49e0ca9 adds this file to the repo, taken from Texinfo 6.1 and
> modified to fix some of the links (like GnuTLS) and include others
> (Shepherd, Guile-Avahi, etc.)
>
> When we update the manual for the next release, everything will be
> alright hopefully.  In the meantime, it’s easier to leave things as is,
> and hopefully not too much of an issue.

Wow, great!  I didn't think this could be fixed on the Guix side.

-- 
Alex




bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Tue, 22 Mar 2016 11:24:03 GMT) Full text and rfc822 format available.

This bug report was last modified 8 years and 232 days ago.

Previous Next


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