From owner-freebsd-doc@FreeBSD.ORG  Thu Nov 13 23:53:36 2008
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@FreeBSD.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 7A9A01065670
	for <freebsd-doc@FreeBSD.org>; Thu, 13 Nov 2008 23:53:36 +0000 (UTC)
	(envelope-from trhodes@FreeBSD.org)
Received: from pittgoth.com (pittgoth.com [205.134.163.206])
	by mx1.freebsd.org (Postfix) with ESMTP id 382DF8FC17
	for <freebsd-doc@FreeBSD.org>; Thu, 13 Nov 2008 23:53:36 +0000 (UTC)
	(envelope-from trhodes@FreeBSD.org)
Received: from localhost.fbsdsecure.org (net-ix.gw.ai.net [205.134.160.6])
	(authenticated bits=0)
	by pittgoth.com (8.14.2/8.14.2) with ESMTP id mADNrZee016135
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT);
	Thu, 13 Nov 2008 18:53:35 -0500 (EST)
	(envelope-from trhodes@FreeBSD.org)
Date: Thu, 13 Nov 2008 18:53:33 -0500
From: Tom Rhodes <trhodes@FreeBSD.org>
To: Manolis Kiagias <sonic2000gr@gmail.com>
Message-Id: <20081113185333.25a73ebf.trhodes@FreeBSD.org>
In-Reply-To: <491C39E7.7040609@gmail.com>
References: <1226494693.1809.10.camel@localhost> <491B4F01.9020403@gmail.com>
	<2a7894eb0811121605k1310bf8avf7a69363fc504905@mail.gmail.com>
	<20081112200755.66c52a48.trhodes@FreeBSD.org>
	<491C39E7.7040609@gmail.com>
X-Mailer: Sylpheed version 1.0.6 (GTK+ 1.2.10; i386-portbld-freebsd8.0)
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Cc: freebsd-doc@FreeBSD.org, murray@stokely.org
Subject: Re: Preface need update.
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 13 Nov 2008 23:53:36 -0000

On Thu, 13 Nov 2008 16:29:59 +0200
Manolis Kiagias <sonic2000gr@gmail.com> wrote:

> Tom Rhodes wrote:
> > On Wed, 12 Nov 2008 16:05:55 -0800
> > "Murray Stokely" <murray@stokely.org> wrote:
> >
> >   
> >> Thanks Manolis.  Maybe we should add a comment to the Makefile so that
> >> when authors commit new chapters they remember to also update the
> >> preface summary.  Or alternatively, we could put some kind of one
> >> sentence chapter description in <chapterinfo> of each chapter and pull
> >> it out of each file dynamically when building the preface.  I'd
> >> probably recommend the low tech first suggestion as good enough.
> >>
> >>         - Murray
> >>     
> >
> > Yea, because I forget this every time I add a new chapter.  :(
> >
> >
> >   
> To take this idea one step further, I suggest we add the following 
> comment to the Makefile:
> 
> -----------------------------------------------------------------------------------------------------------------
> To add a new chapter to the Handbook:
> 
> - Update this Makefile, chapters.ent and book.sgml
> - Add a descriptive entry for the new chapter in preface/preface.sgml
> -----------------------------------------------------------------------------------------------------------------
> 
> Do you think this is good enough?

Yes.  And I need to look at the "changes since the third
edition" data as well.  :)

-- 
Tom Rhodes