Date: Thu, 30 Dec 2004 14:54:55 -0600 (CST) From: Mark Linimon <linimon@lonesome.com> To: Herve Quiroz <hq@FreeBSD.org> Cc: FreeBSD-gnats-submit@FreeBSD.org Subject: Re: docs/75636: [PATCH] Update the Porter's handbook - Java section Message-ID: <Pine.LNX.4.44.0412301449430.24022-100000@pancho> In-Reply-To: <200412292212.iBTMCQOw087198@arabica.esil.univ-mrs.fr>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.LNX.4.44.0412301449430.24022-100000>