From owner-freebsd-doc@FreeBSD.ORG Sat Oct 3 09:31:26 2009 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 12BF3106566B for ; Sat, 3 Oct 2009 09:31:26 +0000 (UTC) (envelope-from sonic2000gr@gmail.com) Received: from mail-ew0-f209.google.com (mail-ew0-f209.google.com [209.85.219.209]) by mx1.freebsd.org (Postfix) with ESMTP id 98D328FC18 for ; Sat, 3 Oct 2009 09:31:25 +0000 (UTC) Received: by ewy5 with SMTP id 5so828655ewy.36 for ; Sat, 03 Oct 2009 02:31:24 -0700 (PDT) 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 :x-enigmail-version:content-type:content-transfer-encoding; bh=b1KR5BHaAIWt/sCdF/yG8HpT+bi5lNbVzHnou6HpY7s=; b=S2xwZHmZvQioUNS/L6MzK6nyMXf8BUjFvB2y1XES9Rqx8qPe+TdVGeswOdHVyJqtzE gQkLlr0te+IiAVqu+BboAP7ZBGWy8xSj/Urfk8FGSQYqHan1Ve3wHiRiOSQKeBhHHjNh fH6KC2a9Uwtavxe2IjFpRfri8q6qMOJJ1P7Tk= 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:x-enigmail-version:content-type :content-transfer-encoding; b=a8kjaWYVRgHnvRD29/MRfsOkB+JY1ZyyzQcJ677F80SVkWXq/eqenScYohK/j3Vv5m allFztsDpgB/MZuO0JkojAmqyjdZQy7TsXsBrElO9VRl4pUBDJla7wSoH51V2L67l+/c vKhZyncB5/Hk8zB7YB51ED1S2bzhLhRV/kmeM= Received: by 10.210.9.12 with SMTP id 12mr4426075ebi.3.1254562284364; Sat, 03 Oct 2009 02:31:24 -0700 (PDT) Received: from pulstar.local (athedsl-4464757.home.otenet.gr [94.71.96.101]) by mx.google.com with ESMTPS id 5sm1388526eyh.0.2009.10.03.02.31.23 (version=TLSv1/SSLv3 cipher=RC4-MD5); Sat, 03 Oct 2009 02:31:23 -0700 (PDT) Message-ID: <4AC719EA.2030400@gmail.com> Date: Sat, 03 Oct 2009 12:31:22 +0300 From: Manolis Kiagias User-Agent: Thunderbird 2.0.0.23 (Macintosh/20090812) MIME-Version: 1.0 To: Jan Oppolzer References: <200910031057.03060.jan.oppolzer@gmail.com> In-Reply-To: <200910031057.03060.jan.oppolzer@gmail.com> X-Enigmail-Version: 0.96.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Cc: doc@freebsd.org Subject: Re: A misunderstanding in FreeBSD Handbook 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: Sat, 03 Oct 2009 09:31:26 -0000 Jan Oppolzer wrote: > Hello, > > in my opinion, there's a little mistake in FreeBSD Handbook in section 24.3 > Portsnap: A Ports Collection Update Tool [1] which can confuse mainly > newcomers in FreeBSD. > > If portsnap was run previously then after 'portsnap fetch' should be executed > 'portsnap update' (as noted in 'man portsnap') instead of 'portsnap extract' > which is said in the handbook. > > At the end there's written to execute 'portsnap fetch update' to run both > processes consecutively, but it was stated to run 'fetch' and then 'extract'. > Which is misleading. > > I guess it'd be a good idea to mention differences in "extract" and "update" or > at least mention they exist and to read manual page for more information which > one to use and when. > > [1] http://www.freebsd.org/doc/en/books/handbook/updating-upgrading- > portsnap.html > > > Best regards, > Jan Oppolzer > Hi Jan, You are right, the Handbook does not differentiate between extract (which should be used the first time only) and update (to be used on subsequent runs). I'll have a try at rewording this today to get it in line with the man page. Thanks!