From chris@holly.dyndns.org Sat Jun 12 21:43:49 1999
Return-Path: <chris@holly.dyndns.org>
Received: from leap.innerx.net (leap.innerx.net [38.179.176.25])
	by hub.freebsd.org (Postfix) with ESMTP id 6B67214D7B
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 12 Jun 1999 21:43:46 -0700 (PDT)
	(envelope-from chris@holly.dyndns.org)
Received: from holly.dyndns.org (ip135.houston13.tx.pub-ip.psi.net [38.27.213.135])
	by leap.innerx.net (Postfix) with ESMTP id BBCBF37075
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 13 Jun 1999 00:43:44 -0400 (EDT)
Received: (from chris@localhost)
	by holly.dyndns.org (8.9.3/8.9.3) id XAA05060;
	Sat, 12 Jun 1999 23:43:41 -0500 (CDT)
	(envelope-from chris)
Message-Id: <199906130443.XAA05060@holly.dyndns.org>
Date: Sat, 12 Jun 1999 23:43:41 -0500 (CDT)
From: chris@calldei.com
Sender: chris@holly.dyndns.org
Reply-To: chris@calldei.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: [Patch] doc/en/handbook/kernelconfig/chapter.sgml needs updating.
X-Send-Pr-Version: 3.2

>Number:         12181
>Category:       docs
>Synopsis:       [Patch] doc/en/handbook/kernelconfig/chapter.sgml needs updating.
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Jun 12 21:50:01 PDT 1999
>Closed-Date:    Tue Jul 27 11:19:41 PDT 1999
>Last-Modified:  Tue Jul 27 11:20:07 PDT 1999
>Originator:     Chris Costello
>Release:        FreeBSD 4.0-CURRENT i386
>Organization:
Zero.
>Environment:

$Id: chapter.sgml,v 1.16 1999/05/28 00:31:25 dwhite Exp $

>Description:

Modified kernel config sample lines to remove the quotes.
Fix where I probably put 'i386' instead of <replaceable>arch</replaceable>
Remove warning note about quote characters.

>How-To-Repeat:

View the relevant section of the handbook.

>Fix:

Index: chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en/handbook/kernelconfig/chapter.sgml,v
retrieving revision 1.16
diff -u -r1.16 chapter.sgml
--- chapter.sgml	1999/05/28 00:31:25	1.16
+++ chapter.sgml	1999/06/13 04:35:59
@@ -195,7 +195,7 @@
       
       <variablelist>
 	<varlistentry>
-	  <term><literal>machine "i386"</literal></term>
+	  <term><literal>machine <replaceable>arch</replaceable></literal></term>
 	  
 	  <listitem>
 	    <para>The first keyword is <literal>machine</literal>, which,
@@ -203,20 +203,12 @@
 	      DEC Alpha processors, will be either 
 	      <replaceable>i386</replaceable> or 
 	      <replaceable>alpha</replaceable>.</para>
-
-	    <note>
-	      <para>Any keyword which contains numbers used as text must be
-		enclosed in quotation marks, otherwise
-		<command>config</command> gets confused and thinks you mean
-		the actual number 386 if you enter 
-		<literal>machine i386</literal>.</para>
-	    </note>
 	  </listitem>
 	</varlistentry>
 	
 	<varlistentry>
 	  <term><literal>cpu
-	      "<replaceable>cpu_type</replaceable>"</literal></term>
+	      <replaceable>cpu_type</replaceable></literal></term>
 	  
 	  <listitem>
 	    <para>The next keyword is <literal>cpu</literal>, which includes
@@ -382,7 +374,7 @@
 	</varlistentry>
 	
 	<varlistentry>
-	  <term><literal>options "COMPAT_43"</literal></term>
+	  <term><literal>options COMPAT_43</literal></term>
 	  
 	  <listitem>
 	    <para>Compatibility with 4.3BSD.  Leave this in; some programs
@@ -501,7 +493,7 @@
 	</varlistentry>
 	
 	<varlistentry>
