grub-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: GRUB Manual Broken Link


From: Bruce Dubbs
Subject: Re: GRUB Manual Broken Link
Date: Fri, 15 Nov 2013 12:47:53 -0600
User-agent: Mozilla/5.0 (X11; Linux i686; rv:13.0) Gecko/20120628 Firefox/13.0.1 SeaMonkey/2.10.1

Andrey Borzenkov wrote:
В Fri, 15 Nov 2013 10:04:15 -0600
Bruce Dubbs <address@hidden> пишет:

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 <address@hidden>
To: address@hidden
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" <address@hidden> пишет:

address@hidden - 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











reply via email to

[Prev in Thread] Current Thread [Next in Thread]