Whitespace-only changes. Fix indentation, trailing whitespace,
blank lines, rewrap paragraphs.
This commit is contained in:
parent
1211b57ee0
commit
1c3a3f8502
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=38640
1 changed files with 127 additions and 102 deletions
|
@ -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>
|
||||||
|
|
Loading…
Reference in a new issue