From brooks@minya.sea.one-eyed-alien.net  Thu Mar 15 22:33:08 2001
Return-Path: <brooks@minya.sea.one-eyed-alien.net>
Received: from minya.sea.one-eyed-alien.net (minya.sea.one-eyed-alien.net [216.39.168.226])
	by hub.freebsd.org (Postfix) with ESMTP id CA0E037B719
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 15 Mar 2001 22:33:07 -0800 (PST)
	(envelope-from brooks@minya.sea.one-eyed-alien.net)
Received: by minya.sea.one-eyed-alien.net (Postfix, from userid 1001)
	id 9936124D22; Thu, 15 Mar 2001 22:39:07 -0800 (PST)
Message-Id: <20010316063907.9936124D22@minya.sea.one-eyed-alien.net>
Date: Thu, 15 Mar 2001 22:39:07 -0800 (PST)
From: brooks@one-eyed-alien.net
Reply-To: brooks@one-eyed-alien.net
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] handbook implies that partial source upgrade are ok
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         25844
>Category:       docs
>Synopsis:       [PATCH] handbook implies that partial source upgrade are ok
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Mar 15 22:40:01 PST 2001
>Closed-Date:    Fri Mar 16 17:58:48 PST 2001
>Last-Modified:  Fri Mar 16 17:58:59 PST 2001
>Originator:     Brooks Davis
>Release:        FreeBSD 5.0-CURRENT i386
>Organization:
>Environment:
System: FreeBSD minya.sea.one-eyed-alien.net 5.0-CURRENT FreeBSD 5.0-CURRENT #9: Sat Mar 10 15:31:27 PST 2001 root@minya.sea.one-eyed-alien.net:/usr/obj/usr/src/sys/MINYA i386


	
>Description:

In the section titled "Synchronizing Your Source" the handbook says:

	There are various ways of using an Internet (or email)
	connection to stay up-to-date with any given area of the
	FreeBSD project sources, or all areas, depending on what
	interests you.

At least one user and misinterpreted this to mean that you could, for
example, update your kernel but not your userland.  This is untrue.

>How-To-Repeat:
	
>Fix:

The following patch warns users not do try this and also warns them not
to update their kernel without updating their world.

Index: cutting-edge/chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO_8859-1/books/handbook/cutting-edge/chapter.sgml,v
retrieving revision 1.59
diff -u -r1.59 chapter.sgml
--- cutting-edge/chapter.sgml	2001/01/03 13:23:22	1.59
+++ cutting-edge/chapter.sgml	2001/03/16 06:30:58
@@ -402,6 +402,16 @@
       CVS</link>, <link linkend="cvsup">CVSup</link>, and <link
       linkend="ctm">CTM</link>.</para>
 
+    <caution>
+      <para>While it is possible to update only parts of your source
+        tree, the only supported update procedure is to update the entire
+	tree and recompile both userland and kernel sources.  Updating
+	only part of your source tree, only the kernel or only
+	userland will often result in problems.  These problems may
+	range from compile errors to kernel panics and data
+	corruption.</para>
+    </caution>
+
     <para><application>Anonymous CVS</application> and
       <application>CVSup</application> use the <emphasis>pull</emphasis>
       model of updating sources.  In the case of
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: dd 
State-Changed-When: Fri Mar 16 17:58:48 PST 2001 
State-Changed-Why:  
Committed, thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=25844 
>Unformatted:
