From owner-freebsd-doc@FreeBSD.ORG Mon Dec 15 02:32:09 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 4AA541065670; Mon, 15 Dec 2008 02:32:09 +0000 (UTC) (envelope-from murray@stokely.org) Received: from mail-ew0-f21.google.com (mail-ew0-f21.google.com [209.85.219.21]) by mx1.freebsd.org (Postfix) with ESMTP id AEA5A8FC0C; Mon, 15 Dec 2008 02:32:08 +0000 (UTC) (envelope-from murray@stokely.org) Received: by ewy14 with SMTP id 14so3242193ewy.19 for ; Sun, 14 Dec 2008 18:32:07 -0800 (PST) Received: by 10.210.70.14 with SMTP id s14mr4971009eba.151.1229308327372; Sun, 14 Dec 2008 18:32:07 -0800 (PST) Received: by 10.210.71.14 with HTTP; Sun, 14 Dec 2008 18:32:07 -0800 (PST) Message-ID: <2a7894eb0812141832u20af4821h121a520fab746c7c@mail.gmail.com> Date: Sun, 14 Dec 2008 18:32:07 -0800 From: "Murray Stokely" To: "Tom Rhodes" In-Reply-To: <20081214185058.48a7c2c2.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> <2a7894eb0812132146w42722ce5n809cd5d0a9c451eb@mail.gmail.com> <20081214185058.48a7c2c2.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: Mon, 15 Dec 2008 02:32:09 -0000 On Sun, Dec 14, 2008 at 3:50 PM, Tom Rhodes wrote: > 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. Ahh, I see, nothing was moved over from the Cutting Edge chapter. This chapter has just about the exact same purpose as the new Updating chapter, they just describe different tools. The first chapter Updating, even references the latter chapter (Cutting Edge) as a pre-requisite in the synopsis by saying one needs to read it to learn about Mergemaster. There should only be one updating chapter. Cutting Edge was there first, but updating is maybe a better name. How do you feel about merging them back into one chapter? > Anyway, how does this patch look to you?: Everything else looks good, except I don't like that we now have two chapters for updating instead of one. I wasn't paying attention when that happened. =) Maybe just submit the new item for auditing while we sort out what to do about updating? - Murray