-	  <term><literal>options "CD9660"</literal></term>
+	  <term><literal>options CD9660</literal></term>
 	  
 	  <listitem>
 	    <para>ISO 9660 filesystem for CD-ROMs.  Comment it out if you do
@@ -557,7 +549,7 @@
 	</varlistentry>
 	
 	<varlistentry>
-	  <term><literal>options "EXT2FS"</literal></term>
+	  <term><literal>options EXT2FS</literal></term>
 	  
 	  <listitem>
 	    <para>Linux's native file system.  With ext2fs support you are
@@ -656,7 +648,7 @@
 	</varlistentry>
 	
 	<varlistentry>
-	  <term><literal>device npx0 at isa? port "IO_NPX" irq 13
+	  <term><literal>device npx0 at isa? port IO_NPX irq 13
 	      vector npxintr</literal></term>
 	  
 	  <listitem>
@@ -740,7 +732,7 @@
 	    
 	    <variablelist>
 	      <varlistentry>
-		<term><literal>controller bt0 at isa? port "IO_BT0" bio irq ?
+		<term><literal>controller bt0 at isa? port IO_BT0 bio irq ?
 		    vector btintr</literal></term>
 		
 		<listitem>
@@ -749,7 +741,7 @@
 	      </varlistentry>
 	      
 	      <varlistentry>
-		<term><literal>controller uha0 at isa? port "IO_UHA0" bio irq
+		<term><literal>controller uha0 at isa? port IO_UHA0 bio irq
 		    ? drq 5 vector uhaintr</literal></term>
 		
 		<listitem>
@@ -775,7 +767,7 @@
 	      </varlistentry>
 	      
 	      <varlistentry>
-		<term><literal>controller aha0    at isa? port "IO_AHA0" bio
+		<term><literal>controller aha0    at isa? port IO_AHA0 bio
 		    irq ? drq 5 vector ahaintr</literal></term>
 		
 		<listitem>
@@ -906,7 +898,7 @@
 	  
       <variablelist>
 	<varlistentry>
-	  <term><literal>device sc0 at isa? port "IO_KBD" tty irq 1 vector
+	  <term><literal>device sc0 at isa? port IO_KBD tty irq 1 vector
 	      scintr</literal></term>
 	  
 	  <listitem>
@@ -936,8 +928,8 @@
 	    <variablelist>
 	      <varlistentry>
 		<term><literal>options 
-		  "KBD_RESETDELAY=<replaceable>X</replaceable>", options 
-		  "KBD_MAXWAIT=<replaceable>Y</replaceable>"</literal></term>
+		  KBD_RESETDELAY=<replaceable>X</replaceable>, options 
+		  KBD_MAXWAIT=<replaceable>Y</replaceable></literal></term>
 
 		<listitem>
 		  <para>The keyboard driver <literal>atkbd</literal> and the
@@ -958,7 +950,7 @@
 
 	      <varlistentry>
 		<term><literal>options 
-		  "KBDIO_DEBUG=<replaceable>N</replaceable>"</literal></term>
+		  KBDIO_DEBUG=<replaceable>N</replaceable></literal></term>
 
 		<listitem>
 		  <para>Sets the debug level to <replaceable>N</replaceable>.
@@ -989,7 +981,7 @@
 	</varlistentry>
 
 	<varlistentry>
-	  <term><literal>device vt0 at isa? port "IO_KBD" tty irq 1 vector
+	  <term><literal>device vt0 at isa? port IO_KBD tty irq 1 vector
 	      pcrint</literal></term>
 	  
 	  <listitem>
@@ -1007,7 +999,7 @@
 		  
 	    <variablelist>
 	      <varlistentry>
-		<term><literal>options "PCVT_FREEBSD=210"</literal></term>
+		<term><literal>options PCVT_FREEBSD=210</literal></term>
 		
 		<listitem>
 		  <para>Required with the <literal>vt0</literal> console
@@ -1047,7 +1039,7 @@
 	</varlistentry>
 	
 	<varlistentry>
-	  <term><literal>device psm0 at isa? port "IO_KBD" conflicts tty irq
+	  <term><literal>device psm0 at isa? port IO_KBD conflicts tty irq
 	      12 vector psmintr</literal></term>
 	  
 	  <listitem>
