aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorTom Rhodes <trhodes@FreeBSD.org>2006-06-07 03:33:48 +0000
committerTom Rhodes <trhodes@FreeBSD.org>2006-06-07 03:33:48 +0000
commitfb55e8556666653a5589104f8d14e116baf362cb (patch)
treeb06d4f1442bea989eff320724c4eab4b2fbbd97b
parent5f17c1e2b2f22ff3f85ac55be90824206ae80094 (diff)
downloadsrc-fb55e8556666653a5589104f8d14e116baf362cb.tar.gz
src-fb55e8556666653a5589104f8d14e116baf362cb.zip
Simply running ``make world'' will bomb unless you dig up the
undocumented HISTORICAL_MAKE_WORLD variable and set it. Note it here so the blow up will not really be a surprise to people who read. Link the buildingworld chapter of our handbook in the README while I'm here.
Notes
Notes: svn path=/head/; revision=159363
-rw-r--r--Makefile5
-rw-r--r--README9
2 files changed, 10 insertions, 4 deletions
diff --git a/Makefile b/Makefile
index bc1f0cb82ef6..f5026f769945 100644
--- a/Makefile
+++ b/Makefile
@@ -8,7 +8,7 @@
# buildworld - Rebuild *everything*, including glue to help do
# upgrades.
# installworld - Install everything built by "buildworld".
-# world - buildworld + installworld.
+# world - buildworld + installworld, no kernel.
# buildkernel - Rebuild the kernel and the kernel-modules.
# installkernel - Install the kernel and the kernel-modules.
# installkernel.debug
@@ -37,7 +37,8 @@
# system, the simple instructions are:
#
# 1. `cd /usr/src' (or to the directory containing your source tree).
-# 2. `make world'
+# 2. Define `HISTORICAL_MAKE_WORLD' variable (see README).
+# 3. `make world'
#
# For individuals wanting to upgrade their sources (even if only a
# delta of a few days):
diff --git a/README b/README
index 87cfa1754903..674d93ebe0a9 100644
--- a/README
+++ b/README
@@ -11,8 +11,13 @@ The Makefile in this directory supports a number of targets for
building components (or all) of the FreeBSD source tree, the most
commonly used one being ``world'', which rebuilds and installs
everything in the FreeBSD system from the source tree except the
-kernel, the kernel-modules and the contents of /etc. The
-``buildkernel'' and ``installkernel'' targets build and install
+kernel, the kernel-modules and the contents of /etc. The ``world''
+target should only be used in cases where the source tree has not
+changed from the currently running version. See:
+http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html
+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.