From owner-freebsd-doc@FreeBSD.ORG Sat Oct 3 09:24:15 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 C55051065670 for ; Sat, 3 Oct 2009 09:24:15 +0000 (UTC) (envelope-from jan.oppolzer@gmail.com) Received: from mail-fx0-f222.google.com (mail-fx0-f222.google.com [209.85.220.222]) by mx1.freebsd.org (Postfix) with ESMTP id 587EA8FC0C for ; Sat, 3 Oct 2009 09:24:15 +0000 (UTC) Received: by fxm22 with SMTP id 22so1828740fxm.36 for ; Sat, 03 Oct 2009 02:24:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:from:to:subject:date :user-agent:mime-version:content-type:content-transfer-encoding :message-id; bh=lHiMtW71t0W2CUoDqaEcxokhnntUOfa6L9nOw2nDiGM=; b=ZKFacUoiqzYUH+R0/vaJjWen/ltcJ96PZVIHpyaBJjqrtoii0IG2OccLl3GkJmukGG 9N0apO2LXnDRVyrZUMh8UdsaQ7sPRpZxjU2mdY/CM/UCxg0rk9yaGpleOg4ZL+B2l0NL HCiOVn6MIrhIwFqwUNehnVrOC7EKcep265sLs= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=from:to:subject:date:user-agent:mime-version:content-type :content-transfer-encoding:message-id; b=Enr6C1N/g3yVLanQ6EESx8KtS3XNXuM/LYjDRUi30JakGg4WCyL3t6e9NG+MDmoH+M VaWR3H6XWEzueWtcfeVW9qS2gJRXHqmuCzmJZfXgK5zPTZl6MVh04c2XfTmjq7vXOSUQ +gTxgpvs/7/gil2rsUrkeAd7O3DQQPwPFIl60= Received: by 10.86.184.35 with SMTP id h35mr3252990fgf.18.1254560204615; Sat, 03 Oct 2009 01:56:44 -0700 (PDT) Received: from frigg.localnet (frigg.sin.cvut.cz [147.32.107.123]) by mx.google.com with ESMTPS id 12sm1426060fgg.23.2009.10.03.01.56.42 (version=SSLv3 cipher=RC4-MD5); Sat, 03 Oct 2009 01:56:43 -0700 (PDT) From: Jan Oppolzer To: doc@freebsd.org Date: Sat, 3 Oct 2009 10:57:02 +0200 User-Agent: KMail/1.12.1 (Linux/2.6.31-gentoo; KDE/4.3.1; x86_64; ; ) MIME-Version: 1.0 Content-Type: Text/Plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Message-Id: <200910031057.03060.jan.oppolzer@gmail.com> Cc: Subject: 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:24:15 -0000 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