From owner-freebsd-doc@FreeBSD.ORG Sun Dec 14 23:51: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 E1B76106567D for ; Sun, 14 Dec 2008 23:51:05 +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 9D1AE8FC1A for ; Sun, 14 Dec 2008 23:51:05 +0000 (UTC) (envelope-from trhodes@FreeBSD.org) Received: from localhost.fbsdsecure.org (c-68-83-213-214.hsd1.va.comcast.net [68.83.213.214]) (authenticated bits=0) by pittgoth.com (8.14.3/8.14.3) with ESMTP id mBENp4oX024651 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Sun, 14 Dec 2008 18:51:04 -0500 (EST) (envelope-from trhodes@FreeBSD.org) Date: Sun, 14 Dec 2008 18:50:58 -0500 From: Tom Rhodes To: "Murray Stokely" Message-Id: <20081214185058.48a7c2c2.trhodes@FreeBSD.org> In-Reply-To: <2a7894eb0812132146w42722ce5n809cd5d0a9c451eb@mail.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> <20081113185333.25a73ebf.trhodes@FreeBSD.org> <2a7894eb0812132146w42722ce5n809cd5d0a9c451eb@mail.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 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 23:51:06 -0000 Hi Murray, On Sat, 13 Dec 2008 21:46:04 -0800 "Murray Stokely" wrote: > 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 for that! I definitely slacked here, but I'll keep this in mind for the future. About the updating chapter, I am unable to find any information on portsnap in my printed copy of the Handbook (third edition). They could have existed (I see a 2006 commit date for freebsd-update in src) but seem to have not been documented in the handbook. Anyway, how does this patch look to you?: diff -u -r1.44 preface.sgml --- preface.sgml 14 Dec 2008 05:42:48 -0000 1.44 +++ preface.sgml 14 Dec 2008 23:45:05 -0000 @@ -47,6 +47,19 @@ + , Updating, has been added to + cover various methods of keeping the system up to date with + the latest in security patches and changes in the Ports + Collection. + + + + , Security Event Auditing, has + been added to cover the new auditing capabilities in &os; + and explain its use. + + + , Virtualization, has been added with information about installing &os; on virtualization software. Thanks, > > 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 > > > -- Tom Rhodes