Fixed a blatant lie regarding newsgroups. Added pointers to indexed

arcihves of the mailing lists and usenet groups.

Renamed the last part "Appendicies"

Moved "PC hardware reference" to the Appendicies section and added
an introduction.

Fixed a dangling cross reference.  (submitters.sgml)

4 files changed, 102 insertions, 55 deletions

diff --git a/share/doc/handbook/eresources.sgml b/share/doc/handbook/eresources.sgml
index 2105f36..8608223 100644
--- a/share/doc/handbook/eresources.sgml
+++ b/share/doc/handbook/eresources.sgml
@@ -1,14 +1,28 @@
-<!-- $Id: eresources.sgml,v 1.1.1.1 1995/04/28 16:19:59 jfieber Exp $ -->
+<!-- $Id: eresources.sgml,v 1.2 1995/05/18 03:05:06 jfieber Exp $ -->
 <!-- The FreeBSD Documentation Project -->
 
-    <chapt>
-      <heading>Additional resources on the Internet</heading>
+<chapt>
+  <heading>Resources on the Internet</heading>
+
+  <p>The rapid pace of FreeBSD progress makes print media
+    impractical as a means for following the latest
+    developments.  Electronic resources are the best, if not the
+    only way stay informed of the latest advances.  Also, since
+    FreeBSD is a volunteer effort, the user community also serves
+    as the technical support department and invariably,
+    electronic mail and Usenet news are the most effective way of
+    getting technical problems resolved.
+
+    Below, the most important points of contact with the FreeBSD
+    user community are outlined.  If you are aware of other
+    resources not included, please send them to
+    <tt>doc@freebsd.org</tt> so they may be included.
 
       <sect>
-        <heading>Mailing lists<label id="eresources:mailing-lists"></heading>
+        <heading>Mailing lists<label id="eresources:mail"></heading>
 
 <p><em>Contributed by &a.dufalt;.<newline>
-  5 May 1995.</em>
+  20 Jun 1995.</em>
 
 Though many of the FreeBSD development members read USENET, we cannot
 always guarantee that we'll get to your questions in a timely fashion
@@ -22,6 +36,12 @@ the list charter before joining a list.  We must strive to
 keep the signal to noise ratio of the lists high, especially in
 the technical lists.
 
+Archives are kept for all of the mailing lists and can be searched
+using the the <url url="http://www.freebsd.org/How/mail-archive.html"
+name="FreeBSD World Wide Web server">.  The keyword searchable archive
+offers an excellent way to find answers to frequently asked questions
+and should be consulted before posting a question.
+
 <sect1><heading>List summary</heading>
 
 <p><bf>General lists:</bf> The following are general lists that
@@ -92,9 +112,10 @@ cvs-usrsbin     /usr/src/usr.sbin    System binaries
 
 <sect1><heading>How to subscribe</heading>
 
-<p>All mailing lists live on `FreeBSD.ORG', so to post to a list you
-simply mail to `&lt;listname&gt;@FreeBSD.ORG'.  It will then be redistributed
-to mailing list members throughout the world.
+<p>All mailing lists live on <tt>FreeBSD.ORG</tt>, so to post to a
+list you simply mail to <em>listname</em><tt>@FreeBSD.ORG</tt>.  It
+will then be redistributed to mailing list members throughout the
+world.
 
 To subscribe to a list, send mail to:
 <tscreen><verb>
@@ -235,63 +256,66 @@ fixes, etc).
 </descrip>
 
       <sect>
-        <heading>Usenet newsgroups</heading>
+        <heading>Usenet newsgroups<label id="eresources:news"></heading>
 
-        <p>While no newsgroups dedicated to FreeBSD exist, there
-          are many in which FreeBSD is discussed or are otherwise
-          relevant to FreeBSD users.
+        <p>In addition to two FreeBSD specific newsgroups on Usenet, there
+          are many other in which FreeBSD is discussed or are otherwise
+          relevant to FreeBSD users.  Keyword searchable archives are
+	  available for some of these newsgroups from 
+          <url url="http://minnie.cs.adfa.oz.au/BSD-info/bsdnews_search.html">
+	  courtesy of Warren Toomey <tt>&lt;wkt@cs.adfa.oz.au&gt;</tt>.
 
         <sect1>
           <heading>BSD specific newsgroups</heading>
 
           <p><itemize>
