diff --git a/en_US.ISO8859-1/books/arch-handbook/book.sgml b/en_US.ISO8859-1/books/arch-handbook/book.sgml
index f407d4c9a7..a1a485a73d 100644
--- a/en_US.ISO8859-1/books/arch-handbook/book.sgml
+++ b/en_US.ISO8859-1/books/arch-handbook/book.sgml
@@ -1,504 +1,517 @@
 <!--
      The FreeBSD Documentation Project
 
-     $FreeBSD: doc/en_US.ISO_8859-1/books/developers-handbook/book.sgml,v 1.16 2001/05/02 01:53:13 murray Exp $
+     $FreeBSD: doc/en_US.ISO_8859-1/books/developers-handbook/book.sgml,v 1.17 2001/05/11 10:20:33 murray Exp $
 -->
 
 <!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
 <!ENTITY % bookinfo PUBLIC "-//FreeBSD//ENTITIES DocBook BookInfo Entities//EN">
 %bookinfo;
 <!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
 %man;
 <!ENTITY % chapters SYSTEM "chapters.ent"> %chapters;
 <!ENTITY % authors SYSTEM "../handbook/authors.ent"> %authors;
+<!ENTITY % mailing-lists SYSTEM "../handbook/mailing-lists.ent"> %mailing-lists;
 ]>
 
 <book>
   <bookinfo>
     <title>FreeBSD Developers' Handbook</title>
     
     <corpauthor>The FreeBSD Documentation Project</corpauthor>
     
     <pubdate>August 2000</pubdate>
     
     <copyright>
       <year>2000</year>
       <year>2001</year>
       <holder>The FreeBSD Documentation Project</holder>
     </copyright>
 
     &bookinfo.legalnotice;
     
     <abstract>
