From owner-freebsd-doc@FreeBSD.ORG Thu Dec 18 04:22:16 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 DF63C1065673 for ; Thu, 18 Dec 2008 04:22:16 +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 B61EA8FC16 for ; Thu, 18 Dec 2008 04:22:16 +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.3/8.14.3) with ESMTP id mBI4MFSr046734 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Wed, 17 Dec 2008 23:22:15 -0500 (EST) (envelope-from trhodes@FreeBSD.org) Date: Wed, 17 Dec 2008 23:22:07 -0500 From: Tom Rhodes To: "Murray Stokely" Message-Id: <20081217232207.53615962.trhodes@FreeBSD.org> In-Reply-To: <2a7894eb0812151835g51d3f64bg5c60d6f8e4fd2497@mail.gmail.com> References: <1226494693.1809.10.camel@localhost> <20081112200755.66c52a48.trhodes@FreeBSD.org> <491C39E7.7040609@gmail.com> <20081113185333.25a73ebf.trhodes@FreeBSD.org> <2a7894eb0812132146w42722ce5n809cd5d0a9c451eb@mail.gmail.com> <20081214185058.48a7c2c2.trhodes@FreeBSD.org> <2a7894eb0812141832u20af4821h121a520fab746c7c@mail.gmail.com> <20081215062858.6c76fb33.trhodes@FreeBSD.org> <20081215134919.51a88d90.trhodes@FreeBSD.org> <4946AAD6.6050300@gmail.com> <2a7894eb0812151835g51d3f64bg5c60d6f8e4fd2497@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: Cutting edge -> Upgrading (was: 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: Thu, 18 Dec 2008 04:22:17 -0000 Hi Murray, Manolis, On Mon, 15 Dec 2008 18:35:51 -0800 "Murray Stokely" wrote: > On Mon, Dec 15, 2008 at 11:07 AM, Manolis Kiagias wrote: > > If these chapters are merged, I think we will have to rethink the "The > > Cutting Edge" title. The title is by itself intimidating for the > > beginning-intermediate user who is already convinced it is best for him > > to use "RELEASE" until he is comfortable with the system. And using > > freebsd-update is essential (and a rather easy task) at any user level. > > > > How about changing the chapter to something like "Updating and Upgrading > > FreeBSD"? > > The first sections could deal with security updates and minor / major > > version upgrades using freebsd-update. > > Later sections could deal with -STABLE and -CURRENT > > It would probably need more than a few rewrites and reorganization though > > Yea I think this sounds good. Tom, can you include a link to the HTML > with your next diff -- I find it easier to review big reorganizations > in the built html form rather than the diffs. > > If there is really just too much content for one chapter then maybe > the updating and upgrading chapter could still be split into two > adjacent chapters -- one for the basics of updrading between releases > with mergemaster and such, and a second with more complicated source > upgrades to -CURRENT. > > - Murray > Apologies for this tardy reply, but I've recently come down with some kind of a bug. Anyway, this is what I have right now: http://people.freebsd.org/~trhodes/doc/latest-handbook.diff http://people.freebsd.org/~trhodes/doc/handbook/ The diff contains my Updating chapter placed above the current cutting-edge content along with some alterations to make the documentation flow a bit. Surely another update or two will be needed to perfect this version, but I think it looks pretty decent as it is now. This also contains some things I've been working on lately: o Added a warning about loss of data in GEOM chapter, covers a PR about gmirror; o Add a new section on syslog network monitoring to network-servers; o Add the Audit chapter to preface.sgml and mark up DTrace with &dtrace. The "additional" parts have already been reviewed by rene and pgj. An earlier version of the preface.sgml part was reviewed by Murray already. The handbook/ directory has a built version of the handbook with that diff applied. If there are no objections I'm perfectly cool with: Patching the preface, geom, and network-servers chapters; Putting in a repo copy request for cutting-edge/chapter.sgml to upgrading/chapter.sgml; Commit follow up to note the repocopy; Commit this version of cutting edge to upgrading/chapter.sgml; Final commit to remove cutting-edge and updating chapters from the build and the like. I'm positive someone will come up with a better way of handling this but I'm tired and a bit off. -- Tom Rhodes