docs/78486: [patch] Handbook: Update kernel configuration section (8.4)

[Joel Dahl]

>Number:         78486
>Category:       docs
>Synopsis:       [patch] Handbook: Update kernel configuration section (8.4)
>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:   Sun Mar 06 12:10:02 GMT 2005
>Closed-Date:
>Last-Modified:
>Originator:     Joel Dahl
>Release:        FreeBSD 5.4-PRERELEASE i386
>Organization:
>Environment:
System: FreeBSD dude.automatvapen.se 5.4-PRERELEASE FreeBSD 5.4-PRERELEASE #0: Sat Mar 5 10:23:17 CET 2005 joel at dude.automatvapen.se:/usr/obj/usr/src/sys/GENERIC i386


	
>Description:
The kernel configuration should reflect 5.4, check the attached
patch.

Two small notes:
1.  I'm not sure what to do with "maxusers n".  It's not part of
    GENERIC in 5.4.

2.  I really hate the current structure of section 8.4.  It's
    confusing, since it mentions mandatory options first, followed
    by "optional" things.  I would like to restructure it and sort
    all options in proper order, as they appear in GENERIC.  A new
    user should be able to compare his version of GENERIC, line by
    line, with the examples in the kernel configuration chapter,
    without jumping up and down in the text.
	

>How-To-Repeat:
	
>Fix:
	

--- kernconf.diff begins here ---
Index: chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.sgml,v
retrieving revision 1.154
diff -u -r1.154 chapter.sgml
--- chapter.sgml	13 Feb 2005 10:24:08 -0000	1.154
+++ chapter.sgml	6 Mar 2005 11:25:17 -0000
@@ -724,6 +724,18 @@
     <para>This is the basic hard drive file system.  Leave it in if you
       boot from the hard disk.</para>
 
+    <programlisting>options          SOFTUPDATES       # Enable FFS Soft Updates support</programlisting>
+
+    <para>This option enables Soft Updates in the kernel, this will
+      help speed up write access on the disks.  Even when this
+      functionality is provided by the kernel, it must be turned on
+      for specific disks.  Review the output from &man.mount.8; to see
+      if Soft Updates is enabled for your system disks.  If you do not
+      see the <literal>soft-updates</literal> option then you will
+      need to activate it using the &man.tunefs.8; (for existing
+      file systems) or &man.newfs.8; (for new file systems)
+      commands.</para>
+
     <programlisting>options          UFS_ACL           # Support for access control lists</programlisting>
 
     <para>This option, present only in &os; 5.X, enables kernel support
@@ -744,18 +756,6 @@
       using &os; on a smaller system where memory is at a premium and
       disk access speed is less important, such as a firewall.</para>
 
-    <programlisting>options          SOFTUPDATES       # Enable FFS Soft Updates support</programlisting>
-
-    <para>This option enables Soft Updates in the kernel, this will
-      help speed up write access on the disks.  Even when this
-      functionality is provided by the kernel, it must be turned on
-      for specific disks.  Review the output from &man.mount.8; to see
-      if Soft Updates is enabled for your system disks.  If you do not
-      see the <literal>soft-updates</literal> option then you will
-      need to activate it using the &man.tunefs.8; (for existing
-      file systems) or &man.newfs.8; (for new file systems)
-      commands.</para>
-
     <programlisting>options          MD_ROOT           # MD is a potential root device</programlisting>
 
     <para>This option enables support for a memory backed virtual disk
@@ -1229,12 +1229,12 @@
       including a generic one for PHYs that are not specifically handled
       by an individual driver.</para>
 
-    <programlisting>device          dc         # DEC/Intel 21143 and various workalikes
-device          miibus     # MII bus support
-device          bfe        # Broadcom BCM440x 10/100 Ethernet
+    <programlisting>device          bfe        # Broadcom BCM440x 10/100 Ethernet
 device          bge        # Broadcom BCM570xx Gigabit Ethernet
 device          dc         # DEC/Intel 21143 and various workalikes
 device          fxp        # Intel EtherExpress PRO/100B (82557, 82558)
+device          lge        # Level 1 LXT1001 gigabit ethernet
+device          nge        # NatSemi DP83820 gigabit ethernet
 device          pcn        # AMD Am79C97x PCI 10/100 (precedence over 'lnc')
 device          re         # RealTek 8139C+/8169/8169S/8110S
 device          rl         # RealTek 8129/8139
@@ -1245,6 +1245,7 @@
 device          ti         # Alteon Networks Tigon I/II gigabit Ethernet
 device          tl         # Texas Instruments ThunderLAN
 device          tx         # SMC EtherPower II (83c170 <quote>EPIC</quote>)
+device          vge        # VIA VT612x gigabit ethernet
 device          vr         # VIA Rhine, Rhine II
 device          wb         # Winbond W89C840F
 device          xl         # 3Com 3c90x (<quote>Boomerang</quote>, <quote>Cyclone</quote>)</programlisting>
--- kernconf.diff ends here ---

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