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 ; 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 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: