Restructure section 8.4 in the Handbook

[Joel Dahl]

All,

I'm not very fond of the current structure of section 8.4 in the
handbook.  It's confusing, especially for new users, since it mentions
some mandatory options before the "optional" things.  I would like to
restructure it a bit, and sort all options in proper order.  A new user
should be able to compare GENERIC with the examples in section 8.4,
line by line, without having to jump up and down in the text.

I'm also considering adding a small section (8.4.2) that explains a few
interesting options that's _not_ listed in GENERIC, for example,
debugging options, sound options, PREEMPTION, etc. This is just in my
head yet though.

A small patch is attached, which rearranges things in section 8.4, and
removes a few things that's not part of GENERIC in 5.4.  My personal
opinion is that this makes the whole section much easier to read and
understand.

Comments?

--
Joel
-------------- next part --------------
A non-text attachment was scrubbed...
Name: res_kernconf.diff
Type: text/x-patch
Size: 9797 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20050315/78107752/attachment.bin>