From darklogik@pittgoth.com  Tue Feb  5 10:38:01 2002
Return-Path: <darklogik@pittgoth.com>
Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111])
	by hub.freebsd.org (Postfix) with ESMTP id 1EBAB37B400
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  5 Feb 2002 10:38:00 -0800 (PST)
Received: (from darklogik@localhost)
	by pittgoth.com (8.11.6/8.11.6) id g15IdTS02296;
	Tue, 5 Feb 2002 13:39:29 -0500 (EST)
	(envelope-from darklogik)
Message-Id: <200202051839.g15IdTS02296@pittgoth.com>
Date: Tue, 5 Feb 2002 13:39:29 -0500 (EST)
From: Tom Rhodes <darklogik@pittgoth.com>
Reply-To: Tom Rhodes <darklogik@pittgoth.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] Handbook chapter(s)
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         34644
>Category:       docs
>Synopsis:       [PATCH] Handbook chapter(s)
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Feb 05 10:40:01 PST 2002
>Closed-Date:    Mon Feb 11 11:07:54 PST 2002
>Last-Modified:  Mon Feb 11 11:08:17 PST 2002
>Originator:     
>Release:        FreeBSD 4.5 i386
>Organization:
>Environment:
System: FreeBSD localhost 4.5

>Description:
Cleaning out the pr-database, many prs and patches have
become obsolete due to to changes before/after their submission.  This
pr, other than fixing up a quick spell check, also closes several of these
prs.  Including:
pr: 33042
pr: 34622
pr: 34587
pr: 34578
pr: 34344
pr: 33937

and obsoletes pr: 17916 which is a kernel config chapter rewrite, I am currently
reviewing this pr along with pr: 33354 pr: 34074 and pr: 34524

>How-To-Repeat:
Read the handbook, view the doc pr database, and wish someone
would clean it up
>Fix:
Apply the following patch to the handbook directory (used diff -ru)





diff -ru handbook.old/advanced-networking/chapter.sgml handbook/advanced-networking/chapter.sgml
--- handbook.old/advanced-networking/chapter.sgml	Tue Feb  5 11:17:58 2002
+++ handbook/advanced-networking/chapter.sgml	Tue Feb  5 11:52:44 2002
@@ -4473,7 +4473,10 @@
       <para>
         It is a good idea to subscribe to <ulink 
         url="http://www.cert.org/">CERT</ulink> and
-        <ulink url="../handbook/eresources.html#ERESOURCES-MAIL">freebsd-announce</ulink>
+        <ulink url="../handbook/eresources.html#ERESOURCES-MAIL">freebsd-security</ulink>
+        of if you are an extremely busy administrator or use, you may wish
+        to check out the
+        <ulink url="../handbook/eresources.html#ERESOURCES-EMAIL">freebsd-announce</ulink>
         to stay up to date with the current Internet and FreeBSD security 
         issues.
       </para>
diff -ru handbook.old/config/chapter.sgml handbook/config/chapter.sgml
--- handbook.old/config/chapter.sgml	Tue Feb  5 11:17:57 2002
+++ handbook/config/chapter.sgml	Tue Feb  5 12:13:26 2002
@@ -1156,44 +1156,51 @@
 	<filename>/usr/swap0</filename>.  You can use any name you
 	want, of course.</para>
 
-      <para>First, be certain that your kernel configuration includes
-	the vnode driver.  It is not in recent versions of
-	GENERIC.</para>
-
-      <programlisting>pseudo-device   vn 1   #Vnode driver (turns a file into a device)</programlisting>
+      <example>
+        <title>Creating a Swapfile</title>
 
       <orderedlist>
+        <listitem>
+          <para>Be certain that your kernel configuration includes
+            the vnode driver.  It is <emphasis>not</emphasis> in recent versions of
+            <filename>GENERIC</filename>.</para>
+
+          <programlisting>pseudo-device   vn 1   #Vnode driver (turns a file into a device)</programlisting>
+        </listitem>
+
 	<listitem>
