Index: head/en_US.ISO8859-1/books/developers-handbook/book.xml
===================================================================
--- head/en_US.ISO8859-1/books/developers-handbook/book.xml	(revision 51937)
+++ head/en_US.ISO8859-1/books/developers-handbook/book.xml	(revision 51938)
@@ -1,189 +1,190 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!DOCTYPE book PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
 	"http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd" [
 <!ENTITY % chapters SYSTEM "chapters.ent"> %chapters;
 ]>
 <!--
      The FreeBSD Documentation Project
 
      $FreeBSD$
 -->
 <book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en">
   <info><title>FreeBSD Developers' Handbook</title>
     
 
     <author><orgname>The FreeBSD Documentation Project</orgname></author>
 
     <pubdate>$FreeBSD$</pubdate>
 
     <copyright>
       <year>2000</year>
       <year>2001</year>
       <year>2002</year>
       <year>2003</year>
       <year>2004</year>
       <year>2005</year>
       <year>2006</year>
       <year>2007</year>
       <year>2008</year>
       <year>2009</year>
       <year>2010</year>
       <year>2011</year>
       <year>2012</year>
       <year>2013</year>
       <year>2014</year>
       <year>2015</year>
       <year>2016</year>
       <year>2017</year>
+      <year>2018</year>
       <holder>The FreeBSD Documentation Project</holder>
     </copyright>
 
     &legalnotice;
 
     <legalnotice xml:id="trademarks" role="trademarks">
       &tm-attrib.freebsd;
       &tm-attrib.apple;
       &tm-attrib.ibm;
       &tm-attrib.ieee;
       &tm-attrib.intel;
       &tm-attrib.linux;
       &tm-attrib.microsoft;
       &tm-attrib.opengroup;
       &tm-attrib.sun;
       &tm-attrib.general;
     </legalnotice>
 
     <releaseinfo>$FreeBSD$</releaseinfo>
 
     <abstract>
       <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;.</para>
 
       <para>The latest version of this document is always available
         from the <link xlink:href="&url.base;/index.html">FreeBSD World
         Wide Web server</link>.  It may also be downloaded in a
         variety of formats and compression options from the <link xlink:href="https://download.freebsd.org/ftp/doc/">FreeBSD FTP
         server</link> or one of the numerous <link xlink:href="&url.books.handbook;/mirrors-ftp.html">mirror
         sites</link>.</para>
     </abstract>
   </info>
 
   <part xml:id="Basics">
     <title>Basics</title>
 
     &chap.introduction;
     &chap.tools;
     &chap.secure;
     &chap.l10n;
     &chap.policies;
     &chap.testing;
   </part>
 
   <part xml:id="ipc">
     <title>Interprocess Communication</title>
 
     &chap.sockets;
     &chap.ipv6;
 
   </part>
 
   <part xml:id="kernel">
     <title>Kernel</title>
 
     &chap.kernelbuild;
     &chap.kerneldebug;
 
   </part>
 
   <part xml:id="architectures">
     <title>Architectures</title>
 
     &chap.x86;
 
   </part>
 
   <part xml:id="appendices">
     <title>Appendices</title>
 
       <bibliography>
 
       <biblioentry xml:id="COD" xreflabel="1">
         <authorgroup>
           <author><personname><firstname>Dave</firstname><othername role="MI">A</othername><surname>Patterson</surname></personname></author>
           <author><personname><firstname>John</firstname><othername role="MI">L</othername><surname>Hennessy</surname></personname></author>
         </authorgroup>
         <copyright><year>1998</year><holder>Morgan Kaufmann Publishers,
         Inc.</holder></copyright>
         <biblioid class="isbn">1-55860-428-6</biblioid>
         <publisher>
           <publishername>Morgan Kaufmann Publishers, Inc.</publishername>
         </publisher>
         <citetitle>Computer Organization and Design</citetitle>
         <subtitle>The Hardware / Software Interface</subtitle>
         <pagenums>1-2</pagenums>
       </biblioentry>
 
       <biblioentry xreflabel="2">
         <authorgroup>
           <author><personname><firstname>W.</firstname><othername role="Middle">Richard</othername><surname>Stevens</surname></personname></author>
         </authorgroup>
         <copyright><year>1993</year><holder>Addison Wesley Longman,
         Inc.</holder></copyright>
         <biblioid class="isbn">0-201-56317-7</biblioid>
         <publisher>
           <publishername>Addison Wesley Longman, Inc.</publishername>
         </publisher>
         <citetitle>Advanced Programming in the Unix Environment</citetitle>
         <pagenums>1-2</pagenums>
       </biblioentry>
 
       <biblioentry xreflabel="3">
         <authorgroup>
           <author><personname><firstname>Marshall</firstname><othername role="Middle">Kirk</othername><surname>McKusick</surname></personname></author>
           <author><personname><firstname>George</firstname><surname>Neville-Neil</surname></personname></author>
         </authorgroup>
         <copyright><year>2004</year><holder>Addison-Wesley</holder></copyright>
         <biblioid class="isbn">0-201-70245-2</biblioid>
         <publisher>
           <publishername>Addison-Wesley</publishername>
         </publisher>
         <citetitle>The Design and Implementation of the FreeBSD Operating System</citetitle>
         <pagenums>1-2</pagenums>
       </biblioentry>
 
       <biblioentry xml:id="Phrack" xreflabel="4">
         <authorgroup>
           <author><personname><firstname>Aleph</firstname><surname>One</surname></personname></author>
         </authorgroup>
         <citetitle>Phrack 49; "Smashing the Stack for Fun and Profit"</citetitle>
       </biblioentry>
 
       <biblioentry xml:id="StackGuard" xreflabel="5">
         <authorgroup>
           <author><personname><firstname>Chrispin</firstname><surname>Cowan</surname></personname></author>
           <author><personname><firstname>Calton</firstname><surname>Pu</surname></personname></author>
           <author><personname><firstname>Dave</firstname><surname>Maier</surname></personname></author>
         </authorgroup>
         <citetitle>StackGuard; Automatic Adaptive Detection and Prevention of
         Buffer-Overflow Attacks</citetitle>
       </biblioentry>
 
       <biblioentry xml:id="OpenBSD" xreflabel="6">
         <authorgroup>
 	  <author><personname><firstname>Todd</firstname><surname>Miller</surname></personname></author>
 	  <author><personname><firstname>Theo</firstname><surname>de Raadt</surname></personname></author>
 	</authorgroup>
 	<citetitle>strlcpy and strlcat -- consistent, safe string copy and
 	concatenation.</citetitle>
       </biblioentry>
 
       </bibliography>
 
   </part>
 
   &chap.index;
 
 </book>