-      <para>Welcome to the Developers' Handbook.</para>
+      <para>Welcome to the Developers' Handbook.  This manual is a
+	<emphasis>work in progress</emphasis> and is the work of many
+	individuals.  Many sections do not yet exist and some of those
+	that do exist need to be updated.  If you are interested in
+	helping with this project, send email to the &a.doc;.  The
+	latest version of this document is always available from the
+	<ulink URL="http://www.FreeBSD.org/">FreeBSD World Wide Web
+	server</ulink>.  It may also be downloaded in a variety of
+	formats and compression options from the <ulink
+	url="ftp://ftp.FreeBSD.org/pub/FreeBSD/doc">FreeBSD FTP
+	server</ulink> or one of the numerous <ulink
+	url="http://www.freebsd.org/handbook/mirrors-ftp.html">mirror
+	sites</ulink>.</para>
     </abstract>
   </bookinfo>
   
   <part id="introduction">
     <title>Introduction</title>
 
     <chapter id="developmentplatform">
       <title>Developing on FreeBSD</title>
 
       <para>This will need to discuss FreeBSD as a development
         platform, the vision of BSD, architectural overview, layout of
         /usr/src, history, etc.</para>
 
       <para>Thank you for considering FreeBSD as your development
         platform!  We hope it will not let you down.</para>
     </chapter>
 
     <chapter id="bsdvision">
       <title>The BSD Vision</title>
 
       <para></para>
     </chapter>
 
     <chapter id="archoverview">
       <title>Architectural Overview</title>
 
       <para></para>
     </chapter>
 
     <chapter id="sourcelayout">
       <title>The Layout of /usr/src</title>
 
       <para>The complete source code to FreeBSD is available from our
       public CVS repository.  The source code is normally installed in
       <filename class=directory>/usr/src</filename> which contains the
       following subdirectories.</para>
 
       <para>
       <informaltable frame="none">
         <tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>Directory</entry>
 	      <entry>Description</entry>
 	    </row>
 	  </thead>
 	  
 	  <tbody>
 	    <row>
 	    <entry><filename class=directory>bin/</filename></entry>
             <entry>Source for files in
             <filename>/bin</filename></entry>
 	    </row>
 	    
 	    <row>
 	    <entry><filename class=directory>contrib/</filename></entry>
 	    <entry>Source for files from contributed software.</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>crypto/</filename></entry>
 	    <entry>DES source</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>etc/</filename></entry>
 	    <entry>Source for files in <filename
 	    class=directory>/etc</filename></entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>games/</filename></entry>
 	    <entry>Source for files in <filename
 	    class=directory>/usr/games</filename></entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>gnu/</filename></entry>
 	    <entry>Utilities covered by the GNU Public License</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>include/</filename></entry>
             <entry>Source for files in <filename
             class=directory>/usr/include</filename></entry>
 	    </row>
 
 	    <row>
 	    <entry><filename
  class=directory>kerberosIV/</filename></entry>
             <entry>Source for Kerbereros version IV</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename
  class=directory>kerberos5/</filename></entry>
             <entry>Source for Kerbereros version 5</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>lib/</filename></entry>
 	    <entry>Source for files in <filename
 	    class=directory>/usr/lib</filename></entry>
 	    </row>
 	    
 	    <row>
 	    <entry><filename class=directory>libexec/</filename></entry>
 	    <entry>Source for files in <filename
 	    class=directory>/usr/libexec</filename></entry>
 	    </row>
 	    
 	    <row>
 	    <entry><filename
  class=directory>release/</filename></entry>
             <entry>Files required to produce a FreeBSD release</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>sbin/</filename></entry>
 	    <entry>Source for files in <filename
 	    class=directory>/sbin</filename></entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>secure/</filename></entry>
 	    <entry>FreeSec sources</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>share/</filename></entry>
 	    <entry>Source for files in <filename
 	    class=directory>/sbin</filename></entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>sys/</filename></entry>
 	    <entry>Kernel source files</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>tools/</filename></entry>
 	    <entry>Tools used for maintenance and testing of
 	    FreeBSD</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename
  class=directory>usr.bin/</filename></entry>
             <entry>Source for files in <filename
  class=directory>/usr/bin</filename></entry>
             </row>
 
 	    <row>
 	    <entry><filename
  class=directory>usr.sbin/</filename></entry>
             <entry>Source for files in <filename
  class=directory>/usr/sbin</filename></entry>
             </row>
           </tbody>
 	</tgroup>
       </informaltable>
 
       </para>
 
     </chapter>
   </part>
 
   <part id="Basics">
     <title>Basics</title>
 
     &chap.tools;
     &chap.secure;
 
   </part>
 
   <part id="kernel">
     <title>Kernel</title>
 
     <chapter id="kernelhistory">
       <title>History of the Unix Kernel</title>
 
       <para>Some history of the Unix/BSD kernel, system calls, how do
         processes work, blocking, scheduling, threads (kernel),
         context switching, signals, interrupts, modules, etc.</para>
 
       <para></para>
     </chapter>
 
     &chap.locking;
 
   </part>
 
   <part id="memory">
     <title>Memory and Virtual Memory</title>
 
     <chapter id="virtualmemory">
       <title>Virtual Memory</title>
 
       <para>VM, paging, swapping, allocating memory, testing for
         memory leaks, mmap, vnodes, etc.</para>
 
       <para></para>
     </chapter>
   </part>
 
   <part id="iosystem">
     <title>I/O System</title>
 
     <chapter id="ufs">
       <title>UFS</title>
 
       <para>UFS, FFS, Ext2FS, JFS, inodes, buffer cache, labeling,
         locking, metadata, soft-updates, LFS, portalfs, procfs,
         vnodes, memory sharing, memory objects, TLBs, caching</para>
 
     </chapter>
   </part>
 
   <part id="ipc">
     <title>Interprocess Communication</title>
     
     <chapter id="signals">
       <title>Signals</title>
 
       <para>Signals, pipes, semaphores, message queues, shared memory,
         ports, sockets, doors</para>
 
     </chapter>
   </part>
 
   <part id="networking">
     <title>Networking</title>
     
     <chapter id="sockets">
       <title>Sockets</title>
 
       <para>Sockets, bpf, IP, TCP, UDP, ICMP, OSI, bridging,
         firewalling, NAT, switching, etc</para>
 
     </chapter>
   </part>
   
   <part id="networkfs">
     <title>Network Filesystems</title>
 
     <chapter id="afs">
       <title>AFS</title>
 
       <para>AFS, NFS, SANs etc]</para>
 
     </chapter>
   </part>
   
   <part id="terminal">
     <title>Terminal Handling</title>
 
     <chapter id="syscons">
       <title>Syscons</title>
 
       <para>Syscons, tty, PCVT, serial console, screen savers,
         etc</para>
 
     </chapter>
   </part>
   
   <part id="sound">
     <title>Sound</title>
 
     <chapter id="oss">
       <title>OSS</title>
 
       <para>OSS, waveforms, etc</para>
 
     </chapter>
   </part>
   
   <part id="devicedrivers">
     <title>Device Drivers</title>
 
     &chap.driverbasics;
     &chap.isa;
     &chap.pci;
     &chap.scsi;
     &chap.usb;
 
     <chapter id="newbus">
       <title>NewBus</title>
 
       <para>This chapter will talk about the FreeBSD NewBus
       architecture.</para>
     </chapter>
 
   </part>
   
   <part id="architectures">
     <title>Architectures</title>
 
     &chap.x86;
 
     <chapter id="alpha">
       <title>Alpha</title>
 
       <para>Talk about the architectural specifics of
       FreeBSD/alpha.</para>
 
       <para>Explanation of allignment errors, how to fix, how to
       ignore.</para>
 
       <para>Example assembly language code for FreeBSD/alpha.</para>
     </chapter>
 
     <chapter id="ia64">
       <title>IA-64</title>
 
       <para>Talk about the architectural specifics of
       FreeBSD/ia64.</para>
 
     </chapter>
   </part>
   
   <part id="debuggingpart">
     <title>Debugging</title>
 
     <chapter id="truss">
       <title>Truss</title>
 
       <para>various descriptions on how to debug certain aspects of
         the system using truss, ktrace, gdb, kgdb, etc</para>
 
     </chapter>
   </part>
   
   <part id="compatibility">
     <title>Compatibility Layers</title>
 
     <chapter id="linux">
       <title>Linux</title>
 
       <para>Linux, SVR4, etc</para>
 
     </chapter>
   </part>
   
   <part id="appendices">
     <title>Appendices</title>
 
       <bibliography>
 
       <biblioentry id="COD" xreflabel="1">
         <authorgroup>
           <author>
             <firstname>Dave</firstname>
             <othername role="MI">A</othername>
             <surname>Patterson</surname>
           </author>
           <author>
             <firstname>John</firstname>
             <othername role="MI">L</othername>
             <surname>Hennessy</surname>
           </author>
         </authorgroup>
         <copyright><year>1998</year><holder>Morgan Kaufmann Publishers,
         Inc.</holder></copyright>
         <isbn>1-55860-428-6</isbn>
         <publisher>
           <publishername>Morgan Kaufmann Publishers, Inc.</publishername>
         </publisher>
         <title>Computer Organization and Design</title>
         <subtitle>The Hardware / Software Interface</subtitle>
         <pagenums>1-2</pagenums>
       </biblioentry>
 
       <biblioentry xreflabel="2">
         <authorgroup>
           <author>
             <firstname>W.</firstname>
             <othername role="Middle">Richard</othername>
             <surname>Stevens</surname>
           </author>
         </authorgroup>
         <copyright><year>1993</year><holder>Addison Wesley Longman,
         Inc.</holder></copyright>
         <isbn>0-201-56317-7</isbn>
         <publisher>
           <publishername>Addison Wesley Longman, Inc.</publishername>
         </publisher>
         <title>Advanced Programming in the Unix Environment</title>
         <pagenums>1-2</pagenums>
       </biblioentry>
 
       <biblioentry xreflabel="3">
         <authorgroup>
           <author>
             <firstname>Marshall</firstname>
             <othername role="Middle">Kirk</othername>
             <surname>McKusick</surname>
           </author>
           <author>
             <firstname>Keith</firstname>
             <surname>Bostic</surname>
           </author>
           <author>
             <firstname>Michael</firstname>
             <othername role="MI">J</othername>
             <surname>Karels</surname>
           </author>
           <author>
             <firstname>John</firstname>
             <othername role="MI">S</othername>
             <surname>Quarterman</surname>
           </author>
         </authorgroup>
         <copyright><year>1996</year><holder>Addison-Wesley Publishing Company,
         Inc.</holder></copyright>
         <isbn>0-201-54979-4</isbn>
         <publisher>
           <publishername>Addison-Wesley Publishing Company, Inc.</publishername>
         </publisher>
         <title>The Design and Implementation of the 4.4 BSD Operating System</title>
         <pagenums>1-2</pagenums>
       </biblioentry>
 
       <biblioentry id="Phrack" xreflabel="4">
         <authorgroup>
           <author>
             <firstname>Aleph</firstname>
             <surname>One</surname>
           </author>
         </authorgroup>
         <title>Phrack 49; "Smashing the Stack for Fun and Profit"</title>
       </biblioentry>
 
       <biblioentry id="StackGuard" xreflabel="5">
         <authorgroup>
           <author>
             <firstname>Chrispin</firstname>
             <surname>Cowan</surname>
           </author>
           <author>
             <firstname>Calton</firstname>
             <surname>Pu</surname>
           </author>
           <author>
             <firstname>Dave</firstname>
             <surname>Maier</surname>
           </author>
         </authorgroup>
         <title>StackGuard; Automatic Adaptive Detection and Prevention of
         Buffer-Overflow Attacks</title>
       </biblioentry>
 
       <biblioentry id="OpenBSD" xreflabel="6">
         <authorgroup>
 	  <author>
 	    <firstname>Todd</firstname>
 	    <surname>Miller</surname>
 	  </author>
 	  <author>
 	    <firstname>Theo</firstname>
 	    <surname>de Raadt</surname>
 	  </author>
 	</authorgroup>
 	<title>strlcpy and strlcat -- consistent, safe string copy and
 	concatenation.</title>
       </biblioentry>
 
       </bibliography>
 
   </part>
 
 </book>