@@ -1069,7 +1061,7 @@
 	  
       <variablelist>
 	<varlistentry>
-	  <term><literal>device sio0 at isa? port "IO_COM1" tty irq 4 vector
+	  <term><literal>device sio0 at isa? port IO_COM1 tty irq 4 vector
 	      siointr</literal><anchor
 	      id="kernelconfig-serial"></term>
 	  
@@ -1508,7 +1500,7 @@
 	
 	<varlistentry>
 	  <term><literal>device uart0 at isa? port 0x330 irq 5 vector
-	      "m6850intr"</literal></term>
+	      m6850intr</literal></term>
 	  
 	  <listitem>
 	    <para>Stand-alone 6850 UART for MIDI.</para>
@@ -1516,7 +1508,7 @@
 	</varlistentry>
 	
 	<varlistentry>
-	  <term><literal>device pca0 at isa? port "IO_TIMER1"
+	  <term><literal>device pca0 at isa? port IO_TIMER1
 	      tty</literal><anchor id="kernelconfig-pcaudio"></term>
 	  
 	  <listitem>
@@ -1654,7 +1646,7 @@
       
       <variablelist>
 	<varlistentry>
-	  <term><literal>device joy0 at isa? port "IO_GAME"</literal></term>
+	  <term><literal>device joy0 at isa? port IO_GAME</literal></term>
 
 	  <listitem>
 	    <para>PC joystick device.</para>

>Release-Note:
>Audit-Trail:

