Date: Thu, 15 Mar 2001 22:39:07 -0800 (PST) From: brooks@one-eyed-alien.net To: FreeBSD-gnats-submit@freebsd.org Subject: docs/25844: [PATCH] handbook implies that partial source upgrade are ok Message-ID: <20010316063907.9936124D22@minya.sea.one-eyed-alien.net>
next in thread | raw e-mail | index | archive | help
>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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010316063907.9936124D22>