Prefix various paths with 'DESTDIR', to highlight that the DESTDIR

is taken into account.
This commit is contained in:
lukem 2003-01-30 02:52:40 +00:00
parent 1627b9c342
commit 34e5de7919
2 changed files with 42 additions and 42 deletions

View File

@ -67,8 +67,8 @@ FILES
distrib/, etc/
Sources for items used when making a full release snap-
shot, such as files installed in /etc on the destination
system, boot media, and release notes.
shot, such as files installed in DESTDIR/etc on the desti-
nation system, boot media, and release notes.
regress/ Regression test harness. Can be cross-compiled, but only
run natively.
@ -151,8 +151,8 @@ CONFIGURATION
Default: ``yes''
MKDOC Can be set to ``yes'' or ``no''. Indicates whether system
documentation destined for /usr/share/doc will be installed
during a build.
documentation destined for DESTDIR/usr/share/doc will be in-
stalled during a build.
Default: ``yes''
@ -176,7 +176,7 @@ CONFIGURATION
MKLINT Can be set to ``yes'' or ``no''. Indicates whether lint(1)
will be run against portions of the NetBSD source code during
the build, and whether lint libraries will be installed into
/usr/libdata/lint.
DESTDIR/usr/libdata/lint.
Default: ``yes''
@ -222,10 +222,10 @@ CONFIGURATION
code.
MKSHARE Can be set to ``yes'' or ``no''. Indicates whether files
destined to reside in /usr/share will be built and installed
during a build. If set to ``no'', then all of MKCATPAGES,
MKDOC, MKINFO, MKMAN, and MKNLS will be set to ``no'' uncon-
ditionally.
destined to reside in DESTDIR/usr/share will be built and in-
stalled during a build. If set to ``no'', then all of
MKCATPAGES, MKDOC, MKINFO, MKMAN, and MKNLS will be set to
``no'' unconditionally.
Default: ``yes''
@ -388,9 +388,9 @@ BUILDING
fore any system libraries or programs can be built.
install Install programs, libraries, and documentation into DESTDIR.
Few files will be installed to /dev, /etc, /root or /var in
order to prevent user supplied configuration data from being
overwritten.
Few files will be installed to DESTDIR/dev, DESTDIR/etc,
DESTDIR/root or DESTDIR/var in order to prevent user supplied
configuration data from being overwritten.
lint Run lint(1) against the C source code, where appropriate, and
generate system-installed lint libraries.
@ -410,8 +410,8 @@ BUILDING
the proper order.
distribution Do a ``make build'', and then install a full distribution
into DESTDIR, including files in /dev, /etc, /root and
/var.
into DESTDIR, including files in DESTDIR/dev, DESTDIR/etc,
DESTDIR/root and DESTDIR/var.
buildworld As per ``make distribution'', except that it ensures that
DESTDIR is not the root directory.
@ -576,20 +576,20 @@ EXAMPLES
Build a new toolchain, and use the new toolchain to configure
and build a new GENERIC kernel.
./build.sh -U -D /path/to/DESTDIR distribution
./build.sh -U -D /path/to/destdir distribution
Using unprivileged mode, build a complete distribution in
/path/to/DESTDIR.
/path/to/destdir.
# ./build.sh -U -D /path/to/DESTDIR installworld=/
# ./build.sh -U -D /path/to/destdir installworld=/
As root, install the distribution that was built with unprivi-
leged mode from /path/to/DESTDIR to /. (Even though this is
leged mode from /path/to/destdir to /. (Even though this is
run as root, -U is required so that the permissions stored in
/path/to/DESTDIR/METALOG are correctly applied to the files as
/path/to/destdir/METALOG are correctly applied to the files as
they're copied to /).
./build.sh -U -D /path/to/DESTDIR -R /path/to/RELEASE release
./build.sh -U -D /path/to/destdir -R /path/to/releasedir release
Using unprivileged mode, build a complete release in
/path/to/dir/RELEASE.
/path/to/dir/releasedir.
OBSOLETE VARIABLES
NBUILDJOBS Use the make(1) option -j, instead.

View File

@ -1,4 +1,4 @@
.\" $NetBSD: BUILDING.mdoc,v 1.13 2003/01/29 22:50:10 lukem Exp $
.\" $NetBSD: BUILDING.mdoc,v 1.14 2003/01/30 02:52:40 lukem Exp $
.\"
.\" Copyright (c) 2001-2003 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -153,7 +153,7 @@ Makefile semantics when building these programs for a native host.
.It Sy distrib/ , etc/
Sources for items used when making a full release snapshot, such as
files installed in
.Sy /etc
.Sy DESTDIR Ns Pa /etc
on the destination system, boot media, and release notes.
.It Sy regress/
Regression test harness.
@ -324,7 +324,7 @@ Will not affect use of the standard low-security password encryption system,
.It Sy MKDOC
.YorN
Indicates whether system documentation destined for
.Sy /usr/share/doc
.Sy DESTDIR Ns Pa /usr/share/doc
will be installed during a build.
.DFLTy
.
@ -358,7 +358,7 @@ will be run against portions of the
.Nx
source code during the build, and whether lint libraries will be
installed into
.Sy /usr/libdata/lint .
.Sy DESTDIR Ns Pa /usr/libdata/lint .
.DFLTy
.
.It Sy MKMAN
@ -418,7 +418,7 @@ by default at times due to toolchain problems with profiled code.
.It Sy MKSHARE
.YorN
Indicates whether files destined to reside in
.Sy /usr/share
.Sy DESTDIR Ns Pa /usr/share
will be built and installed during a build.
If set to
.Dq no ,
@ -707,11 +707,11 @@ Typically needed before any system libraries or programs can be built.
Install programs, libraries, and documentation into
.Sy DESTDIR .
Few files will be installed to
.Pa /dev ,
.Pa /etc ,
.Pa /root
.Sy DESTDIR Ns Pa /dev ,
.Sy DESTDIR Ns Pa /etc ,
.Sy DESTDIR Ns Pa /root
or
.Pa /var
.Sy DESTDIR Ns Pa /var
in order to prevent user supplied configuration data from being overwritten.
.It Sy lint
Run
@ -758,11 +758,11 @@ Do a
and then install a full distribution into
.Sy DESTDIR ,
including files in
.Pa /dev ,
.Pa /etc ,
.Pa /root
.Sy DESTDIR Ns Pa /dev ,
.Sy DESTDIR Ns Pa /etc ,
.Sy DESTDIR Ns Pa /root
and
.Pa /var .
.Sy DESTDIR Ns Pa /var .
.
.It Sy buildworld
As per
@ -789,7 +789,7 @@ before performing this operation.
Create distribution sets from
.Sy DESTDIR
into
.Sy RELEASEDIR Ns Pa /MACHINE/binary/sets .
.Sy RELEASEDIR/MACHINE Ns Pa /binary/sets .
Should be run after
.Dq make distribution
(as
@ -1134,27 +1134,27 @@ or called with an absolute path.
Build a new toolchain, and use the new toolchain to
configure and build a new GENERIC kernel.
.
.It Li "./build.sh -U -D /path/to/DESTDIR distribution"
.It Li "./build.sh -U -D /path/to/destdir distribution"
Using unprivileged mode,
build a complete distribution in
.Pa /path/to/DESTDIR .
.Pa /path/to/destdir .
.
.It Li "# ./build.sh -U -D /path/to/DESTDIR installworld=/"
.It Li "# ./build.sh -U -D /path/to/destdir installworld=/"
As root, install the distribution that was built with unprivileged mode from
.Pa /path/to/DESTDIR
.Pa /path/to/destdir
to
.Pa / .
(Even though this is run as root,
.Fl U
is required so that the permissions stored in
.Pa /path/to/DESTDIR/METALOG
.Pa /path/to/destdir/METALOG
are correctly applied to the files as they're copied to
.Pa / ) .
.
.It Li "./build.sh -U -D /path/to/DESTDIR -R /path/to/RELEASE release"
.It Li "./build.sh -U -D /path/to/destdir -R /path/to/releasedir release"
Using unprivileged mode,
build a complete release in
.Pa /path/to/dir/RELEASE .
.Pa /path/to/dir/releasedir .
.El
.
.Sh OBSOLETE VARIABLES