Re: GRUB Manual Broken Link

[Andrey Borzenkov <arvidjaar@gmail.com>]

В 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