Re: HTML output cross-reference link bug

[Simon Josefsson]

address@hidden (Karl Berry) writes:

> Hi Simon,
>
> I'm not entirely sure offhand what's happening, but as for:

Hi Karl.  I ran into this problem again today, and would like to help
fix it.  Again, the problem is that makeinfo generates broken references
internally in documents, e.g. on:

http://www.gnu.org/software/gnutls/manual/html_node/The-TLS-Handshake-Protocol.html

Click on the first link in the text, i.e., gnutls_priority_init.

The links goes to:

http://www.gnu.org/software/gnutls/manual/html_node/Core-functions.html#gnutls%5fpriority%5finit

However, there is no A NAME for that.  Looking at the HTML code on the
second page, it looks like this:

<p><a name="gnutls_005fpriority_005finit"></a>

Note that this is in the same manual!  There is no cross-reference to
another info manual.

>     Ideas on how to solve this?
>
> 1) Does texi2html do the right thing?

Yes it does.  The cross-reference 'a name' is the same as makeinfo
generates, but texi2html generates the proper 'a href' link.

However, gendocs.sh in gnulib uses makeinfo --html by default, and I'd
prefer to use a GNU tool if there is one available.  So I would prefer
to not use texi2html.

> 2) Post-process the output with a script.  (I do this in other cases for
>    various manuals.)
>
> Either of those will be a more practical fix than worrying about
> makeinfo.

I don't follow this -- this looks like a clear bug to me, the makeinfo
output is not self-consistent.

/Simon