Whitespace-only changes. Fix indentation, trailing whitespace,

blank lines, rewrap paragraphs.
This commit is contained in:
Warren Block 2012-04-02 15:42:38 +00:00
parent 1211b57ee0
commit 1c3a3f8502
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=38640

View file

@ -33,7 +33,6 @@
profession. The information in this chapter might be aimed profession. The information in this chapter might be aimed
toward the beginning programmer; indeed, it could serve useful toward the beginning programmer; indeed, it could serve useful
for the programmer unfamiliar with the &os; platform.</para> for the programmer unfamiliar with the &os; platform.</para>
</sect1> </sect1>
<sect1 id="introduction-bsdvision"> <sect1 id="introduction-bsdvision">
@ -53,38 +52,45 @@
<itemizedlist> <itemizedlist>
<listitem><para>Do not add new functionality unless an <listitem>
implementor cannot complete a real application without <para>Do not add new functionality unless an implementor
it.</para></listitem> cannot complete a real application without it.</para>
</listitem>
<listitem><para>It is as important to decide what a system is <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 not as to decide what it is. Do not serve all the world's
needs; rather, make the system extensible so that additional needs; rather, make the system extensible so that additional
needs can be met in an upwardly compatible needs can be met in an upwardly compatible
fashion.</para></listitem> fashion.</para>
</listitem>
<listitem><para>The only thing worse than generalizing from one <listitem>
example is generalizing from no examples at <para>The only thing worse than generalizing from one example
all. </para></listitem> is generalizing from no examples at all.</para>
</listitem>
<listitem><para>If a problem is not completely understood, it is <listitem>
probably best to provide no solution at all.</para></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 <listitem>
for 10 percent of the work, use the simpler <para>If you can get 90 percent of the desired effect for 10
solution.</para></listitem> percent of the work, use the simpler solution.</para>
</listitem>
<listitem><para>Isolate complexity as much as <listitem>
possible.</para></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>
<listitem>
<para>Provide mechanism, rather than policy. In particular,
place user interface policy in the client's hands.</para>
</listitem>
</itemizedlist> </itemizedlist>
<para>From Scheifler & Gettys: "X Window System"</para> <para>From Scheifler & Gettys: "X Window System"</para>
</sect1> </sect1>
<sect1 id="introduction-layout"> <sect1 id="introduction-layout">
@ -93,8 +99,8 @@
<para>The complete source code to FreeBSD is available from our <para>The complete source code to FreeBSD is available from our
public repository. The source code is normally installed in public repository. The source code is normally installed in
<filename class="directory">/usr/src</filename> which contains the <filename class="directory">/usr/src</filename> which contains
following subdirectories:</para> the following subdirectories:</para>
<para> <para>
<informaltable frame="none" pgwide="1"> <informaltable frame="none" pgwide="1">
@ -108,46 +114,56 @@
<tbody> <tbody>
<row> <row>
<entry><filename class="directory">bin/</filename></entry> <entry><filename
class="directory">bin/</filename></entry>
<entry>Source for files in <entry>Source for files in
<filename>/bin</filename></entry> <filename>/bin</filename></entry>
</row> </row>
<row> <row>
<entry><filename class="directory">cddl/</filename></entry> <entry><filename
class="directory">cddl/</filename></entry>
<entry>Utilities covered by the Common Development and <entry>Utilities covered by the Common Development and
Distribution License</entry> Distribution License</entry>
</row> </row>
<row> <row>
<entry><filename class="directory">contrib/</filename></entry> <entry><filename
<entry>Source for files from contributed software.</entry> class="directory">contrib/</filename></entry>
<entry>Source for files from contributed
software.</entry>
</row> </row>
<row> <row>
<entry><filename class="directory">crypto/</filename></entry> <entry><filename
class="directory">crypto/</filename></entry>
<entry>Cryptographical sources</entry> <entry>Cryptographical sources</entry>
</row> </row>
<row> <row>
<entry><filename class="directory">etc/</filename></entry> <entry><filename
class="directory">etc/</filename></entry>
<entry>Source for files in <filename <entry>Source for files in <filename
class="directory">/etc</filename></entry> class="directory">/etc</filename></entry>
</row> </row>
<row> <row>
<entry><filename class="directory">games/</filename></entry> <entry><filename
class="directory">games/</filename></entry>
<entry>Source for files in <filename <entry>Source for files in <filename
class="directory">/usr/games</filename></entry> class="directory">/usr/games</filename></entry>
</row> </row>
<row> <row>
<entry><filename class="directory">gnu/</filename></entry> <entry><filename
<entry>Utilities covered by the GNU Public License</entry> class="directory">gnu/</filename></entry>
<entry>Utilities covered by the GNU Public
License</entry>
</row> </row>
<row> <row>
<entry><filename class="directory">include/</filename></entry> <entry><filename
class="directory">include/</filename></entry>
<entry>Source for files in <filename <entry>Source for files in <filename
class="directory">/usr/include</filename></entry> class="directory">/usr/include</filename></entry>
</row> </row>
@ -159,13 +175,15 @@
</row> </row>
<row> <row>
<entry><filename class="directory">lib/</filename></entry> <entry><filename
class="directory">lib/</filename></entry>
<entry>Source for files in <filename <entry>Source for files in <filename
class="directory">/usr/lib</filename></entry> class="directory">/usr/lib</filename></entry>
</row> </row>
<row> <row>
<entry><filename class="directory">libexec/</filename></entry> <entry><filename
class="directory">libexec/</filename></entry>
<entry>Source for files in <filename <entry>Source for files in <filename
class="directory">/usr/libexec</filename></entry> class="directory">/usr/libexec</filename></entry>
</row> </row>
@ -173,39 +191,47 @@
<row> <row>
<entry><filename <entry><filename
class="directory">release/</filename></entry> class="directory">release/</filename></entry>
<entry>Files required to produce a FreeBSD release</entry> <entry>Files required to produce a FreeBSD
release</entry>
</row> </row>
<row> <row>
<entry><filename class="directory">rescue/</filename></entry> <entry><filename
class="directory">rescue/</filename></entry>
<entry>Build system for the <entry>Build system for the
<filename class="directory">/rescue</filename> utilities</entry> <filename class="directory">/rescue</filename>
utilities</entry>
</row> </row>
<row> <row>
<entry><filename class="directory">sbin/</filename></entry> <entry><filename
class="directory">sbin/</filename></entry>
<entry>Source for files in <filename <entry>Source for files in <filename
class="directory">/sbin</filename></entry> class="directory">/sbin</filename></entry>
</row> </row>
<row> <row>
<entry><filename class="directory">secure/</filename></entry> <entry><filename
class="directory">secure/</filename></entry>
<entry>FreeSec sources</entry> <entry>FreeSec sources</entry>
</row> </row>
<row> <row>
<entry><filename class="directory">share/</filename></entry> <entry><filename
class="directory">share/</filename></entry>
<entry>Source for files in <filename <entry>Source for files in <filename
class="directory">/usr/share</filename></entry> class="directory">/usr/share</filename></entry>
</row> </row>
<row> <row>
<entry><filename class="directory">sys/</filename></entry> <entry><filename
class="directory">sys/</filename></entry>
<entry>Kernel source files</entry> <entry>Kernel source files</entry>
</row> </row>
<row> <row>
<entry><filename class="directory">tools/</filename></entry> <entry><filename
class="directory">tools/</filename></entry>
<entry>Tools used for maintenance and testing of <entry>Tools used for maintenance and testing of
FreeBSD</entry> FreeBSD</entry>
</row> </row>
@ -225,7 +251,6 @@
</row> </row>
</tbody> </tbody>
</tgroup> </tgroup>
</informaltable> </informaltable></para>
</para>
</sect1> </sect1>
</chapter> </chapter>