Bug 18683

Summary: Insufficient detail in /usr/src/UPDATING instructions
Product: Documentation Reporter: alex <alex>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description alex 2000-05-19 23:20:01 UTC 
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.
Comment 1 eogren 2000-05-20 03:30:21 UTC 
 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.
Comment 2 Joseph Koshy freebsd_committer freebsd_triage 2000-05-25 11:43:19 UTC 
State Changed
From-To: open->closed

"/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 :).