Re: GRUB Manual Broken Link

[Bruce Dubbs <bruce.dubbs@gmail.com>]

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