From owner-freebsd-doc@FreeBSD.ORG Sun Dec 14 05:46:06 2008 Return-Path: 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 6A87E106568A for ; Sun, 14 Dec 2008 05:46:06 +0000 (UTC) (envelope-from murray@stokely.org) Received: from ik-out-1112.google.com (ik-out-1112.google.com [66.249.90.178]) by mx1.freebsd.org (Postfix) with ESMTP id 0A8468FC2F for ; Sun, 14 Dec 2008 05:46:05 +0000 (UTC) (envelope-from murray@stokely.org) Received: by ik-out-1112.google.com with SMTP id c21so560827ika.3 for ; Sat, 13 Dec 2008 21:46:04 -0800 (PST) Received: by 10.210.116.14 with SMTP id o14mr6238833ebc.90.1229233564516; Sat, 13 Dec 2008 21:46:04 -0800 (PST) Received: by 10.210.71.14 with HTTP; Sat, 13 Dec 2008 21:46:04 -0800 (PST) Message-ID: <2a7894eb0812132146w42722ce5n809cd5d0a9c451eb@mail.gmail.com> Date: Sat, 13 Dec 2008 21:46:04 -0800 From: "Murray Stokely" To: "Tom Rhodes" In-Reply-To: <20081113185333.25a73ebf.trhodes@FreeBSD.org> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <1226494693.1809.10.camel@localhost> <491B4F01.9020403@gmail.com> <2a7894eb0811121605k1310bf8avf7a69363fc504905@mail.gmail.com> <20081112200755.66c52a48.trhodes@FreeBSD.org> <491C39E7.7040609@gmail.com> <20081113185333.25a73ebf.trhodes@FreeBSD.org> Cc: freebsd-doc@freebsd.org Subject: Re: Preface need update. X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 14 Dec 2008 05:46:06 -0000 Hi Tom, I've just committed a new section to the preface with pointers to the Filesystems and DTrace chapters you committed, and also the Virtualization chapter I committed in 2007. There are others (e.g. updating) but I wasn't sure if some of that content was moved from other chapters (cutting edge?) as if so we'd want to mention that in the preface item for that new chapter. Please take a look when you get a chance and add a few more items to this section about some of the work you've done recently. We presumably also need something about the security event auditing chapter. Thanks, - Murray On Thu, Nov 13, 2008 at 3:53 PM, Tom Rhodes wrote: > On Thu, 13 Nov 2008 16:29:59 +0200 > Manolis Kiagias wrote: > >> Tom Rhodes wrote: >> > On Wed, 12 Nov 2008 16:05:55 -0800 >> > "Murray Stokely" 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 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 >