From: Chris Costello <chris@calldei.com>
To: FreeBSD-gnats-submit@FreeBSD.ORG
Cc:  
Subject: Re: docs/12181: [Patch] doc/en/handbook/kernelconfig/chapter.sgml needs updating.
Date: Sun, 13 Jun 1999 09:52:25 -0500

 On Sat, Jun 12, 1999, chris@calldei.com wrote:
 > >Number:         12181
 > >Category:       docs
 > >Synopsis:       [Patch] doc/en/handbook/kernelconfig/chapter.sgml needs updating.
 > >Confidential:   no
 > >Severity:       serious
 > >Priority:       medium
 > >Responsible:    freebsd-doc
 > >State:          open
 
 > 
 > $Id: chapter.sgml,v 1.16 1999/05/28 00:31:25 dwhite Exp $
 > 
 > >Description:
 > 
 > Modified kernel config sample lines to remove the quotes.
 > Fix where I probably put 'i386' instead of <replaceable>arch</replaceable>
 > Remove warning note about quote characters.
 
 Also, change <literal>GENERIC</literal> to
 <filename>GENERIC</filename.  Add <filename></filename> around
 'GENERIC' where necessary.
 
 > 
 > >How-To-Repeat:
 > 
 > View the relevant section of the handbook.
 > 
 > >Fix:
 
    I missed a couple things.  The following fix should be used:
 
 Index: chapter.sgml
 ===================================================================
 RCS file: /home/ncvs/doc/en/handbook/kernelconfig/chapter.sgml,v
 retrieving revision 1.16
 diff -u -r1.16 chapter.sgml
 --- chapter.sgml	1999/05/28 00:31:25	1.16
 +++ chapter.sgml	1999/06/13 14:49:51
 @@ -21,7 +21,7 @@
      <para>Building a custom kernel is one of the most important rites of
        passage every Unix system administrator must endure.  This process,
        while time-consuming, will provide many benefits to your FreeBSD system.
 -      Unlike the <literal>GENERIC</literal> kernel, which must support every
 +      Unlike the <filename>GENERIC</filename> kernel, which must support every
        possible SCSI and network card, along with tons of other rarely used
        hardware support, a custom kernel only contains support for
        <emphasis>your</emphasis> PC's hardware.  This has a number of
 @@ -46,7 +46,8 @@
  	<para>Finally, there are several kernel options which you can tune to
  	  fit your needs, and device driver support for things like sound
  	  cards which you can include in your kernel but are
 -	  <emphasis>not</emphasis> present in the GENERIC kernel.</para>
 +	  <emphasis>not</emphasis> present in the <filename>GENERIC</filename>
 +	   kernel.</para>
        </listitem>
      </itemizedlist>
    </sect1>
 @@ -195,7 +196,7 @@
        
        <variablelist>
  	<varlistentry>
 -	  <term><literal>machine "i386"</literal></term>
 +	  <term><literal>machine <replaceable>arch</replaceable></literal></term>
  	  
  	  <listitem>
  	    <para>The first keyword is <literal>machine</literal>, which,
 @@ -203,20 +204,12 @@
  	      DEC Alpha processors, will be either 
  	      <replaceable>i386</replaceable> or 
  	      <replaceable>alpha</replaceable>.</para>
 -
 -	    <note>
 -	      <para>Any keyword which contains numbers used as text must be
 -		enclosed in quotation marks, otherwise
 -		<command>config</command> gets confused and thinks you mean
 -		the actual number 386 if you enter 
 -		<literal>machine i386</literal>.</para>
 -	    </note>
  	  </listitem>
  	</varlistentry>
  	
  	<varlistentry>
  	  <term><literal>cpu
 -	      "<replaceable>cpu_type</replaceable>"</literal></term>
 +	      <replaceable>cpu_type</replaceable></literal></term>
  	  
  	  <listitem>
  	    <para>The next keyword is <literal>cpu</literal>, which includes
 @@ -382,7 +375,7 @@
  	</varlistentry>
  	
  	<varlistentry>
 -	  <term><literal>options "COMPAT_43"</literal></term>
 +	  <term><literal>options COMPAT_43</literal></term>
  	  
  	  <listitem>
  	    <para>Compatibility with 4.3BSD.  Leave this in; some programs
 @@ -501,7 +494,7 @@
  	</varlistentry>
  	
  	<varlistentry>
 -	  <term><literal>options "CD9660"</literal></term>
 +	  <term><literal>options CD9660</literal></term>
  	  
  	  <listitem>
  	    <para>ISO 9660 filesystem for CD-ROMs.  Comment it out if you do
 @@ -557,7 +550,7 @@
  	</varlistentry>
  	
  	<varlistentry>
 -	  <term><literal>options "EXT2FS"</literal></term>
 +	  <term><literal>options EXT2FS</literal></term>
  	  
  	  <listitem>
  	    <para>Linux's native file system.  With ext2fs support you are
 @@ -656,7 +649,7 @@
  	</varlistentry>
  	
  	<varlistentry>
 -	  <term><literal>device npx0 at isa? port "IO_NPX" irq 13
 +	  <term><literal>device npx0 at isa? port IO_NPX irq 13
  	      vector npxintr</literal></term>
  	  
  	  <listitem>
 @@ -740,7 +733,7 @@
  	    
  	    <variablelist>
  	      <varlistentry>
 -		<term><literal>controller bt0 at isa? port "IO_BT0" bio irq ?
 +		<term><literal>controller bt0 at isa? port IO_BT0 bio irq ?
  		    vector btintr</literal></term>
  		
  		<listitem>
 @@ -749,7 +742,7 @@
  	      </varlistentry>
  	      
  	      <varlistentry>
 -		<term><literal>controller uha0 at isa? port "IO_UHA0" bio irq
 +		<term><literal>controller uha0 at isa? port IO_UHA0 bio irq
  		    ? drq 5 vector uhaintr</literal></term>
  		
  		<listitem>
 @@ -775,7 +768,7 @@
  	      </varlistentry>
  	      
  	      <varlistentry>
 -		<term><literal>controller aha0    at isa? port "IO_AHA0" bio
 +		<term><literal>controller aha0    at isa? port IO_AHA0 bio
  		    irq ? drq 5 vector ahaintr</literal></term>
  		
  		<listitem>
 @@ -906,7 +899,7 @@
  	  
        <variablelist>
  	<varlistentry>
 -	  <term><literal>device sc0 at isa? port "IO_KBD" tty irq 1 vector
 +	  <term><literal>device sc0 at isa? port IO_KBD tty irq 1 vector
  	      scintr</literal></term>
  	  
  	  <listitem>
 @@ -936,8 +929,8 @@
  	    <variablelist>
  	      <varlistentry>
  		<term><literal>options 
 -		  "KBD_RESETDELAY=<replaceable>X</replaceable>", options 
 -		  "KBD_MAXWAIT=<replaceable>Y</replaceable>"</literal></term>
 +		  KBD_RESETDELAY=<replaceable>X</replaceable>, options 
 +		  KBD_MAXWAIT=<replaceable>Y</replaceable></literal></term>
  
  		<listitem>
  		  <para>The keyboard driver <literal>atkbd</literal> and the
 @@ -958,7 +951,7 @@
  
  	      <varlistentry>
  		<term><literal>options 
 -		  "KBDIO_DEBUG=<replaceable>N</replaceable>"</literal></term>
 +		  KBDIO_DEBUG=<replaceable>N</replaceable></literal></term>
  
  		<listitem>
  		  <para>Sets the debug level to <replaceable>N</replaceable>.
 @@ -989,7 +982,7 @@
  	</varlistentry>
  
  	<varlistentry>
 -	  <term><literal>device vt0 at isa? port "IO_KBD" tty irq 1 vector
 +	  <term><literal>device vt0 at isa? port IO_KBD tty irq 1 vector
  	      pcrint</literal></term>
  	  
  	  <listitem>
 @@ -1007,7 +1000,7 @@
  		  
  	    <variablelist>
  	      <varlistentry>
 -		<term><literal>options "PCVT_FREEBSD=210"</literal></term>
 +		<term><literal>options PCVT_FREEBSD=210</literal></term>
  		
  		<listitem>
  		  <para>Required with the <literal>vt0</literal> console
 @@ -1047,7 +1040,7 @@
  	</varlistentry>
  	
  	<varlistentry>
 -	  <term><literal>device psm0 at isa? port "IO_KBD" conflicts tty irq
 +	  <term><literal>device psm0 at isa? port IO_KBD conflicts tty irq
  	      12 vector psmintr</literal></term>
  	  
  	  <listitem>
 @@ -1069,7 +1062,7 @@
  	  
        <variablelist>
  	<varlistentry>
 -	  <term><literal>device sio0 at isa? port "IO_COM1" tty irq 4 vector
 +	  <term><literal>device sio0 at isa? port IO_COM1 tty irq 4 vector
  	      siointr</literal><anchor
  	      id="kernelconfig-serial"></term>
  	  
 @@ -1403,9 +1396,10 @@
  	  <title>Sound cards</title>
        
        <para>This is the first section containing lines that are not in the
 -	GENERIC kernel.  To include sound card support, you will have to copy
 -	the appropriate lines from the LINT kernel (which contains support for
 -	<emphasis>every</emphasis> device) as follows:</para>
 +	<filename>GENERIC</filename> kernel.  To include sound card support,
 +	you will have to copy the appropriate lines from the LINT kernel
 +	(which contains support for <emphasis>every</emphasis> device) as
 +	follows:</para>
  	  
        
        <variablelist>
 @@ -1508,7 +1502,7 @@
  	
  	<varlistentry>
  	  <term><literal>device uart0 at isa? port 0x330 irq 5 vector
 -	      "m6850intr"</literal></term>
 +	      m6850intr</literal></term>
  	  
  	  <listitem>
  	    <para>Stand-alone 6850 UART for MIDI.</para>
 @@ -1516,7 +1510,7 @@
  	</varlistentry>
  	
  	<varlistentry>
 -	  <term><literal>device pca0 at isa? port "IO_TIMER1"
 +	  <term><literal>device pca0 at isa? port IO_TIMER1
  	      tty</literal><anchor id="kernelconfig-pcaudio"></term>
  	  
  	  <listitem>
 @@ -1654,7 +1648,7 @@
        
        <variablelist>
  	<varlistentry>
 -	  <term><literal>device joy0 at isa? port "IO_GAME"</literal></term>
 +	  <term><literal>device joy0 at isa? port IO_GAME</literal></term>
  
  	  <listitem>
  	    <para>PC joystick device.</para>
 
 -- 
 Chris Costello                                <chris@calldei.com>
 Revolutionary:  Disk drives go round and round.
 