diff --git a/en_US.ISO8859-1/books/developers-handbook/book.sgml b/en_US.ISO8859-1/books/developers-handbook/book.sgml
index f407d4c9a7..a1a485a73d 100644
--- a/en_US.ISO8859-1/books/developers-handbook/book.sgml
+++ b/en_US.ISO8859-1/books/developers-handbook/book.sgml
@@ -1,504 +1,517 @@
 <!--
      The FreeBSD Documentation Project
 
-     $FreeBSD: doc/en_US.ISO_8859-1/books/developers-handbook/book.sgml,v 1.16 2001/05/02 01:53:13 murray Exp $
+     $FreeBSD: doc/en_US.ISO_8859-1/books/developers-handbook/book.sgml,v 1.17 2001/05/11 10:20:33 murray Exp $
 -->
 
 <!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
 <!ENTITY % bookinfo PUBLIC "-//FreeBSD//ENTITIES DocBook BookInfo Entities//EN">
 %bookinfo;
 <!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
 %man;
 <!ENTITY % chapters SYSTEM "chapters.ent"> %chapters;
 <!ENTITY % authors SYSTEM "../handbook/authors.ent"> %authors;
+<!ENTITY % mailing-lists SYSTEM "../handbook/mailing-lists.ent"> %mailing-lists;
 ]>
 
 <book>
   <bookinfo>
     <title>FreeBSD Developers' Handbook</title>
     
     <corpauthor>The FreeBSD Documentation Project</corpauthor>
     
     <pubdate>August 2000</pubdate>
     
     <copyright>
       <year>2000</year>
       <year>2001</year>
       <holder>The FreeBSD Documentation Project</holder>
     </copyright>
 
     &bookinfo.legalnotice;
     
     <abstract>
