From owner-freebsd-doc@FreeBSD.ORG Wed Jan 7 07:36:00 2009 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 4A9A3106566B; Wed, 7 Jan 2009 07:36:00 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: from mail-ew0-f21.google.com (mail-ew0-f21.google.com [209.85.219.21]) by mx1.freebsd.org (Postfix) with ESMTP id 551CC8FC0C; Wed, 7 Jan 2009 07:35:58 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: by ewy14 with SMTP id 14so9895159ewy.19 for ; Tue, 06 Jan 2009 23:35:58 -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:subject:references:in-reply-to :content-type:content-transfer-encoding; bh=1cGs5WJzXgdfwAmEgP7YUOa0/yh3X/3jxh1Ejf6ZlRk=; b=C4R9YO0Zs5DvTxPRWd1frZRh9bKd1zg7JbkCfxuh8qe8UySRYV6s1jblnElwzV0Fh3 de4rEn0R9jLO+YBVTZ0YvZ6/cc+cWz+lIIlVU0acXAWtaLIrhtJlNE58zqMTEh7ECxPJ oizQ6wytH29/ReBxv1lSfcJaVdtgsEwTWu4L4= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:user-agent:mime-version:to:subject:references :in-reply-to:content-type:content-transfer-encoding; b=Z/k4SYc9qX2xIcDeTCKNjB043TBW5xmVZEVkKURkfyldJx/jGT9sy3q/wrt4tZ1GKy kmeb932gFkUAJGTlFDF3GdWeATIF27ZMoQCkCRtbWJZRTjqgRvG2sFXxePR7J5XF1Iil GBjfn4DqH6NSQJtEe5UCLWAKUZd7xCoAMaFVc= Received: by 10.210.54.17 with SMTP id c17mr5193666eba.35.1231313757890; Tue, 06 Jan 2009 23:35:57 -0800 (PST) Received: from theone.dyndns.org ([81.186.52.90]) by mx.google.com with ESMTPS id 10sm3403293eyz.39.2009.01.06.23.35.56 (version=TLSv1/SSLv3 cipher=RC4-MD5); Tue, 06 Jan 2009 23:35:57 -0800 (PST) Message-ID: <49645B49.8020301@gmail.com> Date: Wed, 07 Jan 2009 09:35:37 +0200 From: Manolis Kiagias User-Agent: Thunderbird 2.0.0.17 (X11/20081011) MIME-Version: 1.0 To: Giorgos Keramidas , Gabor PALI , freebsd-doc@freebsd.org, frank@shute.org.uk References: <4956903C.5060405@FreeBSD.org> <874p0f9dv7.fsf@kobe.laptop> <20090104203631.GA24306@melon.esperance-linux.co.uk> <87iqosgrva.fsf@kobe.laptop> <20090107065358.GA36732@melon.esperance-linux.co.uk> In-Reply-To: <20090107065358.GA36732@melon.esperance-linux.co.uk> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: Subject: Re: [RFC] A Handbook Section on Updating the Documentation Set 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: Wed, 07 Jan 2009 07:36:00 -0000 Frank Shute wrote: > On Tue, Jan 06, 2009 at 09:24:25PM +0200, Giorgos Keramidas wrote: > >> On Sun, 4 Jan 2009 20:36:31 +0000, Frank Shute wrote: >> >>> On Sun, Jan 04, 2009 at 07:31:56PM +0200, Giorgos Keramidas wrote: >>> >>>> On Sat, 27 Dec 2008 21:29:48 +0100, Gabor PALI wrote: >>>> >>>>> http://people.freebsd.org/~pgj/patches/2008/12/27/updating-upgrading-documentation.patch.diff >>>>> >>>> Ping... Any news about this patch? >>>> >>> Hi Giorgos, >>> >>> If you remember, you asked me if I could get the page I wrote about >>> using csup to update the docs: >>> >>> http://www.shute.org.uk/misc/freebsd_uptodate.html >>> >>> into some sort of state to be incorporated into the updating section >>> of the handbook. >>> >> Hi Frank, >> >> "Yes", and if you can review the existing patch by Gabor Pali :) >> > > I've had a look at the patch and I like it. I wish it had existed in > the docs before! > > A niggle though: > > Are the docs going to start using s/cvsup/csup/? ATM, there's only a > note in "A.6 Using CVSup" about using csup instead of cvsup; but the > chapter on installing ports uses csup. It's all a bit inconsistent. > > There is a note in the synopsis of the 'Updating and Upgrading FreeBSD' chapter that cvsup may be substituted by csup in the chapter's instructions. Currently, cvsup has a "cvs mode" used to replicate entire repositories (and not simply performing a checkout as csup does). This is mostly used by developers though, and most handbook instructions use cvsup exactly like csup. AFAIK, there is an effort to introduce this functionality in csup too. CVSup will then become redundant. Until then it will unfortunately keep causing confusion to lots of people. > I think Gabor's patch should use csup & have a note about using cvsup > if you've got an OS < 6.2. As far as I can see, only developers who > want to pull the CVS files need cvsup & those with older releases... > although they can install the csup port with it's fewer dependencies. > > I didn't see any errors in it otherwise & I thought it gave a nice > easy to follow guide which is what's needed. > >