README revision 50479 
11573SrgrimesThis is the top level of the FreeBSD source directory.  This file
21573Srgrimeswas last revised on:
31573Srgrimes$FreeBSD: head/README 50479 1999-08-28 01:35:59Z peter $
41573Srgrimes
51573SrgrimesFor copyright information, please see the file COPYRIGHT in this
61573Srgrimesdirectory (additional copyright information also exists for some
71573Srgrimessources in this tree - please see the specific source directories for
81573Srgrimesmore information).
91573Srgrimes
101573SrgrimesThe Makefile in this directory supports a number of targets for
111573Srgrimesbuilding components (or all) of the FreeBSD source tree, the most
121573Srgrimescommonly used one being ``world'', which rebuilds and installs
131573Srgrimeseverything in the FreeBSD system from the source tree except the
141573Srgrimeskernel and the contents of /etc.  Please see the top of the Makefile
151573Srgrimesin this directory for more information on the standard build targets
161573Srgrimesand compile-time flags.
171573Srgrimes
181573SrgrimesBuilding a kernel with config(8) is a somewhat more involved process,
191573Srgrimesdocumentation for which can be found at:
201573Srgrimes   http://www.freebsd.org/handbook/kernelconfig.html
211573SrgrimesAnd in the config(8) man page.
221573Srgrimes
231573SrgrimesThe sample kernel configuration files reside in the sys/i386/conf
241573Srgrimessub-directory (assuming that you've installed the kernel sources), the
251573Srgrimesfile named GENERIC being the one used to build your initial installation
261573Srgrimeskernel.  The file LINT contains entries for all possible devices, not
271573Srgrimesjust those commonly used, and is meant more as a general reference
281573Srgrimesthan an actual kernel configuration file (a kernel built from it
291573Srgrimeswouldn't even run).
301573Srgrimes
311573Srgrimes
321573SrgrimesSource Roadmap:
3385422Sasmodai---------------
3485422Sasmodaibin		System/User commands.
3585422Sasmodai
361573Srgrimescontrib		Packages contributed by 3rd parties.
371573Srgrimes
381573Srgrimescrypto		Export controlled stuff (see crypto/README).
391573Srgrimes
401573Srgrimesetc		Template files for /etc
4185607Smike
4285607Smikegames		Amusements.
4385605Smike
4485605Smikegnu		Various commands and libraries under the GNU Public License.
451573Srgrimes		Please see gnu/COPYING* for more information.
4685607Smike
4785607Smikeinclude		System include files.
4885671Smike
4985607SmikekerberosIV	Kerberos package.
5085607Smike
5185607Smikelib		System libraries.
5285671Smike
5385607Smikelibexec		System daemons.
541573Srgrimes
551573Srgrimesrelease		Release building Makefile & associated tools.
561573Srgrimes
57sbin		System commands.
58
59secure		DES and DES-related utilities - NOT FOR EXPORT!
60
61share		Shared resources.
62
63sys		Kernel sources.
64
65tools		Utilities for regression testing and miscellaneous tasks.
66
67usr.bin		User commands.
68
69usr.sbin	System administration commands.
70
71
72For information on synchronizing your source tree with one or more of
73the FreeBSD Project's development branches, please see:
74
75  http://www.freebsd.org/handbook/synching.html
76