From owner-cvs-doc@FreeBSD.ORG  Tue Apr  8 13:06:25 2003
Return-Path: <owner-cvs-doc@FreeBSD.ORG>
Delivered-To: cvs-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id 2A3AE37B412; Tue,  8 Apr 2003 13:06:25 -0700 (PDT)
Received: from perrin.int.nxad.com (internal.ext.nxad.com [69.1.70.251])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 6877643F75; Tue,  8 Apr 2003 13:06:24 -0700 (PDT)
	(envelope-from sean@perrin.int.nxad.com)
Received: by perrin.int.nxad.com (Postfix, from userid 1001)
	id 2EF3C21062; Tue,  8 Apr 2003 13:06:12 -0700 (PDT)
Date: Tue, 8 Apr 2003 13:06:12 -0700
From: Sean Chittenden <seanc@FreeBSD.org>
To: Ceri Davies <ceri@FreeBSD.org>
Message-ID: <20030408200612.GO79923@perrin.int.nxad.com>
References: <200304072043.h37KhjrK033251@repoman.freebsd.org>
	<20030407204931.GF79923@perrin.int.nxad.com>
	<20030408091656.GA13794@submonkey.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20030408091656.GA13794@submonkey.net>
User-Agent: Mutt/1.4i
X-PGP-Key: finger seanc@FreeBSD.org
X-PGP-Fingerprint: 3849 3760 1AFE 7B17 11A0  83A6 DD99 E31F BC84 B341
X-Web-Homepage: http://sean.chittenden.org/
cc: doc-committers@FreeBSD.org
cc: cvs-doc@FreeBSD.org
Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/handbook/eresources
	chapter.sgml
X-BeenThere: cvs-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: CVS commit messages for the doc and www trees <cvs-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-doc>,
	<mailto:cvs-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/cvs-doc>
List-Post: <mailto:cvs-doc@freebsd.org>
List-Help: <mailto:cvs-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-doc>,
	<mailto:cvs-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 08 Apr 2003 20:06:25 -0000

> > The doc@ team may want to revisit how lists are advertised.  I
> > think it'd be prudent to create another set of entities that are
> > parallel to the a.[listname] entities that are defined as a set of
> > ulinks to the mailman interface:
> > 
> > <!ENTITY a.announce.name "<ulink url='http://lists.freebsd.org/mailman/listinfo/freebsd-announce'>freebsd-announce</ulink>">
> > 
> > If I don't hear any objections, I'll add these entities to
> > doc/en_US.ISO8859-1/share/sgml/mailing-lsits.ent.  Having
> > frequently used/referenced lists and URLs scattered about strikes
> > me as a maintenance headache waiting to happen.
> 
> I say go for it.

Cool, thanks: will do.  Quck question about our doc build process... I
don't have doc building setup on my laptop (on the road) so I can't
test this 1st, but:

<!ENTITY a.mailman.listinfo "http://lists.FreeBSD.org/mailman/listinfo">

<!ENTITY a.advocacy.url "&a.mailman.listinfo;/freebsd-advocacy">
<!ENTITY a.advocacy "<ulink url='&a.advocacy.url;'>FreeBSD advocacy mailing list</ulink>">
<!ENTITY a.advocacy.name "<ulink url='&a.advocacy.url;'>freebsd-advocacy</ulink>">

Is our doc build process be smart enough to handle nested entities
like that?  I forget if I have to do that or %a.advocacy.url; -sc

-- 
Sean Chittenden