-      <para>Welcome to the Developers' Handbook.</para>
+      <para>Welcome to the Developers' Handbook.  This manual is a
+	<emphasis>work in progress</emphasis> and is the work of many
+	individuals.  Many sections do not yet exist and some of those
+	that do exist need to be updated.  If you are interested in
+	helping with this project, send email to the &a.doc;.  The
+	latest version of this document is always available from the
+	<ulink URL="http://www.FreeBSD.org/">FreeBSD World Wide Web
+	server</ulink>.  It may also be downloaded in a variety of
+	formats and compression options from the <ulink
+	url="ftp://ftp.FreeBSD.org/pub/FreeBSD/doc">FreeBSD FTP
+	server</ulink> or one of the numerous <ulink
+	url="http://www.freebsd.org/handbook/mirrors-ftp.html">mirror
+	sites</ulink>.</para>
     </abstract>
   </bookinfo>
   
   <part id="introduction">
     <title>Introduction</title>
 
     <chapter id="developmentplatform">
       <title>Developing on FreeBSD</title>
 
       <para>This will need to discuss FreeBSD as a development
         platform, the vision of BSD, architectural overview, layout of
         /usr/src, history, etc.</para>
 
       <para>Thank you for considering FreeBSD as your development
         platform!  We hope it will not let you down.</para>
     </chapter>
 
     <chapter id="bsdvision">
       <title>The BSD Vision</title>
 
       <para></para>
     </chapter>
 
     <chapter id="archoverview">
       <title>Architectural Overview</title>
 
       <para></para>
     </chapter>
 
     <chapter id="sourcelayout">
       <title>The Layout of /usr/src</title>
 
       <para>The complete source code to FreeBSD is available from our
       public CVS repository.  The source code is normally installed in
       <filename class=directory>/usr/src</filename> which contains the
       following subdirectories.</para>
 
       <para>
       <informaltable frame="none">
         <tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>Directory</entry>
 	      <entry>Description</entry>
 	    </row>
 	  </thead>
 	  
 	  <tbody>
 	    <row>
 	    <entry><filename class=directory>bin/</filename></entry>
             <entry>Source for files in
             <filename>/bin</filename></entry>
 	    </row>
 	    
 	    <row>
 	    <entry><filename class=directory>contrib/</filename></entry>
 	    <entry>Source for files from contributed software.</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>crypto/</filename></entry>
 	    <entry>DES source</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>etc/</filename></entry>
 	    <entry>Source for files in <filename
 	    class=directory>/etc</filename></entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>games/</filename></entry>
 	    <entry>Source for files in <filename
 	    class=directory>/usr/games</filename></entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>gnu/</filename></entry>
 	    <entry>Utilities covered by the GNU Public License</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>include/</filename></entry>
             <entry>Source for files in <filename
             class=directory>/usr/include</filename></entry>
 	    </row>
 
 	    <row>
 	    <entry><filename
  class=directory>kerberosIV/</filename></entry>
             <entry>Source for Kerbereros version IV</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename
  class=directory>kerberos5/</filename></entry>
             <entry>Source for Kerbereros version 5</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>lib/</filename></entry>
 	    <entry>Source for files in <filename
 	    class=directory>/usr/lib</filename></entry>
 	    </row>
 	    
 	    <row>
 	    <entry><filename class=directory>libexec/</filename></entry>
 	    <entry>Source for files in <filename
 	    class=directory>/usr/libexec</filename></entry>
 	    </row>
 	    
 	    <row>
 	    <entry><filename
  class=directory>release/</filename></entry>
             <entry>Files required to produce a FreeBSD release</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>sbin/</filename></entry>
 	    <entry>Source for files in <filename
 	    class=directory>/sbin</filename></entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>secure/</filename></entry>
 	    <entry>FreeSec sources</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>share/</filename></entry>
 	    <entry>Source for files in <filename
 	    class=directory>/sbin</filename></entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>sys/</filename></entry>
 	    <entry>Kernel source files</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>tools/</filename></entry>
 	    <entry>Tools used for maintenance and testing of
 	    FreeBSD</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename
  class=directory>usr.bin/</filename></entry>
             <entry>Source for files in <filename
  class=directory>/usr/bin</filename></entry>
             </row>
 
 	    <row>
 	    <entry><filename
  class=directory>usr.sbin/</filename></entry>
             <entry>Source for files in <filename
  class=directory>/usr/sbin</filename></entry>
             </row>
           </tbody>
 	</tgroup>
       </informaltable>
 
       </para>
 
     </chapter>
   </part>
 
   <part id="Basics">
     <title>Basics</title>
 
     &chap.tools;
     &chap.secure;
 
   </part>
 
   <part id="kernel">
     <title>Kernel</title>
 
     <chapter id="kernelhistory">
       <title>History of the Unix Kernel</title>
 
       <para>Some history of the Unix/BSD kernel, system calls, how do
         processes work, blocking, scheduling, threads (kernel),
         context switching, signals, interrupts, modules, etc.</para>
 
       <para></para>
     </chapter>
 
     &chap.locking;
 
   </part>
 
   <part id="memory">
     <title>Memory and Virtual Memory</title>
 
     <chapter id="virtualmemory">
       <title>Virtual Memory</title>
 
       <para>VM, paging, swapping, allocating memory, testing for
         memory leaks, mmap, vnodes, etc.</para>
 
       <para></para>
     </chapter>
   </part>
 
   <part id="iosystem">
     <title>I/O System</title>
 
     <chapter id="ufs">
       <title>UFS</title>
 
       <para>UFS, FFS, Ext2FS, JFS, inodes, buffer cache, labeling,
         locking, metadata, soft-updates, LFS, portalfs, procfs,
         vnodes, memory sharing, memory objects, TLBs, caching</para>
 
     </chapter>
   </part>
 
   <part id="ipc">
     <title>Interprocess Communication</title>
     
     <chapter id="signals">
       <title>Signals</title>
 
       <para>Signals, pipes, semaphores, message queues, shared memory,
         ports, sockets, doors</para>
 
     </chapter>
   </part>
 
   <part id="networking">
     <title>Networking</title>
     
     <chapter id="sockets">
       <title>Sockets</title>
 
       <para>Sockets, bpf, IP, TCP, UDP, ICMP, OSI, bridging,
         firewalling, NAT, switching, etc</para>
 
     </chapter>
   </part>
   
   <part id="networkfs">
     <title>Network Filesystems</title>
 
     <chapter id="afs">
       <title>AFS</title>
 
       <para>AFS, NFS, SANs etc]</para>
 
     </chapter>
   </part>
   
   <part id="terminal">
     <title>Terminal Handling</title>
 
     <chapter id="syscons">
       <title>Syscons</title>
 
       <para>Syscons, tty, PCVT, serial console, screen savers,
         etc</para>
 
     </chapter>
   </part>
   
   <part id="sound">
     <title>Sound</title>
 
     <chapter id="oss">
       <title>OSS</title>
 
       <para>OSS, waveforms, etc</para>
 
     </chapter>
   </part>
   
   <part id="devicedrivers">
     <title>Device Drivers</title>
 
     &chap.driverbasics;
     &chap.isa;
     &chap.pci;
     &chap.scsi;
     &chap.usb;
 
     <chapter id="newbus">
       <title>NewBus</title>
 
       <para>This chapter will talk about the FreeBSD NewBus
       architecture.</para>
     </chapter>
 
   </part>
   
   <part id="architectures">
     <title>Architectures</title>
 
     &chap.x86;
 
     <chapter id="alpha">
       <title>Alpha</title>
 
       <para>Talk about the architectural specifics of
       FreeBSD/alpha.</para>
 
       <para>Explanation of allignment errors, how to fix, how to
       ignore.</para>
 
       <para>Example assembly language code for FreeBSD/alpha.</para>
     </chapter>
 
     <chapter id="ia64">
       <title>IA-64</title>
 
       <para>Talk about the architectural specifics of
       FreeBSD/ia64.</para>
 
     </chapter>
   </part>
   
   <part id="debuggingpart">
     <title>Debugging</title>
 
     <chapter id="truss">
       <title>Truss</title>
 
       <para>various descriptions on how to debug certain aspects of
         the system using truss, ktrace, gdb, kgdb, etc</para>
 
     </chapter>
   </part>
   
   <part id="compatibility">
     <title>Compatibility Layers</title>
 
     <chapter id="linux">
       <title>Linux</title>
 
       <para>Linux, SVR4, etc</para>
 
     </chapter>
   </part>
   
   <part id="appendices">
     <title>Appendices</title>
 
       <bibliography>
 
       <biblioentry id="COD" xreflabel="1">
         <authorgroup>
           <author>
             <firstname>Dave</firstname>
             <othername role="MI">A</othername>
             <surname>Patterson</surname>
           </author>
           <author>
             <firstname>John</firstname>
             <othername role="MI">L</othername>
             <surname>Hennessy</surname>
           </author>
         </authorgroup>
         <copyright><year>1998</year><holder>Morgan Kaufmann Publishers,
         Inc.</holder></copyright>
         <isbn>1-55860-428-6</isbn>
         <publisher>
           <publishername>Morgan Kaufmann Publishers, Inc.</publishername>
         </publisher>
         <title>Computer Organization and Design</title>
         <subtitle>The Hardware / Software Interface</subtitle>
         <pagenums>1-2</pagenums>
       </biblioentry>
 
       <biblioentry xreflabel="2">
         <authorgroup>
           <author>
             <firstname>W.</firstname>
             <othername role="Middle">Richard</othername>
             <surname>Stevens</surname>
           </author>
         </authorgroup>
         <copyright><year>1993</year><holder>Addison Wesley Longman,
         Inc.</holder></copyright>
         <isbn>0-201-56317-7</isbn>
         <publisher>
           <publishername>Addison Wesley Longman, Inc.</publishername>
         </publisher>
         <title>Advanced Programming in the Unix Environment</title>
         <pagenums>1-2</pagenums>
       </biblioentry>
 
       <biblioentry xreflabel="3">
         <authorgroup>
           <author>
             <firstname>Marshall</firstname>
             <othername role="Middle">Kirk</othername>
             <surname>McKusick</surname>
           </author>
           <author>
             <firstname>Keith</firstname>
             <surname>Bostic</surname>
           </author>
           <author>
             <firstname>Michael</firstname>
             <othername role="MI">J</othername>
             <surname>Karels</surname>
           </author>
           <author>
             <firstname>John</firstname>
             <othername role="MI">S</othername>
             <surname>Quarterman</surname>
           </author>
         </authorgroup>
         <copyright><year>1996</year><holder>Addison-Wesley Publishing Company,
         Inc.</holder></copyright>
         <isbn>0-201-54979-4</isbn>
         <publisher>
           <publishername>Addison-Wesley Publishing Company, Inc.</publishername>
         </publisher>
         <title>The Design and Implementation of the 4.4 BSD Operating System</title>
         <pagenums>1-2</pagenums>
       </biblioentry>
 
       <biblioentry id="Phrack" xreflabel="4">
         <authorgroup>
           <author>
             <firstname>Aleph</firstname>
             <surname>One</surname>
           </author>
         </authorgroup>
         <title>Phrack 49; "Smashing the Stack for Fun and Profit"</title>
       </biblioentry>
 
       <biblioentry id="StackGuard" xreflabel="5">
         <authorgroup>
           <author>
             <firstname>Chrispin</firstname>
             <surname>Cowan</surname>
           </author>
           <author>
             <firstname>Calton</firstname>
             <surname>Pu</surname>
           </author>
           <author>
             <firstname>Dave</firstname>
             <surname>Maier</surname>
           </author>
         </authorgroup>
         <title>StackGuard; Automatic Adaptive Detection and Prevention of
         Buffer-Overflow Attacks</title>
       </biblioentry>
 
       <biblioentry id="OpenBSD" xreflabel="6">
         <authorgroup>
 	  <author>
 	    <firstname>Todd</firstname>
 	    <surname>Miller</surname>
 	  </author>
 	  <author>
 	    <firstname>Theo</firstname>
 	    <surname>de Raadt</surname>
 	  </author>
 	</authorgroup>
 	<title>strlcpy and strlcat -- consistent, safe string copy and
 	concatenation.</title>
       </biblioentry>
 
       </bibliography>
 
   </part>
 
 </book>
