README revision 21369
155714SkrisThis is the top level of the FreeBSD source directory.  This file
255714Skriswas last revised on: $Id: README,v 1.7 1997/01/01 14:06:29 jkh Exp $
355714Skris
455714SkrisFor copyright information, please see the file COPYRIGHT in this
555714Skrisdirectory (additional copyright information also exists for some
655714Skrissources in this tree - please see the specific source directories for
755714Skrismore information).
8296341Sdelphij
955714SkrisThe Makefile in this directory supports a number of targets for
1055714Skrisbuilding components (or all) of the FreeBSD source tree, the most
1155714Skriscommonly used one being ``world'', which rebuilds and installs
1255714Skriseverything in the FreeBSD system from the source tree except the
1355714Skriskernel.  Please see the top of the Makefile for more information on
1455714Skristhe standard build targets and compile-time flags.
15296341Sdelphij
1655714SkrisBuilding a kernel with config(8) is a somewhat more involved process,
1755714Skrisdocumentation for which can be found at:
1855714Skris   http://www.freebsd.org/handbook/kernelconfig.html
1955714SkrisAnd in the config(8) man page.
2055714Skris
2155714SkrisThe sample kernel configuration files reside in the sys/i386/conf
22296341Sdelphijsub-directory (assuming that you've installed the kernel sources), the
2355714Skrisfile named GENERIC being the one used to build your initial installation
2455714Skriskernel.  The file LINT contains entries for all possible devices, not
2555714Skrisjust those commonly used, and is meant more as a general reference
2655714Skristhan an actual kernel configuration file (a kernel built from it
2755714Skriswouldn't even run).
2855714Skris
2955714Skris
3055714SkrisSource Roadmap:
3155714Skris---------------
3255714Skrisbin		System/User commands.
3355714Skris
3455714Skriscontrib		Packages contributed by 3rd parties.
3555714Skris
3655714SkriseBones		Kerberos package - NOT FOR EXPORT!
37296341Sdelphij
3855714Skrisetc		Template files for /etc
3955714Skris
40296341Sdelphijgames		Amusements.
4155714Skris
4255714Skrisgnu		Various commands and libraries under the GNU Public License.
4355714Skris		Please see gnu/COPYING* for more information.
4455714Skris
4555714Skrisinclude		System include files.
4655714Skris
4755714Skrislib		System libraries.
4855714Skris
4955714Skrislibexec		System daemons.
5055714Skris
5155714Skrislkm		Loadable Kernel Modules.
52296341Sdelphij
5355714Skrisrelease		Release building Makefile & associated tools.
5455714Skris
5555714Skrissbin		System commands.
5655714Skris
5755714Skrissecure		DES and DES-related utilities - NOT FOR EXPORT!
58100928Snectar
59238405Sjkimshare		Shared resources.
60109998Smarkm
61109998Smarkmsys		Kernel sources.
62109998Smarkm
63109998Smarkmtools		Utilities for regression testing and miscellaneous tasks.
64109998Smarkm
65109998Smarkmusr.bin		User commands.
66296341Sdelphij
67109998Smarkmusr.sbin	System administration commands.
68109998Smarkm
69109998Smarkm
70109998SmarkmFor information on synchronizing your source tree with one or more of
71109998Smarkmthe FreeBSD Project's development branches, please see:
72109998Smarkm
73109998Smarkm  http://www.freebsd.org/handbook/synching.html
74109998Smarkm