From owner-cvs-doc@FreeBSD.ORG  Tue Apr  8 02:16:59 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 0BEC037B401; Tue,  8 Apr 2003 02:16:59 -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 E5D0643F75; Tue,  8 Apr 2003 02:16:57 -0700 (PDT)
	(envelope-from setantae@submonkey.net)
Received: from setantae by shrike.submonkey.net with local (Exim 4.12)
	id 192pDs-0003dK-00; Tue, 08 Apr 2003 10:16:56 +0100
Date: Tue, 8 Apr 2003 10:16:56 +0100
From: Ceri Davies <ceri@FreeBSD.org>
To: Sean Chittenden <seanc@FreeBSD.org>
Message-ID: <20030408091656.GA13794@submonkey.net>
Mail-Followup-To: Ceri Davies <ceri@FreeBSD.org>,
	Sean Chittenden <seanc@FreeBSD.org>, doc-committers@FreeBSD.org,
	cvs-doc@FreeBSD.org, cvs-all@FreeBSD.org
References: <200304072043.h37KhjrK033251@repoman.freebsd.org>
	<20030407204931.GF79923@perrin.int.nxad.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20030407204931.GF79923@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
cc: cvs-all@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 09:16:59 -0000

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