-	  <para>create a vn-device</para>
+	  <para>create a vn-device:</para>
 	  <screen>&prompt.root; <userinput>cd /dev</userinput> &prompt.root; <userinput>sh MAKEDEV vn0</userinput></screen>
 	</listitem>
 
 	<listitem>
-	  <para>create a swapfile (<filename>/usr/swap0</filename>)</para>
+	  <para>create a swapfile (<filename>/usr/swap0</filename>):</para>
 
 	  <screen>&prompt.root; <userinput>dd if=/dev/zero of=/usr/swap0 bs=1024k count=64</userinput></screen>
 	</listitem>
 
 	<listitem>
-	  <para>set proper permissions on (<filename>/usr/swap0</filename>)</para>
+	  <para>set proper permissions on (<filename>/usr/swap0</filename>):</para>
 
 	  <screen>&prompt.root; <userinput>chmod 0600 /usr/swap0</userinput></screen>
 	</listitem>
 
 	<listitem>
-	  <para>enable the swap file in <filename>/etc/rc.conf</filename></para>
+	  <para>enable the swap file in <filename>/etc/rc.conf</filename>:</para>
 
 	  <programlisting>swapfile="/usr/swap0"   # Set to name of swapfile if aux swapfile desired.</programlisting>
 	</listitem>
 
 	<listitem>
-	  <para>reboot the machine</para>
-	</listitem>
-      </orderedlist>
 
-      <para>To enable the swap file immediately, type</para>
+          <para>Reboot the machine or to enable the swap file immediately,
+            type:</para>
+
+          <screen>&prompt.root; <userinput>vnconfig -e /dev/vn0b /usr/swap0 swap</userinput></screen>
+        </listitem>
+      </orderedlist>
 
-      <screen>&prompt.root; <userinput>vnconfig -e /dev/vn0b /usr/swap0 swap</userinput></screen>
+      </example>
     </sect2>
   </sect1>
 </chapter>
diff -ru handbook.old/cutting-edge/chapter.sgml handbook/cutting-edge/chapter.sgml
--- handbook.old/cutting-edge/chapter.sgml	Tue Feb  5 11:17:58 2002
+++ handbook/cutting-edge/chapter.sgml	Tue Feb  5 12:23:31 2002
@@ -758,6 +758,19 @@
       <para>This checks the filesystems, remounts <filename>/</filename>
 	read/write, mounts all the other UFS filesystems referenced in
 	<filename>/etc/fstab</filename> and then turns swapping on.</para>
+
+
+        <note>
+          <para>If your CMOS clock is set to local time and not to GMT,
+            you may also need to run the following command:</para>
+<screen>&prompt.root; <userinput>adjkerntz -i</userinput></screen>
+
+          <para>This will make sure that your local timezone settings
+            get set up correctly - without this, you may later run into some
+            problems.
+          </para>
+        </note>
+
     </sect2>
 
     <sect2>
@@ -1009,7 +1022,8 @@
 	<maketarget>installworld</maketarget> to install the new system
 	binaries.</para>
 
-      <para>Run</para>
+      <para>Be sure that you are in the <filename>/usr/src</filename>
+        directory, if not, &man.cd.1; there now and run:</para>
 
       <screen>&prompt.root; <userinput>make installworld</userinput></screen>
 
diff -ru handbook.old/install/chapter.sgml handbook/install/chapter.sgml
--- handbook.old/install/chapter.sgml	Tue Feb  5 11:17:59 2002
+++ handbook/install/chapter.sgml	Tue Feb  5 11:24:26 2002
@@ -2190,10 +2190,10 @@
 
 	      <entry><filename>/</filename></entry>
 
-	      <entry>64MB</entry>
+	      <entry>100MB</entry>
 
 	      <entry>This is the root file system.  Every other filesystem