From: Nik Clayton <nik@nothing-going-on.demon.co.uk>
To: chris@calldei.com
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/12181: [Patch] doc/en/handbook/kernelconfig/chapter.sgml needs updating.
Date: Sun, 13 Jun 1999 17:04:07 +0100

 Chris,
 
 On Sat, Jun 12, 1999 at 11:43:41PM -0500, chris@calldei.com wrote:
 > Modified kernel config sample lines to remove the quotes.
 
 It looks like your system is more current than mine, as mine still needs
 the quotes!
 
 Can you redo this patch slightly?  Probably leave the examples without
 the quotes, but include a brief section explaining when the quotes were
 removed, and what to do if you're building on a system that still 
 requires the quotes.  Possibly include the error message you get if you
 need the quotes included, but haven't included them?
 
 Cheers,
 
 N
 -- 
  [intentional self-reference] can be easily accommodated using a blessed,
  non-self-referential dummy head-node whose own object destructor severs
  the links.
     -- Tom Christiansen in <375143b5@cs.colorado.edu>
 

From: Chris Costello <chris@calldei.com>
To: Nik Clayton <nik@nothing-going-on.demon.co.uk>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/12181: [Patch] doc/en/handbook/kernelconfig/chapter.sgml needs updating.
Date: Sun, 13 Jun 1999 16:12:25 -0500

 On Sun, Jun 13, 1999, Nik Clayton wrote:
 > Can you redo this patch slightly?  Probably leave the examples without
 > the quotes, but include a brief section explaining when the quotes were
 > removed, and what to do if you're building on a system that still 
 > requires the quotes.  Possibly include the error message you get if you
 > need the quotes included, but haven't included them?
 
    What does that error message look like?
 
 > 
 > Cheers,
 > 
 > N
 > -- 
 >  [intentional self-reference] can be easily accommodated using a blessed,
 >  non-self-referential dummy head-node whose own object destructor severs
 >  the links.
 >     -- Tom Christiansen in <375143b5@cs.colorado.edu>
 
 -- 
 Chris Costello                                <chris@calldei.com>
 A bad random number generator:  1, 1, 1, 1, 1, 4.33e+67, 1, 1, 1
 

