From rdm@cfcl.com  Thu Aug  1 20:28:44 2002
Return-Path: <rdm@cfcl.com>
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
Subject: config(8) and/or Handbook deficiency
X-Send-Pr-Version: 3.2

>Number:         41253
>Category:       docs
>Synopsis:       config(8) and/or Handbook deficiency
>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:   Thu Aug 01 20:30:02 PDT 2002
>Closed-Date:    Mon Aug 26 11:14:13 PDT 2002
>Last-Modified:  Mon Aug 26 15:20:01 PDT 2002
>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:

From: Marc Fonvieille <blackend@FreeBSD.org>
To: Rich Morin <rdm@cfcl.com>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/41253: config(8) and/or Handbook deficiency
Date: Fri, 2 Aug 2002 09:14:49 +0200

 On Thu, Aug 01, 2002 at 08:28:29PM -0700, Rich Morin wrote:
 > 
 > >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
 
 http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig-building.htm
 does that already.
 
 Marc
State-Changed-From-To: open->closed 
State-Changed-By: trhodes 
State-Changed-When: Mon Aug 26 11:13:19 PDT 2002 
State-Changed-Why:  
Our handbook covers this already, although most likly more explainatory than 
you would like, it does do it. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=41253 

From: Giorgos Keramidas <keramida@FreeBSD.org>
To: Tom Rhodes <trhodes@FreeBSD.org>
Cc: rdm@cfcl.com, bug-followup@FreeBSD.org
Subject: Re: docs/41253: config(8) and/or Handbook deficiency
Date: Tue, 27 Aug 2002 01:10:13 +0300

 On 2002-08-26 11:14 +0000, Tom Rhodes wrote:
 > Our handbook covers this already, although most likly more
 > explainatory than you would like, it does do it.
 
 And there's always a quick, cookbook style, reference for common
 things that administrators do to their systems with the FreeBSD
 source at /usr/src/UPDATING.
 
 -- 
 FreeBSD: The Power to Serve -- http://www.FreeBSD.org
>Unformatted:
