cvs commit: doc/en_US.ISO8859-1/books/handbook/eresources chapter.sgml

[Ceri Davies]

On Mon, Apr 07, 2003 at 01:49:31PM -0700, Sean Chittenden wrote:
> > seanc       2003/04/07 13:43:45 PDT
> > 
> >   FreeBSD doc repository
> > 
> >   Modified files:
> >     en_US.ISO8859-1/books/handbook/eresources chapter.sgml 
> >   Log:
> >   Click-ify various listnames to point to
> >   http://lists.freebsd.org/mailman/listinfo/.  While I'm here, remove the
> >   digest email lists since that's an account preference under Mailman.  The
> >   freebsd-install list doesn't exist any more (now is -config), and very
> >   hastily thump out documentation on how to subscribe/unsubscribe to/from
> >   various mailing lists (though this should be much more obvious and easier
> >   for users since every email has a URL to click on at the bottom of each
> >   message).

Thanks for doing this.

> 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.

Ceri
--