diff --git a/en_US.ISO_8859-1/books/developers-handbook/book.sgml b/en_US.ISO_8859-1/books/developers-handbook/book.sgml
index f407d4c9a7..a1a485a73d 100644
--- a/en_US.ISO_8859-1/books/developers-handbook/book.sgml
+++ b/en_US.ISO_8859-1/books/developers-handbook/book.sgml
@@ -1,504 +1,517 @@
 <!--
      The FreeBSD Documentation Project
 
-     $FreeBSD: doc/en_US.ISO_8859-1/books/developers-handbook/book.sgml,v 1.16 2001/05/02 01:53:13 murray Exp $
+     $FreeBSD: doc/en_US.ISO_8859-1/books/developers-handbook/book.sgml,v 1.17 2001/05/11 10:20:33 murray Exp $
 -->
 
 <!DOCTYPE BOOK PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [
 <!ENTITY % bookinfo PUBLIC "-//FreeBSD//ENTITIES DocBook BookInfo Entities//EN">
 %bookinfo;
 <!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
 %man;
 <!ENTITY % chapters SYSTEM "chapters.ent"> %chapters;
 <!ENTITY % authors SYSTEM "../handbook/authors.ent"> %authors;
+<!ENTITY % mailing-lists SYSTEM "../handbook/mailing-lists.ent"> %mailing-lists;
 ]>
 
 <book>
   <bookinfo>
     <title>FreeBSD Developers' Handbook</title>
     
     <corpauthor>The FreeBSD Documentation Project</corpauthor>
     
     <pubdate>August 2000</pubdate>
     
     <copyright>
       <year>2000</year>
       <year>2001</year>
       <holder>The FreeBSD Documentation Project</holder>
     </copyright>
 
     &bookinfo.legalnotice;
     
     <abstract>
