| @@ -1,48 +1,33 @@ | | | @@ -1,48 +1,33 @@ |
| 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. |
| 40 | # | | 25 | # |
| 41 | # === Implementation notes === | | 26 | # === Implementation notes === |
| 42 | # | | 27 | # |
| 43 | # In the "stage-install" phase, the variable DESTDIR is set in the make(1) | | 28 | # In the "stage-install" phase, the variable DESTDIR is set in the make(1) |
| 44 | # environment of the default "do-install" target. Additionally, the | | 29 | # environment of the default "do-install" target. Additionally, the |
| 45 | # variable is passed in the INSTALL_MAKE_FLAGS to override potential | | 30 | # variable is passed in the INSTALL_MAKE_FLAGS to override potential |
| 46 | # "DESTDIR=" entries in the Makefiles. | | 31 | # "DESTDIR=" entries in the Makefiles. |
| 47 | # | | 32 | # |
| 48 | # Keywords: destdir | | 33 | # Keywords: destdir |