From owner-cvs-doc@FreeBSD.ORG  Tue Apr  8 13:42:06 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 B12ED37B401; Tue,  8 Apr 2003 13:42:06 -0700 (PDT)
Received: from shrike.submonkey.net (pc1-cdif2-5-cust38.cdif.cable.ntl.com
	[81.101.150.38])	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 9AE3F43F93; Tue,  8 Apr 2003 13:42:05 -0700 (PDT)
	(envelope-from setantae@submonkey.net)
Received: from setantae by shrike.submonkey.net with local (Exim 4.12)
	id 192zuu-000CK8-00; Tue, 08 Apr 2003 21:42:04 +0100
Date: Tue, 8 Apr 2003 21:42:04 +0100
From: Ceri Davies <setantae@submonkey.net>
To: Sean Chittenden <seanc@FreeBSD.org>
Message-ID: <20030408204204.GA46896@submonkey.net>
Mail-Followup-To: Ceri Davies <setantae@submonkey.net>,
	Sean Chittenden <seanc@FreeBSD.org>, doc-committers@FreeBSD.org,
	cvs-doc@FreeBSD.org
References: <200304072043.h37KhjrK033251@repoman.freebsd.org>
	<20030407204931.GF79923@perrin.int.nxad.com>
	<20030408091656.GA13794@submonkey.net>
	<20030408200612.GO79923@perrin.int.nxad.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20030408200612.GO79923@perrin.int.nxad.com>
User-Agent: Mutt/1.5.4i
Sender: Ceri Davies <setantae@submonkey.net>
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:42:07 -0000

On Tue, Apr 08, 2003 at 01:06:12PM -0700, Sean Chittenden wrote:
> > > 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

That *should* be ok, but if you can send me a patch I'll test it for you.

Ceri
--