-      <para>Welcome to the Developers' Handbook.</para>
+      <para>Welcome to the Developers' Handbook.  This manual is a
+	<emphasis>work in progress</emphasis> and is the work of many
+	individuals.  Many sections do not yet exist and some of those
+	that do exist need to be updated.  If you are interested in
+	helping with this project, send email to the &a.doc;.  The
+	latest version of this document is always available from the
+	<ulink URL="http://www.FreeBSD.org/">FreeBSD World Wide Web
+	server</ulink>.  It may also be downloaded in a variety of
+	formats and compression options from the <ulink
+	url="ftp://ftp.FreeBSD.org/pub/FreeBSD/doc">FreeBSD FTP
+	server</ulink> or one of the numerous <ulink
+	url="http://www.freebsd.org/handbook/mirrors-ftp.html">mirror
+	sites</ulink>.</para>
     </abstract>
   </bookinfo>
   
   <part id="introduction">
     <title>Introduction</title>
 
     <chapter id="developmentplatform">
       <title>Developing on FreeBSD</title>
 
       <para>This will need to discuss FreeBSD as a development
         platform, the vision of BSD, architectural overview, layout of
         /usr/src, history, etc.</para>
 
       <para>Thank you for considering FreeBSD as your development
         platform!  We hope it will not let you down.</para>
     </chapter>
 
     <chapter id="bsdvision">
       <title>The BSD Vision</title>
 
       <para></para>
     </chapter>
 
     <chapter id="archoverview">
       <title>Architectural Overview</title>
 
       <para></para>
     </chapter>
 
     <chapter id="sourcelayout">
       <title>The Layout of /usr/src</title>
 
       <para>The complete source code to FreeBSD is available from our
       public CVS repository.  The source code is normally installed in
       <filename class=directory>/usr/src</filename> which contains the
       following subdirectories.</para>
 
       <para>
       <informaltable frame="none">
         <tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>Directory</entry>
 	      <entry>Description</entry>
 	    </row>
 	  </thead>
 	  
 	  <tbody>
 	    <row>
 	    <entry><filename class=directory>bin/</filename></entry>
             <entry>Source for files in
             <filename>/bin</filename></entry>
 	    </row>
 	    
 	    <row>
 	    <entry><filename class=directory>contrib/</filename></entry>
 	    <entry>Source for files from contributed software.</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>crypto/</filename></entry>
 	    <entry>DES source</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>etc/</filename></entry>
 	    <entry>Source for files in <filename
 	    class=directory>/etc</filename></entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>games/</filename></entry>
 	    <entry>Source for files in <filename
 	    class=directory>/usr/games</filename></entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>gnu/</filename></entry>
 	    <entry>Utilities covered by the GNU Public License</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>include/</filename></entry>
             <entry>Source for files in <filename
             class=directory>/usr/include</filename></entry>
 	    </row>
 
 	    <row>
 	    <entry><filename
  class=directory>kerberosIV/</filename></entry>
             <entry>Source for Kerbereros version IV</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename
  class=directory>kerberos5/</filename></entry>
             <entry>Source for Kerbereros version 5</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>lib/</filename></entry>
 	    <entry>Source for files in <filename
 	    class=directory>/usr/lib</filename></entry>
 	    </row>
 	    
 	    <row>
 	    <entry><filename class=directory>libexec/</filename></entry>
 	    <entry>Source for files in <filename
 	    class=directory>/usr/libexec</filename></entry>
 	    </row>
 	    
 	    <row>
 	    <entry><filename
  class=directory>release/</filename></entry>
             <entry>Files required to produce a FreeBSD release</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>sbin/</filename></entry>
 	    <entry>Source for files in <filename
 	    class=directory>/sbin</filename></entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>secure/</filename></entry>
 	    <entry>FreeSec sources</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>share/</filename></entry>
 	    <entry>Source for files in <filename
 	    class=directory>/sbin</filename></entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>sys/</filename></entry>
 	    <entry>Kernel source files</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename class=directory>tools/</filename></entry>
 	    <entry>Tools used for maintenance and testing of
 	    FreeBSD</entry>
 	    </row>
 
 	    <row>
 	    <entry><filename
  class=directory>usr.bin/</filename></entry>
             <entry>Source for files in <filename
  class=directory>/usr/bin</filename></entry>
             </row>
 
 	    <row>
 	    <entry><filename
  class=directory>usr.sbin/</filename></entry>
             <entry>Source for files in <filename
  class=directory>/usr/sbin</filename></entry>
             </row>
           </tbody>
 	</tgroup>
       </informaltable>
 
       </para>
 
     </chapter>
   </part>
 
   <part id="Basics">
     <title>Basics</title>
 
     &chap.tools;
     &chap.secure;
 
   </part>
 
   <part id="kernel">
     <title>Kernel</title>
 
     <chapter id="kernelhistory">
       <title>History of the Unix Kernel</title>
 
       <para>Some history of the Unix/BSD kernel, system calls, how do
         processes work, blocking, scheduling, threads (kernel),
         context switching, signals, interrupts, modules, etc.</para>
 
       <para></para>
     </chapter>
 
     &chap.locking;
 
   </part>
 
   <part id="memory">
     <title>Memory and Virtual Memory</title>
 
     <chapter id="virtualmemory">
       <title>Virtual Memory</title>
 
       <para>VM, paging, swapping, allocating memory, testing for
         memory leaks, mmap, vnodes, etc.</para>
 
       <para></para>
     </chapter>
   </part>
 
   <part id="iosystem">
     <title>I/O System</title>
 
     <chapter id="ufs">
       <title>UFS</title>
 
       <para>UFS, FFS, Ext2FS, JFS, inodes, buffer cache, labeling,
         locking, metadata, soft-updates, LFS, portalfs, procfs,
         vnodes, memory sharing, memory objects, TLBs, caching</para>
 
     </chapter>
   </part>
 
   <part id="ipc">
     <title>Interprocess Communication</title>
     
     <chapter id="signals">
       <title>Signals</title>
 
       <para>Signals, pipes, semaphores, message queues, shared memory,
         ports, sockets, doors</para>
 
     </chapter>
   </part>
 
   <part id="networking">
     <title>Networking</title>
     
     <chapter id="sockets">
       <title>Sockets</title>
 
       <para>Sockets, bpf, IP, TCP, UDP, ICMP, OSI, bridging,
         firewalling, NAT, switching, etc</para>
 
     </chapter>
   </part>
   
   <part id="networkfs">
     <title>Network Filesystems</title>
 
     <chapter id="afs">
       <title>AFS</title>
 
       <para>AFS, NFS, SANs etc]</para>
 
     </chapter>
   </part>
   
   <part id="terminal">
     <title>Terminal Handling</title>
 
     <chapter id="syscons">
       <title>Syscons</title>
 
       <para>Syscons, tty, PCVT, serial console, screen savers,
         etc</para>
 
     </chapter>
   </part>
   
   <part id="sound">
     <title>Sound</title>
 
     <chapter id="oss">
       <title>OSS</title>
 
       <para>OSS, waveforms, etc</para>
 
     </chapter>
   </part>
   
   <part id="devicedrivers">
     <title>Device Drivers</title>
 
     &chap.driverbasics;
     &chap.isa;
     &chap.pci;
     &chap.scsi;
     &chap.usb;
 
     <chapter id="newbus">
       <title>NewBus</title>
 
       <para>This chapter will talk about the FreeBSD NewBus
       architecture.</para>
     </chapter>
 
   </part>
   
   <part id="architectures">
     <title>Architectures</title>
 
     &chap.x86;
 
     <chapter id="alpha">
       <title>Alpha</title>
 
       <para>Talk about the architectural specifics of
       FreeBSD/alpha.</para>
 
       <para>Explanation of allignment errors, how to fix, how to
       ignore.</para>
 
       <para>Example assembly language code for FreeBSD/alpha.</para>
     </chapter>
 
     <chapter id="ia64">
       <title>IA-64</title>
 
       <para>Talk about the architectural specifics of
       FreeBSD/ia64.</para>
 
     </chapter>
   </part>
   
   <part id="debuggingpart">
     <title>Debugging</title>
 
     <chapter id="truss">
       <title>Truss</title>
 
       <para>various descriptions on how to debug certain aspects of
         the system using truss, ktrace, gdb, kgdb, etc</para>
 
     </chapter>
   </part>
   
   <part id="compatibility">
     <title>Compatibility Layers</title>
 
     <chapter id="linux">
       <title>Linux</title>
 
       <para>Linux, SVR4, etc</para>
 
     </chapter>
   </part>
   
   <part id="appendices">
     <title>Appendices</title>
 
       <bibliography>
 
       <biblioentry id="COD" xreflabel="1">
         <authorgroup>
           <author>
             <firstname>Dave</firstname>
             <othername role="MI">A</othername>
             <surname>Patterson</surname>
           </author>
           <author>
             <firstname>John</firstname>
             <othername role="MI">L</othername>
             <surname>Hennessy</surname>
           </author>
         </authorgroup>
         <copyright><year>1998</year><holder>Morgan Kaufmann Publishers,
         Inc.</holder></copyright>
         <isbn>1-55860-428-6</isbn>
         <publisher>
           <publishername>Morgan Kaufmann Publishers, Inc.</publishername>
         </publisher>
         <title>Computer Organization and Design</title>
         <subtitle>The Hardware / Software Interface</subtitle>
         <pagenums>1-2</pagenums>
       </biblioentry>
 
       <biblioentry xreflabel="2">
         <authorgroup>
           <author>
             <firstname>W.</firstname>
             <othername role="Middle">Richard</othername>
             <surname>Stevens</surname>
           </author>
         </authorgroup>
         <copyright><year>1993</year><holder>Addison Wesley Longman,
         Inc.</holder></copyright>
         <isbn>0-201-56317-7</isbn>
         <publisher>
           <publishername>Addison Wesley Longman, Inc.</publishername>
         </publisher>
         <title>Advanced Programming in the Unix Environment</title>
         <pagenums>1-2</pagenums>
       </biblioentry>
 
       <biblioentry xreflabel="3">
         <authorgroup>
           <author>
             <firstname>Marshall</firstname>
             <othername role="Middle">Kirk</othername>
             <surname>McKusick</surname>
           </author>
           <author>
             <firstname>Keith</firstname>
             <surname>Bostic</surname>
           </author>
           <author>
             <firstname>Michael</firstname>
             <othername role="MI">J</othername>
             <surname>Karels</surname>
           </author>
           <author>
             <firstname>John</firstname>
             <othername role="MI">S</othername>
             <surname>Quarterman</surname>
           </author>
         </authorgroup>
         <copyright><year>1996</year><holder>Addison-Wesley Publishing Company,
         Inc.</holder></copyright>
         <isbn>0-201-54979-4</isbn>
         <publisher>
           <publishername>Addison-Wesley Publishing Company, Inc.</publishername>
         </publisher>
         <title>The Design and Implementation of the 4.4 BSD Operating System</title>
         <pagenums>1-2</pagenums>
       </biblioentry>
 
       <biblioentry id="Phrack" xreflabel="4">
         <authorgroup>
           <author>
             <firstname>Aleph</firstname>
             <surname>One</surname>
           </author>
         </authorgroup>
         <title>Phrack 49; "Smashing the Stack for Fun and Profit"</title>
       </biblioentry>
 
       <biblioentry id="StackGuard" xreflabel="5">
         <authorgroup>
           <author>
             <firstname>Chrispin</firstname>
             <surname>Cowan</surname>
           </author>
           <author>
             <firstname>Calton</firstname>
             <surname>Pu</surname>
           </author>
           <author>
             <firstname>Dave</firstname>
             <surname>Maier</surname>
           </author>
         </authorgroup>
         <title>StackGuard; Automatic Adaptive Detection and Prevention of
         Buffer-Overflow Attacks</title>
       </biblioentry>
 
       <biblioentry id="OpenBSD" xreflabel="6">
         <authorgroup>
 	  <author>
 	    <firstname>Todd</firstname>
 	    <surname>Miller</surname>
 	  </author>
 	  <author>
 	    <firstname>Theo</firstname>
 	    <surname>de Raadt</surname>
 	  </author>
 	</authorgroup>
 	<title>strlcpy and strlcat -- consistent, safe string copy and
 	concatenation.</title>
       </biblioentry>
 
       </bibliography>
 
   </part>
 
 </book>