From owner-cvs-doc@FreeBSD.ORG  Mon Apr  7 13:49:43 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 0D0F837B401; Mon,  7 Apr 2003 13:49:43 -0700 (PDT)
Received: from perrin.int.nxad.com (internal.ext.nxad.com [69.1.70.251])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 69AA043F93; Mon,  7 Apr 2003 13:49:42 -0700 (PDT)
	(envelope-from sean@perrin.int.nxad.com)
Received: by perrin.int.nxad.com (Postfix, from userid 1001)
	id 0B2AE21064; Mon,  7 Apr 2003 13:49:32 -0700 (PDT)
Date: Mon, 7 Apr 2003 13:49:31 -0700
From: Sean Chittenden <seanc@FreeBSD.org>
To: doc-committers@FreeBSD.org, cvs-doc@FreeBSD.org,
	cvs-all@FreeBSD.org
Message-ID: <20030407204931.GF79923@perrin.int.nxad.com>
References: <200304072043.h37KhjrK033251@repoman.freebsd.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <200304072043.h37KhjrK033251@repoman.freebsd.org>
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/
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: Mon, 07 Apr 2003 20:49:43 -0000

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

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.

-sc

-- 
Sean Chittenden