From nobody@FreeBSD.ORG  Fri May 19 15:17:20 2000
Return-Path: <nobody@FreeBSD.ORG>
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id E037437B9AF; Fri, 19 May 2000 15:17:20 -0700 (PDT)
Message-Id: <20000519221720.E037437B9AF@hub.freebsd.org>
Date: Fri, 19 May 2000 15:17:20 -0700 (PDT)
From: alex@wnm.net
Sender: nobody@FreeBSD.ORG
To: freebsd-gnats-submit@FreeBSD.org
Subject: Insufficient detail in /usr/src/UPDATING instructions
X-Send-Pr-Version: www-1.0

>Number:         18683
>Category:       docs
>Synopsis:       Insufficient detail in /usr/src/UPDATING instructions
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri May 19 15:20:01 PDT 2000
>Closed-Date:    Thu May 25 03:43:19 PDT 2000
>Last-Modified:  Thu May 25 03:46:52 PDT 2000
>Originator:     Alex Charalabidis
>Release:        4.0-RELEASE
>Organization:
WebNet Memphis
>Environment:
4.0-RELEASE
4.0-STABLE
>Description:
The section on updating from 3.x to 4.0 in /usr/src/UPDATING is missing
an instruction to mount the filesystems after booting in single user mode.
While far from critical, less experienced users, including those who may
never have had reason to boot in single-user mode, can and will be
confused.
>How-To-Repeat:
Follow the instructions in lines 63 and 64 of the file literally. Watch
it fail to find /usr/src.
>Fix:
--- UPDATING    Fri May 19 17:08:44 2000
+++ UPDATING.patched    Fri May 19 17:09:59 2000
@@ -61,6 +61,7 @@
 	<follow rebuild disk /dev entries above>        [*]
 	reboot
 	<in single user>
+	<mount your filesystems>
 	cd /usr/src
 	make -DNOINFO installworld
 	make installworld


>Release-Note:
>Audit-Trail:

From: Eric Ogren <eogren@earthlink.net>
To: alex@wnm.net
Cc: freebsd-gnats-submit@FreeBSD.ORG
Subject: Re: docs/18683: Insufficient detail in /usr/src/UPDATING instructions
Date: Fri, 19 May 2000 22:30:21 -0400

  Personally, I do not think that this change should be made. If a user
 does not know enough about FreeBSD to know how to mount their partitions
 from single-user mode, ***they should not be upgrading via source***.
  I have said this many times, and I will re-iterate it again: if users are
 not experienced, they should *only* use binary snapshots to upgrade.
 
  I am of course not a committer, but I felt like I should log my
 objections anyway. :)
 
  Eric
 
 On Fri, May 19, 2000 at 03:17:20PM -0700, alex@wnm.net wrote:
 > 
 > >Description:
 > The section on updating from 3.x to 4.0 in /usr/src/UPDATING is missing
 > an instruction to mount the filesystems after booting in single user mode.
 > While far from critical, less experienced users, including those who may
 > never have had reason to boot in single-user mode, can and will be
 > confused.
 
State-Changed-From-To: open->closed 
State-Changed-By: jkoshy 
State-Changed-When: Thu May 25 03:43:19 PDT 2000 
State-Changed-Why:  
"/usr/src/UPDATING" is meant to be a reminder for -current 
developers only; it is not suitable for use as a guideline for 
doing a source upgrade between two -stable branches. 

We need documentation for people wanting to upgrade via source 
from one -stable branch to another.  A separate PR (docs/18807) 
has been filed so that we don't forget :). 
>Unformatted:
