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 + <title>The Layout of <filename class="directory">/usr/src</filename> 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 + + - - +