docs/150124: Request for update of "building the kernel" section of the handbook

[Jared]

>Number:         150124
>Category:       docs
>Synopsis:       Request for update of "building the kernel" section of the handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Mon Aug 30 17:00:06 UTC 2010
>Closed-Date:
>Last-Modified:
>Originator:     Jared
>Release:        i386 8.1-REL
>Organization:
>Environment:
(sorry I don't have this handy, but I don't think it's necessary)
>Description:
I'm having difficulty building and installing a new kernel while following the handbook:

http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig-building.html

it appears that this page especially is out of date.  It only mentions the requirement of ssys and sbase distribution sets, but much googling (as I run into each problem) suggests that more sets of sources are necessary.  I eventually installed them all, because I don't know which are necessary.  Another page that could use some help is the description of the configuration file:

http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig-config.html

as it no longer matches the config file in i386 very closely.

I (and probably many others) would appreciate if these pages were corrected.  Pretty please? :)

Much thanks for all that you do!
>How-To-Repeat:
Try building a kernel whilst following the page.  You will not succeed due to lack of additional source code sets.
>Fix:
I installed all the sources and it satisfied all requirements.  Surely not every set is necessary for a vanilla compile (I was just adding sound support and removing support for hardware i don't have).

>Release-Note:
>Audit-Trail:
>Unformatted: