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