-		will be mounted somewhere under this one.  64MB is a
+		will be mounted somewhere under this one.  100MB is a
 		reasonable size for this filesystem.  You will not be storing
 		too much data on it, as a regular FreeBSD install will put
 		about 40MB of data here.  The remaining space is for temporary
@@ -4515,6 +4515,11 @@
 	has been issued and the message "Please press any key to reboot"
 	appears. If any key is pressed instead of turning off the power
 	switch, the system will reboot.</para>
+
+      <para>You could also use the <keycap>CTRL+ALT+DEL</keycap> key
+        combination to reboot the system, however this is not recommended
+        during normal operation.</para>
+
     </sect2>
   </sect1>
 
diff -ru handbook.old/kernelconfig/chapter.sgml handbook/kernelconfig/chapter.sgml
--- handbook.old/kernelconfig/chapter.sgml	Tue Feb  5 11:18:00 2002
+++ handbook/kernelconfig/chapter.sgml	Tue Feb  5 11:42:05 2002
@@ -616,7 +616,7 @@
     <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.  They enabled by default in the 4.X branch
+      up write access on the disks.  They are enabled by default in the 4.X branch
       but may not be turned on.  Review the output from &man.mount.8; to see
       if you have them enabled.  If you do not see the soft-updates option then
       you will need to activate it using the &man.tunefs.8; or &man.newfs.8;
@@ -1318,7 +1318,7 @@
 	    counts down from 10.  Hit any key except for the
             <keycap>enter</keycap> key, type <command>unload</command>
             and then type
-	    <command>boot<replaceable>kernel.old</replaceable></command>,
+	    <command>boot <replaceable>kernel.old</replaceable></command>,
             or the filename of any other kernel that will boot properly.
             When reconfiguring a kernel, it is always a good idea to keep
             a kernel that is known to work on hand.</para>
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->jim 
Responsible-Changed-By: jim 
Responsible-Changed-When: Tue Feb 5 10:47:36 PST 2002 
Responsible-Changed-Why:  
I'll take this. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=34644 

From: Tom Rhodes <darklogik@pittgoth.com>
To: FreeBSD-gnats-submit@FreeBSD.org, Jim Mock <mij@soupnazi.org>
Cc:  
Subject: Re: docs/34644: [PATCH] and information on
Date: Wed, 06 Feb 2002 10:46:04 -0500

 Unfortunatly, 'hunk' one, and part 2 of 'hunk' 3 is now obsolete due to 
 a recent change in the pr database, should I redsign the patch or do you 
 just want to remove the defunct parts?  Just let me know and thanks!
 
 
 -- 
 Tom (Darklogik) Rhodes
 www.Pittgoth.com Gothic Liberation Front
 www.FreeBSD.org  The Power To Serve
 

