Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 8 Apr 2003 13:06:12 -0700
From:      Sean Chittenden <seanc@FreeBSD.org>
To:        Ceri Davies <ceri@FreeBSD.org>
Cc:        cvs-doc@FreeBSD.org
Subject:   Re: cvs commit: doc/en_US.ISO8859-1/books/handbook/eresources chapter.sgml
Message-ID:  <20030408200612.GO79923@perrin.int.nxad.com>
In-Reply-To: <20030408091656.GA13794@submonkey.net>
References:  <200304072043.h37KhjrK033251@repoman.freebsd.org> <20030407204931.GF79923@perrin.int.nxad.com> <20030408091656.GA13794@submonkey.net>

next in thread | previous in thread | raw e-mail | index | archive | help
> > 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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030408200612.GO79923>