| @@ -1,39 +1,24 @@ | | | @@ -1,39 +1,24 @@ |
1 | # $NetBSD: destdir.help,v 1.7 2016/04/10 15:09:26 joerg Exp $ | | 1 | # $NetBSD: destdir.help,v 1.8 2016/04/10 15:15:45 joerg Exp $ |
2 | # | | 2 | # |
3 | # === | | 3 | # === |
4 | # Warning: This file is still under construction. Don't rely on it. | | 4 | # Warning: This file is still under construction. Don't rely on it. |
5 | # === | | 5 | # === |
6 | # | | 6 | # |
7 | # This file documents the variables around the DESTDIR support. | | 7 | # This file documents the variables around the DESTDIR support. |
8 | # | | 8 | # During the build, package files are not installed directly into |
9 | # Normally, packages are installed directly into LOCALBASE and may | | 9 | # LOCALBASE, but a temporary directory under WRKDIR. Any direct change |
10 | # overwrite files of other packages there. It also makes it easy to | | 10 | # of LOCALBASE is a bug. A binary package is created from the content |
11 | # create packages which behave differently depending on whether they | | 11 | # of that temporary directory and then installed normally with pkg_add. |
12 | # are installed from source or from a binary package. This is not good. | | | |
13 | # | | | |
14 | # The DESTDIR support tries to prevent some of these problems. When it | | | |
15 | # is enabled, packages are not installed directly into LOCALBASE. | | | |
16 | # Instead, they are installed in a temporary directory, and a binary | | | |
17 | # package is created from the files that have been installed there. | | | |
18 | # | | | |
19 | # === User-settable variables === | | | |
20 | # | | | |
21 | # USE_DESTDIR | | | |
22 | # * "yes" to enable DESTDIR support for those packages that | | | |
23 | # explicitly support it. If the package supports it, | | | |
24 | # the build will run completely under the privileges of the | | | |
25 | # calling users, only package installation via pkg_add is done | | | |
26 | # as root. | | | |
27 | # | | 12 | # |
28 | # === Package-settable variables === | | 13 | # === Package-settable variables === |
29 | # | | 14 | # |
30 | # PKG_DESTDIR_SUPPORT | | 15 | # PKG_DESTDIR_SUPPORT |
31 | # * "user-destdir" means that all files of the packages should be | | 16 | # * "user-destdir" means that all files of the packages should be |
32 | # installed with default ownership and permissions. | | 17 | # installed with default ownership and permissions. |
33 | # | | 18 | # |
34 | # * "destdir" means that some of the installed files need special | | 19 | # * "destdir" means that some of the installed files need special |
35 | # ownership or permissions. The installation is done by the | | 20 | # ownership or permissions. The installation is done by the |
36 | # privileged user. | | 21 | # privileged user. |
37 | # | | 22 | # |
38 | # This variable must be set before including bsd.prefs.mk directly or | | 23 | # This variable must be set before including bsd.prefs.mk directly or |
39 | # indirectly. | | 24 | # indirectly. |