From: Tom Rhodes <darklogik@pittgoth.com>
To: FreeBSD-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/34644: [NEW PATCH] Handbook Chapter(s)
Date: Wed, 6 Feb 2002 15:33:03 -0500 (EST)

 diff -ru handbook.old/config/chapter.sgml handbook/config/chapter.sgml
 --- handbook.old/config/chapter.sgml	Tue Feb  5 11:17:57 2002
 +++ handbook/config/chapter.sgml	Tue Feb  5 12:13:26 2002
 @@ -1156,44 +1156,51 @@
  	<filename>/usr/swap0</filename>.  You can use any name you
  	want, of course.</para>
  
 -      <para>First, be certain that your kernel configuration includes
 -	the vnode driver.  It is not in recent versions of
 -	GENERIC.</para>
 -
 -      <programlisting>pseudo-device   vn 1   #Vnode driver (turns a file into a device)</programlisting>
 +      <example>
 +        <title>Creating a Swapfile</title>
  
        <orderedlist>
 +        <listitem>
 +          <para>Be certain that your kernel configuration includes
 +            the vnode driver.  It is <emphasis>not</emphasis> in recent versions of
 +            <filename>GENERIC</filename>.</para>
 +
 +          <programlisting>pseudo-device   vn 1   #Vnode driver (turns a file into a device)</programlisting>
 +        </listitem>
 +
  	<listitem>
 -	  <para>create a vn-device</para>
 +	  <para>create a vn-device:</para>
  	  <screen>&prompt.root; <userinput>cd /dev</userinput> &prompt.root; <userinput>sh MAKEDEV vn0</userinput></screen>
  	</listitem>
  
  	<listitem>
 -	  <para>create a swapfile (<filename>/usr/swap0</filename>)</para>
 +	  <para>create a swapfile (<filename>/usr/swap0</filename>):</para>
  
  	  <screen>&prompt.root; <userinput>dd if=/dev/zero of=/usr/swap0 bs=1024k count=64</userinput></screen>
  	</listitem>
  
  	<listitem>
 -	  <para>set proper permissions on (<filename>/usr/swap0</filename>)</para>
 +	  <para>set proper permissions on (<filename>/usr/swap0</filename>):</para>
  
  	  <screen>&prompt.root; <userinput>chmod 0600 /usr/swap0</userinput></screen>
  	</listitem>
  
  	<listitem>
 -	  <para>enable the swap file in <filename>/etc/rc.conf</filename></para>
 +	  <para>enable the swap file in <filename>/etc/rc.conf</filename>:</para>
  
  	  <programlisting>swapfile="/usr/swap0"   # Set to name of swapfile if aux swapfile desired.</programlisting>
  	</listitem>
  
  	<listitem>
 -	  <para>reboot the machine</para>
 -	</listitem>
 -      </orderedlist>
  
 -      <para>To enable the swap file immediately, type</para>
 +          <para>Reboot the machine or to enable the swap file immediately,
 +            type:</para>
 +
 +          <screen>&prompt.root; <userinput>vnconfig -e /dev/vn0b /usr/swap0 swap</userinput></screen>
 +        </listitem>
 +      </orderedlist>
  
 -      <screen>&prompt.root; <userinput>vnconfig -e /dev/vn0b /usr/swap0 swap</userinput></screen>
 +      </example>
      </sect2>
    </sect1>
  </chapter>
 diff -ru handbook.old/cutting-edge/chapter.sgml handbook/cutting-edge/chapter.sgml
 --- handbook.old/cutting-edge/chapter.sgml	Tue Feb  5 11:17:58 2002
 +++ handbook/cutting-edge/chapter.sgml	Tue Feb  5 12:23:31 2002
 @@ -758,6 +758,19 @@
        <para>This checks the filesystems, remounts <filename>/</filename>
  	read/write, mounts all the other UFS filesystems referenced in
  	<filename>/etc/fstab</filename> and then turns swapping on.</para>
 +
 +
 +        <note>
 +          <para>If your CMOS clock is set to local time and not to GMT,
 +            you may also need to run the following command:</para>
 +<screen>&prompt.root; <userinput>adjkerntz -i</userinput></screen>
 +
 +          <para>This will make sure that your local timezone settings
 +            get set up correctly - without this, you may later run into some
 +            problems.
 +          </para>
 +        </note>
 +
      </sect2>
  
      <sect2>
 diff -ru handbook.old/install/chapter.sgml handbook/install/chapter.sgml
 --- handbook.old/install/chapter.sgml	Tue Feb  5 11:17:59 2002
 +++ handbook/install/chapter.sgml	Tue Feb  5 11:24:26 2002
 @@ -2190,10 +2190,10 @@
  
  	      <entry><filename>/</filename></entry>
  
 -	      <entry>64MB</entry>
 +	      <entry>100MB</entry>
  
  	      <entry>This is the root file system.  Every other filesystem
 -		will be mounted somewhere under this one.  64MB is a
 +		will be mounted somewhere under this one.  100MB is a
  		reasonable size for this filesystem.  You will not be storing
  		too much data on it, as a regular FreeBSD install will put
  		about 40MB of data here.  The remaining space is for temporary
 @@ -4515,6 +4515,11 @@
  	has been issued and the message "Please press any key to reboot"
  	appears. If any key is pressed instead of turning off the power
  	switch, the system will reboot.</para>
 +
 +      <para>You could also use the <keycap>CTRL+ALT+DEL</keycap> key
 +        combination to reboot the system, however this is not recommended
 +        during normal operation.</para>
 +
      </sect2>
    </sect1>
  
 diff -ru handbook.old/kernelconfig/chapter.sgml handbook/kernelconfig/chapter.sgml
 --- handbook.old/kernelconfig/chapter.sgml	Tue Feb  5 11:18:00 2002
 +++ handbook/kernelconfig/chapter.sgml	Tue Feb  5 11:42:05 2002
 @@ -616,7 +616,7 @@
      <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.  They enabled by default in the 4.X branch
 +      up write access on the disks.  They are enabled by default in the 4.X branch
        but may not be turned on.  Review the output from &man.mount.8; to see
        if you have them enabled.  If you do not see the soft-updates option then
        you will need to activate it using the &man.tunefs.8; or &man.newfs.8;
 @@ -1318,7 +1318,7 @@
  	    counts down from 10.  Hit any key except for the
              <keycap>enter</keycap> key, type <command>unload</command>
              and then type
 -	    <command>boot<replaceable>kernel.old</replaceable></command>,
 +	    <command>boot <replaceable>kernel.old</replaceable></command>,
              or the filename of any other kernel that will boot properly.
              When reconfiguring a kernel, it is always a good idea to keep
              a kernel that is known to work on hand.</para>

