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