From: John Baldwin <jobaldwi@vt.edu>
To: Chris Costello <chris@calldei.com>
Cc: freebsd-doc@freebsd.org, FreeBSD-gnats-submit@freebsd.org,
	Nik Clayton <nik@nothing-going-on.demon.co.uk>
Subject: Re: docs/12181: [Patch] doc/en/handbook/kernelconfig/chapter.sgm
Date: Tue, 15 Jun 1999 18:23:17 -0400 (EDT)

 On 13-Jun-99 Chris Costello wrote:
 > The following reply was made to PR docs/12181; it has been noted by GNATS.
 > 
 > From: Chris Costello <chris@calldei.com>
 > To: Nik Clayton <nik@nothing-going-on.demon.co.uk>
 > Cc: FreeBSD-gnats-submit@freebsd.org
 > Subject: Re: docs/12181: [Patch] doc/en/handbook/kernelconfig/chapter.sgml
 > needs updating.
 > Date: Sun, 13 Jun 1999 16:12:25 -0500
 > 
 >  On Sun, Jun 13, 1999, Nik Clayton wrote:
 >  > Can you redo this patch slightly?  Probably leave the examples without
 >  > the quotes, but include a brief section explaining when the quotes were
 >  > removed, and what to do if you're building on a system that still 
 >  > requires the quotes.  Possibly include the error message you get if you
 >  > need the quotes included, but haven't included them?
 >  
 >     What does that error message look like?
 
 The update to config(8) that made quotes optional was only applied to -current.
 Since the handbook is geared towards -stable and -release users, we probably
 should keep that paragraph in for now, IMHO.
 
 ---
 
 John Baldwin <jobaldwi@vt.edu> -- http://members.freedomnet.com/~jbaldwin/
 PGP Key: http://members.freedomnet.com/~jbaldwin/pgpkey.asc
 "Power Users Use the Power to Serve!"  -  http://www.freebsd.org
 