From: Tom Rhodes <darklogik@pittgoth.com>
To: FreeBSD-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/34644: [NEW PATCH 2] old ones are obsolete
Date: Mon, 11 Feb 2002 13:09:57 -0500 (EST)

 diff -ru handbook.old/config/chapter.sgml handbook/config/chapter.sgml
 --- handbook.old/config/chapter.sgml	Tue Feb  5 11:17:57 2002
 +++ handbook/config/chapter.sgml	Tue Feb  5 12:13:26 2002
 @@ -1156,44 +1156,51 @@
  	<filename>/usr/swap0</filename>.  You can use any name you
  	want, of course.</para>
  
 -      <para>First, be certain that your kernel configuration includes
 -	the vnode driver.  It is not in recent versions of
 -	GENERIC.</para>
 -
 -      <programlisting>pseudo-device   vn 1   #Vnode driver (turns a file into a device)</programlisting>
 +      <example>
 +        <title>Creating a Swapfile</title>
  
        <orderedlist>
 +        <listitem>
 +          <para>Be certain that your kernel configuration includes
 +            the vnode driver.  It is <emphasis>not</emphasis> in recent versions of
 +            <filename>GENERIC</filename>.</para>
 +
 +          <programlisting>pseudo-device   vn 1   #Vnode driver (turns a file into a device)</programlisting>
 +        </listitem>
 +
  	<listitem>
 -	  <para>create a vn-device</para>
 +	  <para>create a vn-device:</para>
  	  <screen>&prompt.root; <userinput>cd /dev</userinput> &prompt.root; <userinput>sh MAKEDEV vn0</userinput></screen>
  	</listitem>
  
  	<listitem>
 -	  <para>create a swapfile (<filename>/usr/swap0</filename>)</para>
 +	  <para>create a swapfile (<filename>/usr/swap0</filename>):</para>
  
  	  <screen>&prompt.root; <userinput>dd if=/dev/zero of=/usr/swap0 bs=1024k count=64</userinput></screen>
  	</listitem>
  
  	<listitem>
 -	  <para>set proper permissions on (<filename>/usr/swap0</filename>)</para>
 +	  <para>set proper permissions on (<filename>/usr/swap0</filename>):</para>
  
  	  <screen>&prompt.root; <userinput>chmod 0600 /usr/swap0</userinput></screen>
  	</listitem>
  
  	<listitem>
 -	  <para>enable the swap file in <filename>/etc/rc.conf</filename></para>
 +	  <para>enable the swap file in <filename>/etc/rc.conf</filename>:</para>
  
  	  <programlisting>swapfile="/usr/swap0"   # Set to name of swapfile if aux swapfile desired.</programlisting>
  	</listitem>
  
  	<listitem>
 -	  <para>reboot the machine</para>
 -	</listitem>
 -      </orderedlist>
  
 -      <para>To enable the swap file immediately, type</para>
 +          <para>Reboot the machine or to enable the swap file immediately,
 +            type:</para>
 +
 +          <screen>&prompt.root; <userinput>vnconfig -e /dev/vn0b /usr/swap0 swap</userinput></screen>
 +        </listitem>
 +      </orderedlist>
  
 -      <screen>&prompt.root; <userinput>vnconfig -e /dev/vn0b /usr/swap0 swap</userinput></screen>
 +      </example>
      </sect2>
    </sect1>
  </chapter>
 diff -ru handbook.old/cutting-edge/chapter.sgml handbook/cutting-edge/chapter.sgml
 --- handbook.old/cutting-edge/chapter.sgml	Tue Feb  5 11:17:58 2002
 +++ handbook/cutting-edge/chapter.sgml	Tue Feb  5 12:23:31 2002
 @@ -758,6 +758,19 @@
        <para>This checks the filesystems, remounts <filename>/</filename>
  	read/write, mounts all the other UFS filesystems referenced in
  	<filename>/etc/fstab</filename> and then turns swapping on.</para>
 +
 +
 +        <note>
 +          <para>If your CMOS clock is set to local time and not to GMT,
 +            you may also need to run the following command:</para>
 +<screen>&prompt.root; <userinput>adjkerntz -i</userinput></screen>
 +
 +          <para>This will make sure that your local timezone settings
 +            get set up correctly - without this, you may later run into some
 +            problems.
 +          </para>
 +        </note>
 +
      </sect2>
  
      <sect2>
 diff -ru handbook.old/install/chapter.sgml handbook/install/chapter.sgml
 --- handbook.old/install/chapter.sgml	Tue Feb  5 11:17:59 2002
 +++ handbook/install/chapter.sgml	Tue Feb  5 11:24:26 2002
 @@ -2190,10 +2190,10 @@
  
  	      <entry><filename>/</filename></entry>
  
 -	      <entry>64MB</entry>
 +	      <entry>100MB</entry>
  
  	      <entry>This is the root file system.  Every other filesystem
 -		will be mounted somewhere under this one.  64MB is a
 +		will be mounted somewhere under this one.  100MB is a
  		reasonable size for this filesystem.  You will not be storing
  		too much data on it, as a regular FreeBSD install will put
  		about 40MB of data here.  The remaining space is for temporary
 @@ -4515,6 +4515,11 @@
  	has been issued and the message "Please press any key to reboot"
  	appears. If any key is pressed instead of turning off the power
  	switch, the system will reboot.</para>
 +
 +      <para>You could also use the <keycap>CTRL+ALT+DEL</keycap> key
 +        combination to reboot the system, however this is not recommended
 +        during normal operation.</para>
 +
      </sect2>
    </sect1>
State-Changed-From-To: open->closed 
State-Changed-By: jim 
State-Changed-When: Mon Feb 11 11:07:54 PST 2002 
State-Changed-Why:  
Committed, thanks! 


Responsible-Changed-From-To: jim->freebsd-doc 
Responsible-Changed-By: jim 
Responsible-Changed-When: Mon Feb 11 11:07:54 PST 2002 
Responsible-Changed-Why:  

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=34644 
>Unformatted:
