From owner-freebsd-doc@FreeBSD.ORG Thu Dec 30 20:54:55 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id BF36C16A4CE; Thu, 30 Dec 2004 20:54:55 +0000 (GMT) Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9372943D2F; Thu, 30 Dec 2004 20:54:55 +0000 (GMT) (envelope-from linimon@lonesome.com) Received: by mail.soaustin.net (Postfix, from userid 502) id 31F23148F2; Thu, 30 Dec 2004 14:54:55 -0600 (CST) Date: Thu, 30 Dec 2004 14:54:55 -0600 (CST) From: Mark Linimon X-X-Sender: linimon@pancho To: Herve Quiroz In-Reply-To: <200412292212.iBTMCQOw087198@arabica.esil.univ-mrs.fr> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII cc: freebsd-doc@FreeBSD.org cc: FreeBSD-gnats-submit@FreeBSD.org Subject: Re: docs/75636: [PATCH] Update the Porter's handbook - Java section X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 30 Dec 2004 20:54:55 -0000 On Wed, 29 Dec 2004, Herve Quiroz wrote: > + The related entries are defined in both > + PLIST_SUB (documented > + here) and > + SUB_LIST. (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 . 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