[dbdoclet] Re: Translation of @link

Also the text of the link is empty (or rather, there is just that one =
space). I suppose the text should be automatically replaced by the =
xreflabel of the link end?

This has happened to me with links that point to fields or methods in =
the same class. Can't verify if links outside the class would work OK. =
Using dbdoclet 0.63.0.

--Jere

> -----Original Message-----
> From: dbdoclet-bounce@xxxxxxxxxxxxx
> [mailto:dbdoclet-bounce@xxxxxxxxxxxxx]On Behalf Of ext Norman Walsh
> Sent: Tuesday, March 15, 2005 9:48 PM
> To: Michael Fuchs
> Cc: dbdoclet@xxxxxxxxxxxxx
> Subject: [dbdoclet] Translation of @link
>=20
>=20
> The translation of {@link} is bothering me a bit.
> This JavaDoc:
>=20
>  * <p>Use {@link #newInstance()} to create a=20
> <code>DatatypeFactory</code>.</p>
>=20
> Becomes this DocBook:
>=20
> <para>
> Use <literal><link linkend=3D"SOMEID"><xref linkend=3D"SOMEID"/>=20
> </link></literal>
> to create a <literal>DatatypeFactory</literal>.
> </para>
>=20
> There are a few problems here.
>=20
> 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=20
> spurious whitespace.
>=20
> I'd prefer:
>=20
> <para>Use <literal><xref linkend=3D"SOMEID"/></literal>
> to create a <literal>DatatypeFactory</literal>.
> </para>
>=20
> I may go off and see if I can fix that locally. I'll send a patch if I
> succeed.
>=20
>                                         Be seeing you,
>                                           norm
>=20
> --=20
> 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=20
> never of a
>                               | bad one.-- Keats
>=20
> -- Attached file included as plaintext by Ecartis --
>=20
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.4.0 (GNU/Linux)
>=20
> iD8DBQBCNzvxOyltUcwYWjsRArWpAJsHzcGw96takY59/TGstYxO2Ib3+QCgq7Ww
> JkeGwg9vbz3/D7UXn+Ev5f8=3D
> =3DIAbT
> -----END PGP SIGNATURE-----
>=20
>=20
>=20

Other related posts: