Bug 41253

Summary: config(8) and/or Handbook deficiency
Product: Documentation Reporter: rdm <rdm>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description rdm 2002-08-02 04:30:02 UTC 
	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!

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
How-To-Repeat: 
	Ask a newbie (or a rusty oldbie :-) to config a system...
Comment 1 Marc Fonvieille freebsd_committer freebsd_triage 2002-08-02 08:14:49 UTC 
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
Comment 2 Tom Rhodes freebsd_committer freebsd_triage 2002-08-26 19:13:19 UTC 
State Changed
From-To: open->closed

Our handbook covers this already, although most likly more explainatory than 
you would like, it does do it.
Comment 3 Giorgos Keramidas freebsd_committer freebsd_triage 2002-08-26 23:10:13 UTC 
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