Renamed some *.mk files to *.help, since they only contain comments.

1 files changed, 47 insertions, 0 deletions

diff --git a/mk/help/destdir.help b/mk/help/destdir.help
new file mode 100644
index 00000000000..e94ef754ae6
--- /dev/null
+++ b/mk/help/destdir.help
@@ -0,0 +1,47 @@
+# $NetBSD: destdir.help,v 1.1 2008/01/19 22:41:47 rillig Exp $
+#
+# ===
+# Warning: This file is still under construction. Don't rely on it.
+# ===
+#
+# This file documents the variables around the DESTDIR support.
+#
+# Normally, packages are installed directly into LOCALBASE and may
+# overwrite files of other packages there. It also makes it easy to
+# create packages which behave differently depending on whether they
+# are installed from source or from a binary package. This is not good.
+#
+# The DESTDIR support tries to prevent some of these problems. When it
+# is enabled, packages are not installed directly into LOCALBASE.
+# Instead, they are installed in a temporary directory, and a binary
+# package is created from the files that have been installed there.
+#
+# === User-settable variables ===
+#
+# USE_DESTDIR
+#	* "yes" to enable DESTDIR support for those packages that
+#	  explicitly support it.
+#
+#	* "full": This makes the build completely unprivileged and in
+#	  turn detects any attempt to write e.g. to ${LOCALBASE}.
+#	  This is not supported for actual installation yet, due to
+#	  short comings of pkg_create. [FIXME]
+#
+# === Package-settable variables ===
+#
+# PKG_DESTDIR_SUPPORT
+#	* "user-destdir" means that all files of the packages should be
+#	  installed with default ownership and permissions.
+#
+#	* "destdir" means that some of the installed files need special
+#	  ownership or permissions. The installation is done by the
+#	  privileged user.
+#
+# === Implementation notes ===
+#
+# In the "install" phase, the variable DESTDIR is set in the make(1)
+# environment of the default "do-install" target. Additionally, the
+# variable is passed in the INSTALL_MAKE_FLAGS to override potential
+# "DESTDIR=" entries in the Makefiles.
+#
+# Keywords: destdir