From: Chris Costello <chris@calldei.com>
To: freebsd-gnats-submit@freebsd.org
Cc:  
Subject: Re: docs/12181
Date: Thu, 1 Jul 1999 00:27:44 -0500

    This patch should deal with the quotes problem.
 
 Index: chapter.sgml
 ===================================================================
 RCS file: /home/ncvs/doc/en/handbook/kernelconfig/chapter.sgml,v
 retrieving revision 1.16
 diff -u -r1.16 chapter.sgml
 --- chapter.sgml	1999/05/28 00:31:25	1.16
 +++ chapter.sgml	1999/07/01 05:26:13
 @@ -21,7 +21,7 @@
      <para>Building a custom kernel is one of the most important rites of
        passage every Unix system administrator must endure.  This process,
        while time-consuming, will provide many benefits to your FreeBSD system.
 -      Unlike the <literal>GENERIC</literal> kernel, which must support every
 +      Unlike the <filename>GENERIC</filename> kernel, which must support every
        possible SCSI and network card, along with tons of other rarely used
        hardware support, a custom kernel only contains support for
        <emphasis>your</emphasis> PC's hardware.  This has a number of
 @@ -195,7 +195,8 @@
        
        <variablelist>
  	<varlistentry>
 -	  <term><literal>machine "i386"</literal></term>
 +	  <term><literal>machine <replaceable>arch</replaceable></literal>
 +	  </term>
  	  
  	  <listitem>
  	    <para>The first keyword is <literal>machine</literal>, which,
 @@ -272,19 +273,19 @@
  	  <listitem>
  	    <para>Next, we have <literal>ident</literal>, which is the
  	      identification of the kernel.  You should change this from
 -	      <literal>GENERIC</literal> to whatever you named your kernel, in
 -	      this example, <literal>MYKERNEL</literal>.  The value you put in
 +	      <filename>GENERIC</filename> to whatever you named your kernel, in
 +	      this example, <filename>MYKERNEL</filename>.  The value you put in
  	      <literal>ident</literal> will print when you boot up the kernel,
  	      so it is useful to give a kernel a different name if you want to
  	      keep it separate from your usual kernel (if you want to build an
  	      experimental kernel, for example).  Note that, as with
 -	      <literal>machine</literal> and <literal> cpu</literal>, enclose
 +	      <literal>machine</literal> and <literal>cpu</literal>, enclose
  	      your kernel's name in quotation marks if it contains any
  	      numbers.</para>
  		  
  	    <para>Since this name is passed to the C compiler as a
  	      <option>-D</option> switch, do not use names like
 -	      <literal>DEBUG</literal>, or something that could be confused
 +	      <filename>DEBUG</filename>, or something that could be confused
  	      with another machine or CPU name, like
  	      <literal>vax</literal>.</para>
  	  </listitem>
 @@ -870,7 +871,7 @@
  	</varlistentry>
  	
  	<varlistentry>
 -	  <term><literal>device st0</literal></term>
 +	  <term><literal>device sa0</literal></term>
  	  
  	  <listitem>
  	    <para>Support for SCSI tape drives.</para>
 @@ -1403,9 +1404,9 @@
  	  <title>Sound cards</title>
        
        <para>This is the first section containing lines that are not in the
 -	GENERIC kernel.  To include sound card support, you will have to copy
 -	the appropriate lines from the LINT kernel (which contains support for
 -	<emphasis>every</emphasis> device) as follows:</para>
 +	<filename>GENERIC</filename> kernel.  To include sound card support, you
 +	will have to copy the appropriate lines from the LINT kernel (which
 +	support for <emphasis>every</emphasis> device) as follows:</para>
  	  
        
        <variablelist>
 -- 
 Chris Costello                                <chris@calldei.com>
 If at first you don't succeed, call it version 1.0
 
State-Changed-From-To: open->closed 
State-Changed-By: nik 
State-Changed-When: Tue Jul 27 11:19:41 PDT 1999 
State-Changed-Why:  
Committed, thanks. 
>Unformatted:
