From owner-freebsd-doc  Thu Aug  1 20:30:11 2002
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 9559B37B401
	for <freebsd-doc@hub.freebsd.org>; Thu,  1 Aug 2002 20:30:03 -0700 (PDT)
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 9349943E81
	for <freebsd-doc@hub.freebsd.org>; Thu,  1 Aug 2002 20:30:02 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.12.4/8.12.4) with ESMTP id g723U2JU014843
	for <freebsd-doc@freefall.freebsd.org>; Thu, 1 Aug 2002 20:30:02 -0700 (PDT)
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.12.4/8.12.4/Submit) id g723U2GS014842;
	Thu, 1 Aug 2002 20:30:02 -0700 (PDT)
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 4DF7437B400
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  1 Aug 2002 20:28:44 -0700 (PDT)
Received: from cfcl.com (cpe-24-221-169-54.ca.sprintbbd.net [24.221.169.54])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 29A9043E6E
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  1 Aug 2002 20:28:43 -0700 (PDT)
	(envelope-from rdm@cfcl.com)
Received: (from rdm@localhost)
	by cfcl.com (8.11.6/8.11.1) id g723STh39942;
	Thu, 1 Aug 2002 20:28:29 -0700 (PDT)
	(envelope-from rdm)
Message-Id: <200208020328.g723STh39942@cfcl.com>
Date: Thu, 1 Aug 2002 20:28:29 -0700 (PDT)
From: Rich Morin <rdm@cfcl.com>
Reply-To: rdm@cfcl.com
To: FreeBSD-gnats-submit@FreeBSD.org
X-Send-Pr-Version: 3.2
Subject: docs/41253: config(8) and/or Handbook deficiency
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


>Number:         41253
>Category:       docs
>Synopsis:       config(8) and/or Handbook deficiency
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Aug 01 20:30:02 PDT 2002
>Closed-Date:
>Last-Modified:
>Originator:     Rich Morin
>Release:        FreeBSD 4.5-RELEASE i386
>Organization:
Canta Forda Computer Laboratory
>Environment:

        FreeBSD cfcl.com 4.5-RELEASE FreeBSD 4.5-RELEASE #0:
        Mon Jan 28 14:31:56 GMT 2002
        murray@builder.freebsdmall.com:/usr/src/sys/compile/GENERIC  i386

>Description:

	For the first time since I started using FreeBSD, several
	years ago, I found myself needing to configure the kernel.
	So, to refresh my memory, I did a "man config".  It told
	me a few useful things, then referred me to the FreeBSD
	Handbook, which told me some more.

	Nowhere in all of this, however, was there a simple and
	complete recipe for configuring a new kernel!

>How-To-Repeat:

	Ask a newbie (or a rusty oldbie :-) to config a system...

>Fix:

	Add a page to the Handbook, giving a complete rundown on
	building a new kernel, including an annotated version of
	something like:

	  # cd /sys/i386/conf
	  # cp GENERIC <some_name>
	  # vi <some_name>
	  ...
	  # config <some_name>
	  # cd ../../compile/<some_name>
	  # make depend
	  # make       
	  # make install
>Release-Note:
>Audit-Trail:
>Unformatted:

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