GRUB Manual Broken Link

GRUB Manual Broken Link

[Bruce Dubbs]

I was notified by the GNU webmaster that he is getting complaints about 
the manual at http://www.gnu.org/software/grub/manual/grub.html having a 
broken link:

http://www.gnu.org/software/grub/manual/multiboot.html#Top

It should be

http://www.gnu.org/software/grub/manual/multiboot/multiboot.html

Although I do update the web information pages, I don't have a way to 
update the main GRUB manual.  I'm not sure, but I think Colin updated 
the current manual (which is still listed as Manual 2.00~rc1).

Can we get this manual updated?

   -- Bruce

Re: GRUB Manual Broken Link

[Andrey Borzenkov]

В Fri, 15 Nov 2013 10:04:15 -0600
Bruce Dubbs <bruce.dubbs@gmail.com> пишет:

> I was notified by the GNU webmaster that he is getting complaints about 
> the manual at http://www.gnu.org/software/grub/manual/grub.html having a 
> broken link:
> 
> http://www.gnu.org/software/grub/manual/multiboot.html#Top
> 
> It should be
> 
> http://www.gnu.org/software/grub/manual/multiboot/multiboot.html
> 
> Although I do update the web information pages, I don't have a way to 
> update the main GRUB manual.  I'm not sure, but I think Colin updated 
> the current manual (which is still listed as Manual 2.00~rc1).
> 
> Can we get this manual updated?
> 


The bug is not in manual. Link is generated by texinfo when converting
grub.texi to HTML. It just need to be regenerated with correct texinfo
version that knows how to translate multiboot link. See message below:

From: Andrey Borzenkov <arvidjaar@gmail.com>
To: webmasters-comment@gnu.org
Subject: Re: [gnu.org #832039] 404
Date: Fri, 31 May 2013 20:13:59 +0400
X-Mailer: Claws Mail 3.9.0 (GTK+ 2.24.18; x86_64-suse-linux-gnu)

В Wed, 29 May 2013 11:43:14 -0400
"Ineiev via RT" <webmasters-comment@gnu.org> пишет:

> > [arvidjaar@gmail.com - Wed May 29 01:28:37 2013]:
> > I'm not sure how. texinfo external references supports only base file
> > name and assume that everything is located on the same level.  
> 
> Recent texinfo versions (5.0 and later) come with a database of
> root URLs for different manuals; I'm not sure the manual you need
> is included, but I think you could try (or at least ask on
> bug-texinfo).
>   

Which just confirms - it needs fixing elsewhere, not in grub2 sources :)

Assuming current web layout, it would be this patch below and grub
manual must be regenerated by texinfo 5.x that includes this patch. I'm
not really feel to be competent enough to submit this patch myself - I
simply do not know how web location is decided.

Index: util/htmlxref.cnf
===================================================================
--- util/htmlxref.cnf	(revision 5259)
+++ util/htmlxref.cnf	(working copy)
@@ -459,6 +459,9 @@
 
 mtools		mono	${GS}/mtools/manual/mtools.html
 
+multiboot	mono	${GS}/grub/manual/multiboot/multiboot.html
+multiboot	node	${GS}/grub/manual/multiboot/html_node/
+
 myserver	node	http://www.myserverproject.net/documentation/
 
 nano		mono	http://www.nano-editor.org/dist/latest/nano.html

Re: GRUB Manual Broken Link

[Bruce Dubbs]

Andrey Borzenkov wrote:
> В Fri, 15 Nov 2013 10:04:15 -0600
> Bruce Dubbs <bruce.dubbs@gmail.com> пишет:
>
>> I was notified by the GNU webmaster that he is getting complaints about
>> the manual at http://www.gnu.org/software/grub/manual/grub.html having a
>> broken link:
>>
>> http://www.gnu.org/software/grub/manual/multiboot.html#Top
>>
>> It should be
>>
>> http://www.gnu.org/software/grub/manual/multiboot/multiboot.html
>>
>> Although I do update the web information pages, I don't have a way to
>> update the main GRUB manual.  I'm not sure, but I think Colin updated
>> the current manual (which is still listed as Manual 2.00~rc1).
>>
>> Can we get this manual updated?
>>
>
>
> The bug is not in manual. Link is generated by texinfo when converting
> grub.texi to HTML. It just need to be regenerated with correct texinfo
> version that knows how to translate multiboot link. See message below:
>
> From: Andrey Borzenkov <arvidjaar@gmail.com>
> To: webmasters-comment@gnu.org
> Subject: Re: [gnu.org #832039] 404
> Date: Fri, 31 May 2013 20:13:59 +0400
> X-Mailer: Claws Mail 3.9.0 (GTK+ 2.24.18; x86_64-suse-linux-gnu)
>
> В Wed, 29 May 2013 11:43:14 -0400
> "Ineiev via RT" <webmasters-comment@gnu.org> пишет:
>
>>> [arvidjaar@gmail.com - Wed May 29 01:28:37 2013]:
>>> I'm not sure how. texinfo external references supports only base file
>>> name and assume that everything is located on the same level.
>>
>> Recent texinfo versions (5.0 and later) come with a database of
>> root URLs for different manuals; I'm not sure the manual you need
>> is included, but I think you could try (or at least ask on
>> bug-texinfo).
>>
>
> Which just confirms - it needs fixing elsewhere, not in grub2 sources :)
>
> Assuming current web layout, it would be this patch below and grub
> manual must be regenerated by texinfo 5.x that includes this patch. I'm
> not really feel to be competent enough to submit this patch myself - I
> simply do not know how web location is decided.
>
> Index: util/htmlxref.cnf
> ===================================================================
> --- util/htmlxref.cnf	(revision 5259)
> +++ util/htmlxref.cnf	(working copy)
> @@ -459,6 +459,9 @@
>
>   mtools		mono	${GS}/mtools/manual/mtools.html
>
> +multiboot	mono	${GS}/grub/manual/multiboot/multiboot.html
> +multiboot	node	${GS}/grub/manual/multiboot/html_node/
> +
>   myserver	node	http://www.myserverproject.net/documentation/
>
>   nano		mono	http://www.nano-editor.org/dist/latest/nano.html

