From owner-freebsd-questions@FreeBSD.ORG  Fri Apr 11 13:40:38 2014
Return-Path: <owner-freebsd-questions@FreeBSD.ORG>
Delivered-To: freebsd-questions@FreeBSD.org
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id 944D38A0
 for <freebsd-questions@FreeBSD.org>; Fri, 11 Apr 2014 13:40:38 +0000 (UTC)
Received: from be-well.ilk.org (be-well.ilk.org [23.30.133.173])
 by mx1.freebsd.org (Postfix) with ESMTP id 55D871AB1
 for <freebsd-questions@FreeBSD.org>; Fri, 11 Apr 2014 13:40:35 +0000 (UTC)
Received: by be-well.ilk.org (Postfix, from userid 1147)
 id 4EDBC33C49; Fri, 11 Apr 2014 09:40:34 -0400 (EDT)
From: Lowell Gilbert <freebsd-questions-local@be-well.ilk.org>
To: Brad Fleming <bdflemin@gmail.com>
Subject: Re: Potential Doc Mistake
References: <DEE55AA1-986C-465C-9009-50ED3E91205C@gmail.com>
 <44wqex5czr.fsf@be-well.ilk.org>
 <CF43A967-0328-4B52-8A20-477175F1A782@gmail.com>
Date: Fri, 11 Apr 2014 09:40:33 -0400
In-Reply-To: <CF43A967-0328-4B52-8A20-477175F1A782@gmail.com> (Brad Fleming's
 message of "Thu, 10 Apr 2014 12:55:26 -0500")
Message-ID: <44ha60t25q.fsf@be-well.ilk.org>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3 (berkeley-unix)
MIME-Version: 1.0
Content-Type: text/plain; charset=windows-1252
Content-Transfer-Encoding: quoted-printable
Cc: cperiva@freebsd.org, freebsd-questions@FreeBSD.org
X-BeenThere: freebsd-questions@freebsd.org
X-Mailman-Version: 2.1.17
Precedence: list
Reply-To: freebsd-questions@FreeBSD.org
List-Id: User questions <freebsd-questions.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-questions>, 
 <mailto:freebsd-questions-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-questions/>
List-Post: <mailto:freebsd-questions@freebsd.org>
List-Help: <mailto:freebsd-questions-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-questions>, 
 <mailto:freebsd-questions-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 11 Apr 2014 13:40:38 -0000

Brad Fleming <bdflemin@gmail.com> writes:

> On Apr 10, 2014, at 12:08 PM, Lowell Gilbert <freebsd-questions-local@be-=
well.ilk.org> wrote:
>
>> Brad Fleming <bdflemin@gmail.com> writes:
>>=20
>>> I think this document might have  syntax error:
>>> https://www.freebsd.org/doc/handbook/updating-upgrading-freebsdupdate.h=
tml
>>>=20
>>> Under "23.2.3.2. Performing the Upgrade=94 the first command listed is:
>>> "freebsd-update -r 9.1-RELEASE upgrade=94
>>> but I believe the proper command should be:
>>> "freebsd-update upgrade -r 9.1-RELEASE=94
>>> (the =93upgrade=94 is in the wrong place)
>>>=20
>>> I could certainly be wrong but the second command is what=92s referenced
>>> in other documents and was required for me to move from 9.2 to 10.0.
>>=20
>> The manual page actually lists options before the subcommand. A quick
>> look at the source makes me think that either order is fine.

> The command as listed fails on my 9.2-RELEASE VM. But perhaps that=92s
> different in other versions. In either case I=92m not a Free BSD master
> and could certainly be wrong.

Unfortunately, I didn't have time to really look at this closely, so
it's probably me that's wrong. I'll leave a note to myself to dive in if
I get a chance, but it would be better if someone else gave it a look.