-              <item> comp.unix.bsd.freebsd.announce
-              <item> comp.unix.bsd.freebsd.misc
+              <item>comp.unix.bsd.freebsd.announce
+              <item>comp.unix.bsd.freebsd.misc
             </itemize>
 
         <sect1>
           <heading>Other Unix newsgroups of interest</heading>
 
           <p><itemize>
-              <item> comp.unix 
-              <item> comp.unix.questions 
-              <item> comp.unix.admin 
-              <item> comp.unix.programmer 
-              <item> comp.unix.shell 
-              <item> comp.unix.user-friendly 
-              <item> comp.security.unix 
-              <item> comp.sources.unix 
-              <item> comp.unix.advocacy 
-              <item> comp.unix.misc 
-              <item> comp.os.386bsd.announce
-              <item> comp.os.386bsd.apps
-              <item> comp.os.386bsd.bugs 
-              <item> comp.os.386bsd.development 
-              <item> comp.os.386bsd.misc 
-              <item> comp.os.386bsd.questions 
-              <item> comp.bugs.4bsd 
-              <item> comp.bugs.4bsd.ucb-fixes 
-              <item> comp.unix.bsd 
+              <item>comp.unix 
+              <item>comp.unix.questions 
+              <item>comp.unix.admin 
+              <item>comp.unix.programmer 
+              <item>comp.unix.shell 
+              <item>comp.unix.user-friendly 
+              <item>comp.security.unix 
+              <item>comp.sources.unix 
+              <item>comp.unix.advocacy 
+              <item>comp.unix.misc 
+              <item>comp.os.386bsd.announce
+              <item>comp.os.386bsd.apps
+              <item>comp.os.386bsd.bugs 
+              <item>comp.os.386bsd.development 
+              <item>comp.os.386bsd.misc 
+              <item>comp.os.386bsd.questions 
+              <item>comp.bugs.4bsd 
+              <item>comp.bugs.4bsd.ucb-fixes 
+              <item>comp.unix.bsd 
             </itemize>
 
         <sect1>
           <heading>X-Window system</heading>
 
           <p><itemize>
-              <item> comp.windows.x.i386unix 
-              <item> comp.windows.x 
-              <item> comp.windows.x.apps 
-              <item> comp.windows.x.announce 
-              <item> comp.windows.x.intrinsics 
-              <item> comp.windows.x.motif 
-              <item> comp.windows.x.pex 
-              <item> comp.emulators.ms-windows.wine 
+              <item>comp.windows.x.i386unix 
+              <item>comp.windows.x 
+              <item>comp.windows.x.apps 
+              <item>comp.windows.x.announce 
+              <item>comp.windows.x.intrinsics 
+              <item>comp.windows.x.motif 
+              <item>comp.windows.x.pex 
+              <item>comp.emulators.ms-windows.wine 
             </itemize>
 
       <sect>
-        <heading>Word Wide Web servers</heading>
+        <heading>Word Wide Web servers<label id="eresources:web"></heading>
 
         <p><itemize> 
-            <item> <url url="http://www.freebsd.org/"></item>
+            <item><url url="http://www.freebsd.org/"></item>
           </itemize>
     </sect>
