From owner-doc-jp@jp.freebsd.org  Sat Sep 11 20:03:49 1999
Received: (from daemon@localhost)
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) id UAA97867;
	Sat, 11 Sep 1999 20:03:49 +0900 (JST)
	(envelope-from owner-doc-jp@jp.FreeBSD.org)
Received: from mail.kt.rim.or.jp (root@mail.kt.rim.or.jp [202.247.130.53])
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) with ESMTP id UAA97859
	for <doc-jp@jp.freebsd.org>; Sat, 11 Sep 1999 20:03:49 +0900 (JST)
	(envelope-from kuriyama@sky.rim.or.jp)
Received: from rhea.sky.rim.or.jp (ppp512.kt.rim.or.jp [202.247.140.162])
	by mail.kt.rim.or.jp (8.8.8/3.6W-RIMNET-98-06-09) with ESMTP id UAA24790
	for <doc-jp@jp.freebsd.org>; Sat, 11 Sep 1999 20:03:46 +0900 (JST)
Received: from localhost.sky.rim.or.jp (localhost [127.0.0.1])
	by rhea.sky.rim.or.jp (8.9.3/3.7W/rhea-1.1) with ESMTP id UAA25225
	for <doc-jp@jp.freebsd.org>; Sat, 11 Sep 1999 20:03:44 +0900 (JST)
Date: Sat, 11 Sep 1999 20:03:41 +0900
Message-ID: <14298.14093.784773.61791G@localhost.sky.rim.or.jp>
From: Jun Kuriyama <kuriyama@sky.rim.or.jp>
To: Japanese Documentation Project <doc-jp@jp.freebsd.org>
User-Agent: Wanderlust/1.0.3 (Notorious) SEMI/1.13.3 (Komaiko) FLIM/1.12.5 (Hirahata) MULE XEmacs/20.4 (Emerald) (i386--freebsd)
MIME-Version: 1.0 (generated by SEMI 1.13.3 - "Komaiko")
Content-Type: text/plain; charset=ISO-2022-JP
Reply-To: doc-jp@jp.freebsd.org
Precedence: list
X-Distribute: distribute version 2.1 (Alpha) patchlevel 24e+990727
X-Sequence: doc-jp 6650
Subject: [doc-jp 6650] <handbook> kernelconfig/chapter.sgml (1.17)
Errors-To: owner-doc-jp@jp.freebsd.org
Sender: owner-doc-jp@jp.freebsd.org
X-Originator: kuriyama@sky.rim.or.jp


$B!!(B<important>...</important> $B$NItJ,$NLu$r$*4j$$$7$^$9!#8e$O$I$&$K$G$b$J(B
$B$k!#(B


Index: chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO_8859-1/books/handbook/kernelconfig/chapter.sgml,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- chapter.sgml	1999/05/28 00:31:25	1.16
+++ chapter.sgml	1999/07/27 18:20:11	1.17
@@ -1,7 +1,7 @@
 <!--
      The FreeBSD Documentation Project
 
-     $Id: chapter.sgml,v 1.15 1999/05/16 13:29:08 nik Exp $
+     $Id: chapter.sgml,v 1.16 1999/05/28 00:31:25 dwhite Exp $
 -->
 
 <chapter id="kernelconfig">
@@ -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
@@ -188,6 +188,26 @@
       with <emphasis>arch</emphasis> being for example
       <filename>i386</filename>.</para>
 
+    <important>
+      <title>Quoting numbers</title>
+
+      <para>In all versions of FreeBSD up to and including 3-stable,
+	  &man.config.8; required that any strings in the configuration file
+	that contained numbers used as text had to be enclosed in double
+	quotes.</para>
+
+      <para>Where numbers are used as numbers, as in <literal>maxusers
+	  64</literal>, the quotation marks are <emphasis>not</emphasis>
+	required.</para>
+
+      <para>This requirement was removed in FreeBSD-current (the 4.0 release
+	candidate).</para>
+
+      <para>The examples here include the quote marks (<literal>"</literal>).
+	If you are building a kernel on a -current system you should omit
+	them.</para>
+    </important>
+
     <sect2>
       <title>Mandatory Keywords</title>
       
@@ -195,7 +215,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,
@@ -203,14 +224,6 @@
 	      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>
 	
@@ -272,19 +285,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 +883,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 +1416,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>


$B$/$j$d$^(B // kuriyama@sky.rim.or.jp
        // kuriyama@FreeBSD.ORG
