From owner-freebsd-doc@FreeBSD.ORG Thu Apr 12 09:49:39 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id BB7ED106566B for ; Thu, 12 Apr 2012 09:49:39 +0000 (UTC) (envelope-from utisoft@gmail.com) Received: from mail-bk0-f54.google.com (mail-bk0-f54.google.com [209.85.214.54]) by mx1.freebsd.org (Postfix) with ESMTP id 40F918FC18 for ; Thu, 12 Apr 2012 09:49:39 +0000 (UTC) Received: by bkcjc3 with SMTP id jc3so1850200bkc.13 for ; Thu, 12 Apr 2012 02:49:38 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:from:date :x-google-sender-auth:message-id:subject:to:cc:content-type :content-transfer-encoding; bh=hILGnQPNLdCqN+n4SoKbuNuDW/sKJxNAxOVMPGIjZnM=; b=bOU9zrOlupzkl2ZLyq9/Ot8Qi73ZzCX9fRHbB4oja8TxkBBvH9EYUpvGUza0Fhae5p rCNr8GanSXBCuJKr5swfjJyKPGts3sMhjyrOUe0f78Jcp1fXIWO2V0Yw4tR74n2m6v9q XipRC4nYODbbmObHkOuwlKe3zR2StwfA2zcmrmvTXc8KNyNAoXLzP6LqHklxrP8sbchH OElto6aQlLEe/v1ONA8VDn0uEWbAjimI5fIbDqvID3aCYcoP6BmqtYzcaYHXgDT+zeZ7 oC1oG3Fgrtm21HjbibdKZgvAZgh3EfMJolOMFnI7dOjnpp2fM9MHCGBNiIQ+qgpNM1Hq PMxw== Received: by 10.204.12.10 with SMTP id v10mr520403bkv.1.1334224178316; Thu, 12 Apr 2012 02:49:38 -0700 (PDT) MIME-Version: 1.0 Sender: utisoft@gmail.com Received: by 10.204.202.142 with HTTP; Thu, 12 Apr 2012 02:49:07 -0700 (PDT) In-Reply-To: <4F869F33.1010501@fjl.co.uk> References: <20120412090309.GK26895@goofy01.vnodelab.local> <4F869F33.1010501@fjl.co.uk> From: Chris Rees Date: Thu, 12 Apr 2012 09:49:07 +0000 X-Google-Sender-Auth: 77pEMSrgfJ4HZPkwwISSgVBKzaw Message-ID: To: Frank Leonhardt Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Cc: freebsd-doc@freebsd.org Subject: Re: "Doing the deed" on portupgrade 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, 12 Apr 2012 09:49:39 -0000 On 12 April 2012 09:24, Frank Leonhardt wrote: > On 12/04/2012 10:03, Joel Dahl wrote: >> >> On 12-04-2012 =A08:26, Chris Rees wrote: >>> >>> Hi all, >>> >>> Even since its deprecation, portupgrade has proven to be very popular >>> with newcomers, which I might be inclined to blame on the fact that >>> the Handbook lists it first. >>> >>> Two patches: > > >>> >>> >>> >>> Rendered at http://www.bayofrum.net/~crees/rendered/portupgrade.html >>> >>> Thoughts? =A0Anyone want to risk approving it? >> >> Good idea. I'd like to see Portmaster first in the list though, and not >> Portmanager. >> > > The text on the rendered version opens with "Portmanager is *another* > utility for easy upgrading when it's now the first to be mentioned. New patches, effectively reversing the order of the three: http://www.bayofrum.net/~crees/patches/move-portupgrade2.diff and then the content changes: http://www.bayofrum.net/~crees/patches/deprecate-portupgrade2.diff (I noticed my misspelling of portupgrade :/) Rendered at: http://www.bayofrum.net/~crees/rendered/portupgrade2.html > Not knowing very much about this system, I've always been a little confus= ed > by the multifarious options in the documentation like this. Listing them = in > order of preference would help but it'd be nice to start a section like t= his > with the pros and cons of the various strategies about to be outlined . T= he > reason for not using portupgrade is clear; Portmaster looks a good option > because it implies it won't drag in every scripting language and module > under the sun when you build it (according to the documentation posted). = So > why would anyone use Portmanager? (Incidentally, I have always used > portupgrade, simply because it's first on the list). > Yes, this section does need improving a little. My intention here is to stop the plethora of people asking for support on portupgrade after they've seen it in the Handbook listed first; you have just said that the same happened to you :) If you have such a list, it will be gladly received. Chris