diff --git a/share/doc/handbook/handbook.sgml b/share/doc/handbook/handbook.sgml
index 85d8845..12074d3 100644
--- a/share/doc/handbook/handbook.sgml
+++ b/share/doc/handbook/handbook.sgml
@@ -1,4 +1,4 @@
-<!-- $Id: handbook.sgml,v 1.7 1995/05/18 03:05:08 jfieber Exp $ -->
+<!-- $Id: handbook.sgml,v 1.8 1995/06/14 18:38:52 jfieber Exp $ -->
 <!-- The FreeBSD Documentation Project -->
 
 <!DOCTYPE linuxdoc PUBLIC "-//FreeBSD//DTD linuxdoc//EN" [
@@ -60,7 +60,7 @@ OUTLINE:
       <author>
 	<name>The FreeBSD Documentation Project</name>
       </author>
-      <date>June 14, 1995</date>
+      <date>June 20, 1995</date>
 
       <abstract>Welcome to FreeBSD!  This handbook covers the
 	installation and day to day use of <bf>FreeBSD Release
@@ -98,7 +98,7 @@ OUTLINE:
 
     <part><heading>System Administration</heading>
 
-      <chapt><heading>Reconfiguring the Kernel<label id="kernelconfig:"></heading>
+      <chapt><heading>* Reconfiguring the Kernel<label id="kernelconfig:"></heading>
      <!--    &kernelconfig; -->
 
     <chapt><heading>Users, groups and security</heading>
@@ -118,8 +118,6 @@ OUTLINE:
       <sect><heading>* Serial ports</heading>
       <sect><heading>* Sound cards</heading>
 
-      &hw;
-	  
 <!-- ************************************************************ -->	      
 
     <part><heading>Network Communications</heading>
@@ -160,9 +158,10 @@ OUTLINE:
 
 <!-- ************************************************************ -->	      
 
-    <part><heading>Additional resources</heading>
+    <part><heading>Appendicies</heading>
     &bibliography;
     &eresources;
+    &hw;
     &glossary;
    
   </book>
diff --git a/share/doc/handbook/hw.sgml b/share/doc/handbook/hw.sgml
index c589a4b..b0db439 100644
--- a/share/doc/handbook/hw.sgml
+++ b/share/doc/handbook/hw.sgml
@@ -1,7 +1,32 @@
-<!-- $Id:$ -->
+<!-- $Id: hw.sgml,v 1.1 1995/06/14 18:38:53 jfieber Exp $ -->
 <!-- The FreeBSD Documentation Project -->
 
-<chapt><heading>* PC Hardware compatibility<label id="hw:"></heading>
+<chapt><heading>PC Hardware compatibility<label id="hw"></heading>
+
+  <p>Issues of hardware compatibility are among the most
+    troublesome in the computer industry today and FreeBSD is by
+    no means immune to trouble.  In this respect, FreeBSD's
+    advantage of being able to run on inexpensive commidity PC
+    hardware is also its liability when it comes to support for
+    the amazing variety of components on the market.  While it
+    would be impossible to provide a exhaustive listing of
+    hardware that FreeBSD supports, this section serves as a
+    catalog of the device drivers included with FreeBSD and the
+    hardware each drivers supports.  Where possible and
+    appropriate, notes about specific products are included.
+
+    As FreeBSD is a volunteer project without a funded testing
+    department, we depend on you, the user, for much of the
+    information contained in this catalog.  If you have direct
+    experience of hardware that does or does not work with
+    FreeBSD, please let us know by sending email to
+    <tt>doc@freebsd.org</tt>.  Questions about supported hardware
+    should be directed to <tt>questions@freebsd.org</tt> (see
+    <ref id="eresources:mail" name="Mailing Lists"> for more
+    information).  When submitting information or asking a
+    question, please remember to specify exactly what version of
+    FreeBSD you are using and include as many details of your
+    hardware as possible.
 
 <sect><heading>* Core/Processing<label id="hw:core"></heading>
 
diff --git a/share/doc/handbook/submitters.sgml b/share/doc/handbook/submitters.sgml
index 81188ae..4a45829 100644
--- a/share/doc/handbook/submitters.sgml
+++ b/share/doc/handbook/submitters.sgml
@@ -1,4 +1,4 @@
-<!-- $Id: submitters.sgml,v 1.1.1.1 1995/04/28 16:19:59 jfieber Exp $ -->
+<!-- $Id: submitters.sgml,v 1.2 1995/05/18 03:05:22 jfieber Exp $ -->
 <!-- The FreeBSD Documentation Project -->
 
 <chapt><heading>Contributing to FreeBSD</heading>
@@ -41,8 +41,7 @@ are each, in their own way, quite significant to the project.
 	  volume of mail!) may
 	  subscribe to the hackers mailing list by sendimg mail to 
           <tt>&lt;majordomo@freebsd.org&gt;</tt>.  
-          See <ref id="eresources:mailing-lists"
-          name="mailing lists">
+          See <ref id="eresources:mail" name="mailing lists">
 	  for more information about this and other mailing lists.
 
 	<item>An actual bug report should be filed by using the 
@@ -204,7 +203,7 @@ THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
-	$Id$
+	$Id: submitters.sgml,v 1.2 1995/05/18 03:05:22 jfieber Exp $
 </verb></tscreen>
 For your convenience, a copy of this text can be found in
 <tt>/usr/share/examples/etc/bsd-style-copyright</tt>.