README revision 28014
121173SjkhThis is the top level of the FreeBSD source directory.  This file
228014Sjkhwas last revised on: $Id: README,v 1.10 1997/02/23 09:18:39 peter Exp $
321173Sjkh
421173SjkhFor copyright information, please see the file COPYRIGHT in this
521173Sjkhdirectory (additional copyright information also exists for some
621173Sjkhsources in this tree - please see the specific source directories for
721173Sjkhmore information).
821173Sjkh
921173SjkhThe Makefile in this directory supports a number of targets for
1021173Sjkhbuilding components (or all) of the FreeBSD source tree, the most
1121173Sjkhcommonly used one being ``world'', which rebuilds and installs
1221173Sjkheverything in the FreeBSD system from the source tree except the
1328014Sjkhkernel and the contents of /etc.  Please see the top of the Makefile
1428014Sjkhin this directory for more information on the standard build targets
1528014Sjkhand compile-time flags.
1621173Sjkh
1721369SmaxBuilding a kernel with config(8) is a somewhat more involved process,
1821173Sjkhdocumentation for which can be found at:
1921173Sjkh   http://www.freebsd.org/handbook/kernelconfig.html
2021369SmaxAnd in the config(8) man page.
2121173Sjkh
2221173SjkhThe sample kernel configuration files reside in the sys/i386/conf
2321173Sjkhsub-directory (assuming that you've installed the kernel sources), the
2421173Sjkhfile named GENERIC being the one used to build your initial installation
2521173Sjkhkernel.  The file LINT contains entries for all possible devices, not
2621173Sjkhjust those commonly used, and is meant more as a general reference
2721173Sjkhthan an actual kernel configuration file (a kernel built from it
2821173Sjkhwouldn't even run).
2921173Sjkh
3021173Sjkh
3121173SjkhSource Roadmap:
3221173Sjkh---------------
3321173Sjkhbin		System/User commands.
3421173Sjkh
3521173Sjkhcontrib		Packages contributed by 3rd parties.
3621173Sjkh
3721173SjkheBones		Kerberos package - NOT FOR EXPORT!
3821173Sjkh
3921173Sjkhetc		Template files for /etc
4021173Sjkh
4121173Sjkhgames		Amusements.
4221173Sjkh
4321173Sjkhgnu		Various commands and libraries under the GNU Public License.
4421173Sjkh		Please see gnu/COPYING* for more information.
4521173Sjkh
4621173Sjkhinclude		System include files.
4721173Sjkh
4821173Sjkhlib		System libraries.
4921173Sjkh
5021173Sjkhlibexec		System daemons.
5121173Sjkh
5221173Sjkhlkm		Loadable Kernel Modules.
5321173Sjkh
5421173Sjkhrelease		Release building Makefile & associated tools.
5521173Sjkh
5621173Sjkhsbin		System commands.
5721173Sjkh
5821173Sjkhsecure		DES and DES-related utilities - NOT FOR EXPORT!
5921173Sjkh
6021173Sjkhshare		Shared resources.
6121173Sjkh
6221173Sjkhsys		Kernel sources.
6321173Sjkh
6421173Sjkhtools		Utilities for regression testing and miscellaneous tasks.
6521173Sjkh
6621173Sjkhusr.bin		User commands.
6721173Sjkh
6821173Sjkhusr.sbin	System administration commands.
6921173Sjkh
7021173Sjkh
7121173SjkhFor information on synchronizing your source tree with one or more of
7221173Sjkhthe FreeBSD Project's development branches, please see:
7321173Sjkh
7421173Sjkh  http://www.freebsd.org/handbook/synching.html
75