Index: head/en_US.ISO8859-1/books/developers-handbook/introduction/chapter.xml
===================================================================
--- head/en_US.ISO8859-1/books/developers-handbook/introduction/chapter.xml	(revision 51937)
+++ head/en_US.ISO8859-1/books/developers-handbook/introduction/chapter.xml	(revision 51938)
@@ -1,225 +1,220 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!--
      The FreeBSD Documentation Project
 
      $FreeBSD$
 -->
 <chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="introduction">
   <info><title>Introduction</title>
     <authorgroup>
       <author><personname><firstname>Murray</firstname><surname>Stokely</surname></personname><contrib>Contributed by </contrib></author>
       <author><personname><firstname>Jeroen</firstname><surname>Ruigrok van der Werven</surname></personname></author>
     </authorgroup>
   </info>
   
 
   <sect1 xml:id="introduction-devel">
     <title>Developing on FreeBSD</title>
 
     <para>So here we are.  System all installed and you are ready to
       start programming.  But where to start?  What does FreeBSD
       provide?  What can it do for me, as a programmer?</para>
 
     <para>These are some questions which this chapter tries to answer.
       Of course, programming has different levels of proficiency like
       any other trade.  For some it is a hobby, for others it is their
       profession.  The information in this chapter might be aimed
       toward the beginning programmer; indeed, it could serve useful
       for the programmer unfamiliar with the &os; platform.</para>
   </sect1>
 
   <sect1 xml:id="introduction-bsdvision">
     <title>The BSD Vision</title>
 
     <para>To produce the best &unix; like operating system package
       possible, with due respect to the original software tools
       ideology as well as usability, performance and
       stability.</para>
   </sect1>
 
   <sect1 xml:id="introduction-archguide">
     <title>Architectural Guidelines</title>
 
     <para>Our ideology can be described by the following
       guidelines</para>
 
     <itemizedlist>
 
       <listitem>
 	<para>Do not add new functionality unless an implementor
 	  cannot complete a real application without it.</para>
       </listitem>
 
       <listitem>
 	<para>It is as important to decide what a system is
 	  not as to decide what it is.  Do not serve all the world's
 	  needs; rather, make the system extensible so that additional
 	  needs can be met in an upwardly compatible
 	  fashion.</para>
       </listitem>
 
       <listitem>
 	<para>The only thing worse than generalizing from one example
 	  is generalizing from no examples at all.</para>
       </listitem>
 
       <listitem>
 	<para>If a problem is not completely understood, it is
 	  probably best to provide no solution at all.</para>
       </listitem>
 
       <listitem>
 	<para>If you can get 90 percent of the desired effect for 10
 	  percent of the work, use the simpler solution.</para>
       </listitem>
 
       <listitem>
 	<para>Isolate complexity as much as possible.</para>
       </listitem>
 
       <listitem>
 	<para>Provide mechanism, rather than policy.  In particular,
 	  place user interface policy in the client's hands.</para>
       </listitem>
     </itemizedlist>
 
     <para>From Scheifler &amp; Gettys: "X Window System"</para>
   </sect1>
 
   <sect1 xml:id="introduction-layout">
     <title>The Layout of
       <filename>/usr/src</filename></title>
 
     <para>The complete source code to FreeBSD is available from our
       public repository.  The source code is normally installed in
       <filename>/usr/src</filename> which contains
       the following subdirectories:</para>
 
     <para>
       <informaltable frame="none" pgwide="1">
 	<tgroup cols="2">
 	  <thead>
 	    <row>
 	      <entry>Directory</entry>
 	      <entry>Description</entry>
 	    </row>
 	  </thead>
 
 	  <tbody>
 	    <row>
 	      <entry><filename>bin/</filename></entry>
 	      <entry>Source for files in
 		<filename>/bin</filename></entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>cddl/</filename></entry>
 	      <entry>Utilities covered by the Common Development and
 		Distribution License</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>contrib/</filename></entry>
 	      <entry>Source for files from contributed
 		software.</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>crypto/</filename></entry>
 	      <entry>Cryptographical sources</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>etc/</filename></entry>
 	      <entry>Source for files in <filename>/etc</filename></entry>
 	    </row>
 
 	    <row>
-	      <entry><filename>games/</filename></entry>
-	      <entry>Source for files in <filename>/usr/games</filename></entry>
-	    </row>
-
-	    <row>
 	      <entry><filename>gnu/</filename></entry>
 	      <entry>Utilities covered by the GNU Public
 		License</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>include/</filename></entry>
 	      <entry>Source for files in <filename>/usr/include</filename></entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>kerberos5/</filename></entry>
 	      <entry>Source for Kerberos version 5</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>lib/</filename></entry>
 	      <entry>Source for files in <filename>/usr/lib</filename></entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>libexec/</filename></entry>
 	      <entry>Source for files in <filename>/usr/libexec</filename></entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>release/</filename></entry>
 	      <entry>Files required to produce a FreeBSD
 		release</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>rescue/</filename></entry>
 	      <entry>Build system for the
 		<filename>/rescue</filename>
 		utilities</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>sbin/</filename></entry>
 	      <entry>Source for files in <filename>/sbin</filename></entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>secure/</filename></entry>
-	      <entry>FreeSec sources</entry>
+	      <entry>Contributed cryptographic sources</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>share/</filename></entry>
 	      <entry>Source for files in <filename>/usr/share</filename></entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>sys/</filename></entry>
 	      <entry>Kernel source files</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>tests/</filename></entry>
 	      <entry>The &os; test suite</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>tools/</filename></entry>
 	      <entry>Tools used for maintenance and testing of
 		FreeBSD</entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>usr.bin/</filename></entry>
 	      <entry>Source for files in <filename>/usr/bin</filename></entry>
 	    </row>
 
 	    <row>
 	      <entry><filename>usr.sbin/</filename></entry>
 	      <entry>Source for files in <filename>/usr/sbin</filename></entry>
 	    </row>
 	  </tbody>
 	</tgroup>
       </informaltable></para>
   </sect1>
 </chapter>