WARNING: This server is unstable and will be retired in the next days. If you want to keep this forum available, please request immediately a migration on the Nabble Support forum. Forums that don't receive any migration request will be deleted forever.

Broken links in online documentation

View: New views
2 Messages — Rating Filter:   Alert me  

Broken links in online documentation

by Paul Goins :: Rate this Message:

| View Threaded | Show Only this Message

Hello,

I was checking the online docs for GNU Hello
(http://www.gnu.org/software/hello/manual/hello.html) and noticed that a
large number of links are broken.  Specifically, I'm referring to links
to manuals for other tools (Automake, Autoconf, etc.)

Just looking at the manual/.symlinks file, it looks like it might be
missing several needed links?  I tried to update what I could, and a
patch with my changes is attached.

As for Automake and Autoconf specifically, symlinks look like they're
being made, but the links are using a capital A for the first letter
(Automake.html and Autoconf.html, instead of automake.html and
autoconf.html).  I wasn't sure how to change those properly in the CVS
source code, so the patch does not include changes for these links.

Hope this helps!

-
Paul Goins

diff -c a/.symlinks b/.symlinks
*** a/.symlinks 2009-01-28 00:47:08.000000000 +0900
--- b/.symlinks 2009-01-28 00:47:01.000000000 +0900
***************
*** 9,11 ****
--- 9,31 ----
  #
  ../../gnulib/manual/html_node gnulib
  ../../gnulib/manual/gnulib.html gnulib.html
+ #
+ ../../../prep/standards/html_node standards
+ ../../../prep/standards/standards.html standards.html
+ #
+ ../../../prep/maintain/html_node maintain
+ ../../../prep/maintain/maintain.html maintain.html
+ #
+ ../../gettext/manual/html_node gettext
+ ../../gettext/manual/gettext.html gettext.html
+ #
+ ../../libc/manual/html_node libc
+ ../../libc/manual/html_mono/libc.html libc.html
+ #
+ ../../help2man/index.html help2man.html
+ #
+ ../../diffutils/manual/html_node diff
+ ../../diffutils/manual/html_mono/diff.html diff.html
+ #
+ ../../emacs/manual/html_node emacs
+ ../../emacs/manual/emacs.html emacs.html

Re: Broken links in online documentation

by Karl Berry :: Rate this Message:

| View Threaded | Show Only this Message

Hi Paul,

    links to manuals for other tools

Yeah, we've never quite brought the cross-manual link stuff to fruition.
Maybe this year ...

    Just looking at the manual/.symlinks file, it looks like it might be
    missing several needed links?  I tried to update what I could, and a
    patch with my changes is attached.

Thank you very very much!

    the links are using a capital A for the first letter

I probably mistyped the @xref in hello.texi.  Will inspect.

Thanks again,
Karl