Subject: Behaviour of ENTITY(ies) in the NetBSD guide
To: None <netbsd-docs@NetBSD.org>
From: Rui Paulo <rpaulo@NetBSD.org>
List: netbsd-docs
Date: 06/13/2005 00:44:22
Hi.
This is a minor problem, but everyone that reads the NetBSD guide table
of contents may notice it. For the problem I'm going to describe, please
see http://www.netbsd.org/guide/en/index.html and go to section 27.7.4.
You should notice that the usage of man-refs entities doesn't work very
well when rendering the table of contents because it adds two HREFs:
<a href="chap-build.html#chap-build-make-variables">27.7.4.
<a href="http://netbsd.gw.com/cgi-bin/man-cgi?make+1+NetBSD-current">
<span class="citerefentry">
<span class="refentrytitle">make</span>(1)</span>
</a> variables used during build</a>
This won't ever pass W3 tests. ;)
The same may be visible in:
http://www.netbsd.org/guide/en/chap-build.html
And any other document that in the future will have a man-ref in the
<title> section will have the problem (PAM docs weren't affected because
they used <sect3> and that doesn't get rendered on the TOC).
Any ideas on how to strip man page HREFs only from the TOC ?
Regards,
--
Rui Paulo