From owner-freebsd-doc  Thu Mar 15 22:40: 8 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id E38D937B71A
	for <freebsd-doc@freebsd.org>; Thu, 15 Mar 2001 22:40:01 -0800 (PST)
	(envelope-from gnats@FreeBSD.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.1/8.11.1) id f2G6e1A67858;
	Thu, 15 Mar 2001 22:40:01 -0800 (PST)
	(envelope-from gnats)
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
X-Send-Pr-Version: 3.113
Subject: docs/25844: [PATCH] handbook implies that partial source upgrade are ok
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         25844
>Category:       docs
>Synopsis:       [PATCH] handbook implies that partial source upgrade are ok
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Mar 15 22:40:01 PST 2001
>Closed-Date:
>Last-Modified:
>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:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message