Do we care for manpage links in <title> elements?

[Giorgos Keramidas]

Hi everyone,

I just noticed that in all the places where a chapter <title> includes a
&an.xxx.section; entity the rendering in HTML output sucks a bit.  Note
how there are two separate links in the 'Using rc(8) Under FreeBSD'
title in the following screenshot:

    http://people.freebsd.org/~keramida/rc8-title-link.png

The <title> itself becomes an <a>...</a> element, but when a &man.xxx.y;
macro is included in the title, the final rendering becomes:

    <a link="foo">
      some text
      <a href="manpage link">manpage name</a>
      maybe more text
    </a>

The embedded <a> terminates the first link, and the first </a>
terminates the second link, so we end up with the broken rendering
pf the screenshot and two _different_ links in the same sentence.

Is there any way to automatically detect this and translate the
embedded <a> element that &man.xxx.y; generates to something harmless,
like <span>?

If not, do we really care for &man.xxx.y; in titles, or should we just
replace them with plain text?

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 198 bytes
Desc: Digital signature
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20130226/84f100e3/attachment.sig>