From azrael@coyotesdaughter.com  Fri Oct 16 18:48:56 1998
Received: from coyotesdaughter.com (navajo.coyotesdaughter.com [199.181.141.71])
          by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id SAA08616
          for <FreeBSD-gnats-submit@freebsd.org>; Fri, 16 Oct 1998 18:48:51 -0700 (PDT)
          (envelope-from azrael@coyotesdaughter.com)
Received: (from azrael@localhost)
	by coyotesdaughter.com (8.8.8/8.8.8) id VAA10164;
	Fri, 16 Oct 1998 21:48:26 -0400 (EDT)
	(envelope-from azrael)
Message-Id: <199810170148.VAA10164@coyotesdaughter.com>
Date: Fri, 16 Oct 1998 21:48:26 -0400 (EDT)
From: Azrael Coyotesdaughter <azrael@coyotesdaughter.com>
Reply-To: azrael@coyotesdaughter.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: documentation error / misleading wording in handbook
X-Send-Pr-Version: 3.2

>Number:         8351
>Category:       docs
>Synopsis:       documentation error / misleading wording in handbook
>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 Oct 16 18:50:00 PDT 1998
>Closed-Date:    Sun Dec 13 14:59:43 PST 1998
>Last-Modified:  Sun Dec 13 15:00:30 PST 1998
>Originator:     Azrael Coyotesdaughter
>Release:        FreeBSD 2.2.7-RELEASE i386
>Organization:
Evil Geniuses for a Better Tomarrow
>Environment:

	

>Description:

Okay.  It started as my fault.  I confess; I did something stupid, and my 
/usr/src/sys directory went away.  Poof.  But, since I was planning to get
to building a custom kernel this coming week, I figured it would probably
be a good idea to get it back.  So I went to:

http://www.freebsd.org/handbook/handbook39.html#41

And got the helpful advice:

Note: If there is not a /usr/src/sys directory on your system, then the kernel
source has not been been installed. Follow the instructions for installing 
packages to add this package to your system. 

Cool, I thought, it's a package.  I can add packages, that's something I've
already mastered.  Woo!  Hoo!  So I bopped on over to ftp2.freebsd.org, and
looked in the /pub/FreeBSD/2.2.7-RELEASE/packages/All directory, and... hmm.
There didn't seem to be anything helpfully labeled 'kernal source' or 'system
source', or.. well, /anything/ source.

To make a long story short, I zipped around the site, looking, and couldn't
find it.  So I posted a message to the discussion group, and found out that,
in fact, it's /not/ a package, and can't be pckg_add'd.  

So... 

>How-To-Repeat:

Delete your /usr/src/sys directory recursively.  Don't ask why, just do it.
(Hey!  I /said/ it was user error!)  Then try and follow the instructions in
the handbook. 


>Fix:
	
Hmm.  Well, correcting the handbook page comes to mind.  Where /are/ the 
kernel sources, and how /do/ I install them, if they're not a package?
Alternatly, you could make a package with the kernel sources.
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: steve 
State-Changed-When: Sun Dec 13 14:59:43 PST 1998 
State-Changed-Why:  
See PR #8361 for a patch to the docs that explains how this is done. 
>Unformatted:
