From owner-freebsd-doc@FreeBSD.ORG Fri Dec 19 06:15:19 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 1BC061065673; Fri, 19 Dec 2008 06:15:19 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: from ug-out-1314.google.com (ug-out-1314.google.com [66.249.92.175]) by mx1.freebsd.org (Postfix) with ESMTP id 701838FC13; Fri, 19 Dec 2008 06:15:18 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: by ug-out-1314.google.com with SMTP id 30so450075ugs.39 for ; Thu, 18 Dec 2008 22:15:17 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from :user-agent:mime-version:to:cc:subject:references:in-reply-to :content-type:content-transfer-encoding; bh=k24x/i+dRZWOLa9RmLPlq84VLDj7Xm5JOgn0Xqq7+/I=; b=c+uAwX+LtDy8PL/zwmZkXZ87H6VHSsyjytyjrdEcq7h6U/P2bgrIh3qOilpdNp+dO9 8eyY9CJi3xLlRHQsn7POsPsx6InuiNNYDmSmPXZgan+/hhM9O+97B2MgBur7zxqCCji2 WI0A/4LUbsryhpW9abrRxeKTo16OEQ5lvm+gk= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; b=jh4ZFMZPsAWdvp4pm+pzWS3RLlCkWCdnoLfnNsSL4SJL/eBmkairSZy1aWDWNX8v7o 44n7KsC6ULs52HhWNaD7gJ7dQpJi3Dy3AgcH6VOLC3iHTuedI4p+oqTMkn1yTLUCi/xH 9R/5RH7gz+8eOoWvZSUn7rVXYRqH5Hzv3IvtM= Received: by 10.67.106.19 with SMTP id i19mr4624464ugm.46.1229667316900; Thu, 18 Dec 2008 22:15:16 -0800 (PST) Received: from atlantis.dyndns.org (athedsl-279638.home.otenet.gr [85.73.139.244]) by mx.google.com with ESMTPS id m1sm6087799uge.48.2008.12.18.22.15.15 (version=TLSv1/SSLv3 cipher=RC4-MD5); Thu, 18 Dec 2008 22:15:16 -0800 (PST) Message-ID: <494B3BF2.8050600@gmail.com> Date: Fri, 19 Dec 2008 08:15:14 +0200 From: Manolis Kiagias User-Agent: Thunderbird 2.0.0.17 (X11/20081011) MIME-Version: 1.0 To: Tom Rhodes 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> <20081217232207.53615962.trhodes@FreeBSD.org> <494A9F76.2020401@gmail.com> <20081218220303.36017fa2.trhodes@FreeBSD.org> In-Reply-To: <20081218220303.36017fa2.trhodes@FreeBSD.org> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: freebsd-doc@FreeBSD.org, murray@stokely.org Subject: Re: Cutting edge -> Upgrading 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: Fri, 19 Dec 2008 06:15:19 -0000 Tom Rhodes wrote: > On Thu, 18 Dec 2008 21:07:34 +0200 > Manolis Kiagias wrote: > > >> Tom Rhodes wrote: >> >>> 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. >>> >>> >>> >> Thanks Tom, this is more or less what I had in mind for the >> updating-upgrading chapter :) >> Having read the synopsis, I feel we need to change it a bit so it >> matches more closely the updated content. >> Something like this: >> >> http://people.freebsd.org/~manolis/updating-upgrading.html#UPDATING-UPGRADING-SYNOPSIS >> >> and the patch: >> >> http://people.freebsd.org/~manolis/cutting-edge.txt >> >> Basically this rephrases the original a bit, and also reorders >> the itemized list to more or less match the order the info is presented >> in the chapter. Feel free to change it as you see fit ;) >> > > This version of the patch has been applied to my try, and > integrated with the latest changes done by Murray today. > > The latest patch and build handbook version is up here: > > http://people.FreeBSD.org/~trhodes/doc > > Please let me know how you feel about it. Other than the > directory name issue (cutting edge v. updating-upgrading), I > think it's pretty nice. We should consider moving forward > should no one object. Thanks, > > Yes, it looks fine to me. As a final touch, maybe it would be nice to change the title of section 24.4 from: 24.4 FreeBSD-CURRENT vs. FreeBSD-STABLE to 24.4 Tracking a Development Branch I think this flows better now that the chapter does not exclusively deal with CURRENT and STABLE.