From owner-freebsd-doc@FreeBSD.ORG  Thu Apr 12 08:27:31 2012
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 7B04C106566C
	for <doc@freebsd.org>; Thu, 12 Apr 2012 08:27:31 +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 0BA558FC14
	for <doc@freebsd.org>; Thu, 12 Apr 2012 08:27:30 +0000 (UTC)
Received: by bkcjc3 with SMTP id jc3so1770987bkc.13
	for <doc@freebsd.org>; Thu, 12 Apr 2012 01:27:30 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;
	h=mime-version:from:date:message-id:subject:to:content-type;
	bh=PcASNqrsg4+RmwtCgHpjPZfgkAwa24WZMiJTmHojZ7Y=;
	b=Dsa1s/tGw6ytKfIso7oEAeDoOOdEFJk70+fCIxlnwZceV/nTLQ2gkagem372DCVqNx
	f8to3QnPwQB8uewDfi+nKr7wAUKaOV5I5XcY3gQpPi1OkIH6LDWuAZsSJTlYCfbkvGrF
	kWFOlpPN9qbtMSeLPwAttxMEg0b0226IcR2C+yuoPj95gGWhlKz1Nnet/1VbJchOuIjF
	svJjacT3WCt1WS9Dxkfk4TlpekubEg3UGW38ROBrmfF0GTwZ5zuNQfB/rhxUQuQ9I0wi
	1Lh719WXzw3PdTkqcr6GE1w4/evqFszs0rGH1FZKArTeGZcetHq9RVI714eRNUXy401p
	CV3A==
Received: by 10.205.129.137 with SMTP id hi9mr454469bkc.131.1334219249925;
	Thu, 12 Apr 2012 01:27:29 -0700 (PDT)
MIME-Version: 1.0
Received: by 10.204.202.142 with HTTP; Thu, 12 Apr 2012 01:26:59 -0700 (PDT)
From: Chris Rees <utisoft@gmail.com>
Date: Thu, 12 Apr 2012 08:26:59 +0000
Message-ID: <CADLo839V4BtuRF-ze6qS3xvU1kYsi_7KoChP7WFaYx5D59oZBA@mail.gmail.com>
To: doc@freebsd.org
Content-Type: text/plain; charset=ISO-8859-1
Cc: 
Subject: "Doing the deed" on portupgrade
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 12 Apr 2012 08:27:31 -0000

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:

http://www.bayofrum.net/~crees/patches/move-portupgrade.diff -- move
the portupgrade section to the bottom

http://www.bayofrum.net/~crees/patches/deprecate-portupgrade.diff --
add a note to suggest it's a bad idea to use it.

Rendered at http://www.bayofrum.net/~crees/rendered/portupgrade.html

Thoughts?  Anyone want to risk approving it?

Chris