From nobody@FreeBSD.org  Sun Feb 10 16:34:12 2013
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115])
	by hub.freebsd.org (Postfix) with ESMTP id DF679AB2
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 10 Feb 2013 16:34:12 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id BABAF6F0
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 10 Feb 2013 16:34:12 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.5/8.14.5) with ESMTP id r1AGYBh6094515
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 10 Feb 2013 16:34:11 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.5/8.14.5/Submit) id r1AGYBgc094514;
	Sun, 10 Feb 2013 16:34:11 GMT
	(envelope-from nobody)
Message-Id: <201302101634.r1AGYBgc094514@red.freebsd.org>
Date: Sun, 10 Feb 2013 16:34:11 GMT
From: Stefan Ollermann <Stefan.Ollermann@gmx.de>
To: freebsd-gnats-submit@FreeBSD.org
Subject: wrong order in docs for major upgrade 
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         176015
>Category:       docs
>Synopsis:       [handbook] wrong order in docs for major upgrade
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Feb 10 16:40:00 UTC 2013
>Closed-Date:    
>Last-Modified:  Sun Feb 10 21:11:46 UTC 2013
>Originator:     Stefan Ollermann
>Release:        8.2 -> 9.1
>Organization:
>Environment:
~> uname -a
FreeBSD XXX 8.2-RELEASE-p10 FreeBSD 8.2-RELEASE-p10 #7: Sat Oct  6 14:53:51 CEST 2012     root@XXX:/usr/obj/usr/src/sys/XXX  i386
>Description:
In the handbook you find under "25.2.3.1.1 Custom Kernels with FreeBSD 8.X and Earlier" instruction to install / generate a GENERIC kernel as part of a major upgrade.

In "25.2.3.2 Performing the Upgrade" is no link to the previous section "25.2.3.1.1". When you generate the GENERIC kernel following "25.2.3.1.1" and work through "25.2.3.2" the GENERIC kernel is removed as part of the "freebsd-update install" command.

"nextboot -k GENERIC" will fail cause GENERIC is removed.
>How-To-Repeat:
Follow handbook "25.2.3.1.1" and then "25.2.3.2"
>Fix:
GENERIC kernel must be build after the first "freebsd-update install" command.

>Release-Note:
>Audit-Trail:
>Unformatted:
