diff --git a/en_US.ISO8859-1/books/developers-handbook/introduction/chapter.sgml b/en_US.ISO8859-1/books/developers-handbook/introduction/chapter.sgml
index 94cc1f5291..161ef53a8e 100644
--- a/en_US.ISO8859-1/books/developers-handbook/introduction/chapter.sgml
+++ b/en_US.ISO8859-1/books/developers-handbook/introduction/chapter.sgml
@@ -8,13 +8,13 @@
- Murray
- Stokely
- Contributed by
+ Murray
+ Stokely
+ Contributed by
- Jeroen
- Ruigrok van der Werven
+ Jeroen
+ Ruigrok van der Werven
@@ -33,7 +33,6 @@
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.
-
@@ -44,188 +43,214 @@
ideology as well as usability, performance and
stability.
-
+
Architectural Guidelines
Our ideology can be described by the following
- guidelines
+ guidelines
- Do not add new functionality unless an
- implementor cannot complete a real application without
- it.
+
+ Do not add new functionality unless an implementor
+ cannot complete a real application without it.
+
- 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.
+
+ 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.
+
- The only thing worse than generalizing from one
- example is generalizing from no examples at
- all.
+
+ The only thing worse than generalizing from one example
+ is generalizing from no examples at all.
+
- If a problem is not completely understood, it is
- probably best to provide no solution at all.
+
+ If a problem is not completely understood, it is
+ probably best to provide no solution at all.
+
- If you can get 90 percent of the desired effect
- for 10 percent of the work, use the simpler
- solution.
+
+ If you can get 90 percent of the desired effect for 10
+ percent of the work, use the simpler solution.
+
- Isolate complexity as much as
- possible.
+
+ Isolate complexity as much as possible.
+
- Provide mechanism, rather than policy. In
- particular, place user interface policy in the client's
- hands.
-
-
-
- From Scheifler & Gettys: "X Window System"
+
+ Provide mechanism, rather than policy. In particular,
+ place user interface policy in the client's hands.
+
+
+ From Scheifler & Gettys: "X Window System"
- The Layout of
+ The Layout of
/usr/src
The complete source code to FreeBSD is available from our
public repository. The source code is normally installed in
- /usr/src which contains the
- following subdirectories:
+ /usr/src which contains
+ the following subdirectories:
-
+
Directory
Description
-
+
- bin/
- Source for files in
- /bin
+ bin/
+ Source for files in
+ /bin
-
+
- cddl/
+ cddl/
Utilities covered by the Common Development and
Distribution License
- contrib/
- Source for files from contributed software.
+ contrib/
+ Source for files from contributed
+ software.
- crypto/
- Cryptographical sources
+ crypto/
+ Cryptographical sources
- etc/
- Source for files in /etc
+ etc/
+ Source for files in /etc
- games/
- Source for files in /usr/games
+ games/
+ Source for files in /usr/games
- gnu/
- Utilities covered by the GNU Public License
+ gnu/
+ Utilities covered by the GNU Public
+ License
- include/
- Source for files in /usr/include
+ include/
+ Source for files in /usr/include
- kerberos5/
- Source for Kerberos version 5
+ kerberos5/
+ Source for Kerberos version 5
- lib/
- Source for files in /usr/lib
-
-
-
- libexec/
- Source for files in /usr/libexec
+ lib/
+ Source for files in /usr/lib
- release/
- Files required to produce a FreeBSD release
+ libexec/
+ Source for files in /usr/libexec
- rescue/
- Build system for the
- /rescue utilities
+ release/
+ Files required to produce a FreeBSD
+ release
- sbin/
- Source for files in /sbin
+ rescue/
+ Build system for the
+ /rescue
+ utilities
- secure/
- FreeSec sources
+ sbin/
+ Source for files in /sbin
- share/
- Source for files in /usr/share
+ secure/
+ FreeSec sources
- sys/
- Kernel source files
+ share/
+ Source for files in /usr/share
- tools/
- Tools used for maintenance and testing of
- FreeBSD
+ sys/
+ Kernel source files
- usr.bin/
- Source for files in /usr/bin
-
+ tools/
+ Tools used for maintenance and testing of
+ FreeBSD
+
- usr.sbin/
- Source for files in /usr/sbin
-
-
+ usr.bin/
+ Source for files in /usr/bin
+
+
+
+ usr.sbin/
+ Source for files in /usr/sbin
+
+
-
-
+