docs/75636: [PATCH] Update the Porter's handbook - Java section
Mark Linimon
linimon at lonesome.com
Thu Dec 30 20:54:55 UTC 2004
On Wed, 29 Dec 2004, Herve Quiroz wrote:
> + <para>The related entries are defined in both
> + <makevar>PLIST_SUB</makevar> (documented
> + <link linkend="porting-plist">here</link>) and
> + <makevar>SUB_LIST</makevar>.</para>
(Sorry, I'm barely able to keep up with email ATM due to outside
constraints, so I'm not sure this has already been addressed.)
I keep trying to write the links this way and get gently reminded that
there's a better idiom, one that gets rid of this dangling "here" word.
Yeah, ok, here's a cut-and-paste from Simon:
A link which says "here" is generally a bad idea, they will not really
make sense in a printed version..
I would suggest:
in <xref linkend="dads-noinstall">.</para>
e.g. the name associated with that reference will be picked up and used.
It will also be properly highlighted in the web-based version.
(You have 3 instances of this in the above IIRC.)
Otherwise I think it looks good.
mcl
More information about the freebsd-doc
mailing list