OK. I do have texinfo 5.1 and I see now where that manual is located. 
on the web site I'll see if I can get it fixed.

   -- Bruce

Re: GRUB Manual Broken Link

[Bruce Dubbs]

Andrey Borzenkov wrote:
> В Fri, 15 Nov 2013 10:04:15 -0600
> Bruce Dubbs <bruce.dubbs@gmail.com> пишет:
>
>> I was notified by the GNU webmaster that he is getting complaints about
>> the manual at http://www.gnu.org/software/grub/manual/grub.html having a
>> broken link:
>>
>> http://www.gnu.org/software/grub/manual/multiboot.html#Top
>>
>> It should be
>>
>> http://www.gnu.org/software/grub/manual/multiboot/multiboot.html
>>
>> Although I do update the web information pages, I don't have a way to
>> update the main GRUB manual.  I'm not sure, but I think Colin updated
>> the current manual (which is still listed as Manual 2.00~rc1).
>>
>> Can we get this manual updated?
>>
>
>
> The bug is not in manual. Link is generated by texinfo when converting
> grub.texi to HTML. It just need to be regenerated with correct texinfo
> version that knows how to translate multiboot link. See message below:
>
> From: Andrey Borzenkov <arvidjaar@gmail.com>
> To: webmasters-comment@gnu.org
> Subject: Re: [gnu.org #832039] 404
> Date: Fri, 31 May 2013 20:13:59 +0400
> X-Mailer: Claws Mail 3.9.0 (GTK+ 2.24.18; x86_64-suse-linux-gnu)
>
> В Wed, 29 May 2013 11:43:14 -0400
> "Ineiev via RT" <webmasters-comment@gnu.org> пишет:
>
>>> [arvidjaar@gmail.com - Wed May 29 01:28:37 2013]:
>>> I'm not sure how. texinfo external references supports only base file
>>> name and assume that everything is located on the same level.
>>
>> Recent texinfo versions (5.0 and later) come with a database of
>> root URLs for different manuals; I'm not sure the manual you need
>> is included, but I think you could try (or at least ask on
>> bug-texinfo).
>>
>
> Which just confirms - it needs fixing elsewhere, not in grub2 sources :)
>
> Assuming current web layout, it would be this patch below and grub
> manual must be regenerated by texinfo 5.x that includes this patch. I'm
> not really feel to be competent enough to submit this patch myself - I
> simply do not know how web location is decided.
>
> Index: util/htmlxref.cnf
> ===================================================================
> --- util/htmlxref.cnf	(revision 5259)
> +++ util/htmlxref.cnf	(working copy)
> @@ -459,6 +459,9 @@
>
>   mtools		mono	${GS}/mtools/manual/mtools.html
>
> +multiboot	mono	${GS}/grub/manual/multiboot/multiboot.html
> +multiboot	node	${GS}/grub/manual/multiboot/html_node/
> +
>   myserver	node	http://www.myserverproject.net/documentation/
>
>   nano		mono	http://www.nano-editor.org/dist/latest/nano.html


For now I made a hack to change the href entry in the html directly but 
I didn't regenerate all the docs.

The latest version of texinfo is 5.2 and that does not have the patch 
above, but the file says the latest is at 
http://ftpmirror.gnu.org/texinfo/htmlxref.cnf. That file *does* have the 
patch.

Rebuilding texinfo with the latest htmlxref.cnf does fix the problem. 
There are a couple of warnings though.  I'm using the GRUB-2.0.0 release 
version since that's the latest official release and don't know if they 
have been fixed in git or not.

Speaking of official releases, has there been any thought into a new 
stable release of GRUB?  It's been a while since 2.0 was released.

   -- Bruce