[dbdoclet] Translation of @link

The translation of {@link} is bothering me a bit.
This JavaDoc:

 * <p>Use {@link #newInstance()} to create a <code>DatatypeFactory</code>.</p>

Becomes this DocBook:

<para>
Use <literal><link linkend="SOMEID"><xref linkend="SOMEID"/> </link></literal>
to create a <literal>DatatypeFactory</literal>.
</para>

There are a few problems here.

1. The use of xref inside link isn't valid.
2. Adding the extra space inside the link makes it part of the link.
3. Adding the newline after the para start tag introduces spurious whitespace.

I'd prefer:

<para>Use <literal><xref linkend="SOMEID"/></literal>
to create a <literal>DatatypeFactory</literal>.
</para>

I may go off and see if I can fix that locally. I'll send a patch if I
succeed.

                                        Be seeing you,
                                          norm

-- 
Norman Walsh <ndw@xxxxxxxxxx> | Upon the whole I dislike mankind:
http://nwalsh.com/            | whatever people on the other side of
                              | the question may advance, they cannot
                              | deny that they are always surprised at
                              | hearing of a good action and never of a
                              | bad one.-- Keats

-- Attached file included as plaintext by Ecartis --

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.0 (GNU/Linux)

iD8DBQBCNzvxOyltUcwYWjsRArWpAJsHzcGw96takY59/TGstYxO2Ib3+QCgq7Ww
JkeGwg9vbz3/D7UXn+Ev5f8=
=IAbT
-----END PGP SIGNATURE-----

Other related posts: