Reorganize the Developer's Handbook.

* Add chapter on kernel debugging (repo-copied from the Handbook)
  * Change "Introduction" part with 4 empty chapters to a
    "Introduction" chapter with 4 mostly empty <sect1>s.
  * Combine many of the different <part>s that contain only one empty
    <chapter> into larger <part>s.
  * Add * in front of unfinished chapter names so its very clear what
    needs to be worked on.
  * Added some <filename> tags where appropriate.
This commit is contained in:
Murray Stokely 2001-07-19 22:06:06 +00:00
parent 474756bf03
commit d78ef2bfe3
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=9977
8 changed files with 307 additions and 541 deletions

View file

@ -0,0 +1,168 @@
<!--
The FreeBSD Documentation Project
$FreeBSD$
-->
<chapter id="introduction">
<title>Introduction</title>
<para>This chapter was written by &a.murray;.</para>
<sect1>
<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>
</sect1>
<sect1>
<title>* The BSD Vision</title>
<para></para>
</sect1>
<sect1>
<title>* Architectural Overview</title>
<para></para>
</sect1>
<sect1>
<title>The Layout of <filename class="directory">/usr/src</filename></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>
</sect1>
</chapter>