path: root/README.md
diff options
Diffstat (limited to 'README.md')
1 files changed, 15 insertions, 23 deletions
diff --git a/README.md b/README.md
index 1064be3afcb5..a5ae8293ce92 100644
--- a/README.md
+++ b/README.md
@@ -4,35 +4,25 @@ This is the top level of the FreeBSD source directory. This file
was last revised on:
+FreeBSD is an operating system used to power modern servers,
+desktops, and embedded platforms. A large community has
+continually developed it for more than thirty years. Its
+advanced networking, security, and storage features have
+made FreeBSD the platform of choice for many of the
+busiest web sites and most pervasive embedded networking
+and storage devices.
For copyright information, please see the file COPYRIGHT in this
-directory (additional copyright information also exists for some
+directory. Additional copyright information also exists for some
sources in this tree - please see the specific source directories for
-more information).
+more information.
The Makefile in this directory supports a number of targets for
-building components (or all) of the FreeBSD source tree. See build(7)
-and https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html
+building components (or all) of the FreeBSD source tree. See build(7), config(8),
+https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html, and
for more information, including setting make(1) variables.
-The `buildkernel` and `installkernel` targets build and install
-the kernel and the modules (see below). Please see the top of
-the Makefile in this directory for more information on the
-standard build targets and compile-time flags.
-Building a kernel is a somewhat more involved process. See build(7), config(8),
-and https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig.html
-for more information.
-Note: If you want to build and install the kernel with the
-`buildkernel` and `installkernel` targets, you might need to build
-world before. More information is available in the handbook.
-The kernel configuration files reside in the `sys/<arch>/conf`
-sub-directory. GENERIC is the default configuration used in release builds.
-NOTES contains entries and documentation for all possible
-devices, not just those commonly used.
Source Roadmap:
@@ -72,6 +62,8 @@ stand Boot loader sources.
sys Kernel sources.
+sys/<arch>/conf Kernel configuration file
tests Regression tests which can be run by Kyua. See tests/README
for additional information.