Source-Changes-HG archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
[pkgsrc/trunk]: pkgsrc/doc doc/pkgsrc.*: regen
details: https://anonhg.NetBSD.org/pkgsrc/rev/b3891e147603
branches: trunk
changeset: 437305:b3891e147603
user: bacon <bacon%pkgsrc.org@localhost>
date: Thu Aug 20 13:33:38 2020 +0000
description:
doc/pkgsrc.*: regen
diffstat:
doc/pkgsrc.html | 2641 +++++++++++++++++++++++++++---------------------------
doc/pkgsrc.txt | 1479 +++++++++++++++---------------
2 files changed, 2086 insertions(+), 2034 deletions(-)
diffs (truncated from 5469 to 300 lines):
diff -r 94059c8d90be -r b3891e147603 doc/pkgsrc.html
--- a/doc/pkgsrc.html Thu Aug 20 13:31:58 2020 +0000
+++ b/doc/pkgsrc.html Thu Aug 20 13:33:38 2020 +0000
@@ -614,7 +614,7 @@
<a class="ulink" href="https://developer.apple.com/macos/"; target="_top">Darwin / Mac OS X / OS X / macOS</a>
</td>
<td align="center">Oct 2001</td>
-<td><a class="ulink" href="https://cdn.NetBSD.org/pub/pkgsrc/current/pkgsrc/bootstrap/README.MacOSX"; target="_top">README.MacOSX</a></td>
+<td><a class="ulink" href="https://cdn.NetBSD.org/pub/pkgsrc/current/pkgsrc/bootstrap/README.macOS"; target="_top">README.macOS</a></td>
</tr>
<tr>
<td><a class="ulink" href="https://www.freebsd.org/"; target="_top">FreeBSD</a></td>
@@ -6537,15 +6537,40 @@
<code class="filename">builtin.mk</code>
file to be listed in <code class="varname">PREFER_NATIVE</code>,
otherwise it is simply ignored in that list.</p>
-<p>Setting <code class="varname">PREFER_NATIVE</code> should be performed
- straight after bootstrap and <code class="varname">PREFER_PKGSRC</code> during
- bootstrap.
+<p><code class="varname">PREFER_PKGSRC</code> and
+ <code class="varname">PREFER_NATIVE</code> should be set during bootstrap
+ to ensure that the bootstrap process does not use inapropriate
+ native tools as dependencies for core packages.
+
+</p>
+<pre class="screen">
+<code class="prompt">#</code> <strong class="userinput"><code>./bootstrap --prefer-pkgsrc yes --prefer-native openssl</code></strong>
+</pre>
+<p>
+
Switching between settings globally at a later date can introduce
complications with dependency resolution. This is caused by packages
- built with the opposite preference being installed alongside each other.</p>
-<pre class="screen">
-<code class="prompt">#</code> <strong class="userinput"><code>./bootstrap --prefer-pkgsrc yes</code></strong>
-</pre>
+ built with the opposite preference being installed alongside each
+ other. Hence, any changes to these variables after bootstrap will
+ necessitate rebuilding all packages depending on one whose preference
+ has been changed. This is not trivial and should be avoided.</p>
+<p>When using pkgsrc on Linux systems, there is high risk of
+ "leakage", where programs installed by pkgsrc may inadvertently use a
+ command or library not installed by pkgsrc, e.g. those installed by
+ yum or apt. Such foreign dependencies may be installed, removed, or
+ upgraded to a version incompatible with the pkgsrc package at any
+ time, causing pkgsrc packages to subsequently malfunction. Pkgsrc
+ cannot prevent this, as it has no control over other package managers.
+ Another potential problem is that under Redhat Enterprise and related
+ Linux systems, yum packages are only patched and never upgraded, so
+ eventually they may become too outdated for use by pkgsrc. Even
+ intentionally using foreign dependencies, not considered leakage, can
+ lead to these problems, so it is generally discouraged. In order to
+ minimize such problems, PREFER_PKGSRC defaults to "yes" on Linux systems.
+ This ensures that pkgsrc is aware of any changes to dependency packages
+ and can rebuild or upgrade the entire dependency tree as needed. This
+ default can be overridden by setting --prefer-pkgsrc to "no" or a list of
+ packages, or by setting --prefer-native to "yes".</p>
</div>
</div>
</div>
@@ -11391,2603 +11416,2607 @@
</tr>
<tr>
<td>CMAKE_DEPENDENCIES_REWRITE</td>
+<td>CMAKE_INSTALL_NAME_DIR</td>
+</tr>
+<tr>
<td>CMAKE_INSTALL_PREFIX</td>
-</tr>
-<tr>
<td>CMAKE_MODULE_PATH_OVERRIDE</td>
+</tr>
+<tr>
<td>CMAKE_PKGSRC_BUILD_FLAGS</td>
-</tr>
-<tr>
<td>CMAKE_PREFIX_PATH</td>
+</tr>
+<tr>
<td>CMAKE_USE_GNU_INSTALL_DIRS</td>
-</tr>
-<tr>
<td>COMMON_LISP_DOCFILES</td>
+</tr>
+<tr>
<td>COMMON_LISP_EXAMPLES</td>
-</tr>
-<tr>
<td>COMMON_LISP_EXTRAFILES</td>
+</tr>
+<tr>
<td>COMMON_LISP_PACKAGES</td>
-</tr>
-<tr>
<td>COMMON_LISP_SYSTEM</td>
+</tr>
+<tr>
<td>COMPILER_RPATH_FLAG</td>
-</tr>
-<tr>
<td>COMPILER_USE_SYMLINKS</td>
+</tr>
+<tr>
<td>CONFIGURE_ARGS</td>
-</tr>
-<tr>
<td>CONFIGURE_DIRS</td>
+</tr>
+<tr>
<td>CONFIGURE_ENV</td>
-</tr>
-<tr>
<td>CONFIGURE_ENV_SHELL</td>
+</tr>
+<tr>
<td>CONFIGURE_HAS_INFODIR</td>
-</tr>
-<tr>
<td>CONFIGURE_HAS_MANDIR</td>
+</tr>
+<tr>
<td>CONFIGURE_SCRIPT</td>
-</tr>
-<tr>
<td>CONFIG_SHELL</td>
+</tr>
+<tr>
<td>CONFIG_SHELL_FLAGS</td>
-</tr>
-<tr>
<td>CONF_FILES</td>
+</tr>
+<tr>
<td>CONF_FILES_MODE</td>
-</tr>
-<tr>
<td>CONF_FILES_PERMS</td>
+</tr>
+<tr>
<td>CONSERVER_DEFAULTHOST</td>
-</tr>
-<tr>
<td>CONSERVER_DEFAULTPORT</td>
+</tr>
+<tr>
<td>CP</td>
-</tr>
-<tr>
<td>CPP</td>
+</tr>
+<tr>
<td>CPP_PRECOMP_FLAGS</td>
-</tr>
-<tr>
<td>CREATE_WRKDIR_SYMLINK</td>
+</tr>
+<tr>
<td>CROSSBASE</td>
-</tr>
-<tr>
<td>CTFCONVERT</td>
+</tr>
+<tr>
<td>CTF_FILES_SKIP</td>
-</tr>
-<tr>
<td>CTF_SUPPORTED</td>
+</tr>
+<tr>
<td>CTYPE</td>
-</tr>
-<tr>
<td>CUPS_GROUP</td>
+</tr>
+<tr>
<td>CUPS_SYSTEM_GROUPS</td>
-</tr>
-<tr>
<td>CUPS_USER</td>
+</tr>
+<tr>
<td>CURSES_DEFAULT</td>
-</tr>
-<tr>
<td>CURSES_TYPE</td>
+</tr>
+<tr>
<td>CVS_EXTRACTDIR</td>
-</tr>
-<tr>
<td>CVS_MODULE</td>
+</tr>
+<tr>
<td>CVS_PROJECT</td>
-</tr>
-<tr>
<td>CVS_REPOSITORIES</td>
+</tr>
+<tr>
<td>CVS_ROOT</td>
-</tr>
-<tr>
<td>CVS_ROOT_GNU</td>
+</tr>
+<tr>
<td>CVS_ROOT_NONGNU</td>
-</tr>
-<tr>
<td>CVS_ROOT_SOURCEFORGE</td>
+</tr>
+<tr>
<td>CVS_TAG</td>
-</tr>
-<tr>
<td>CXX</td>
+</tr>
+<tr>
<td>CYRUS_GROUP</td>
-</tr>
-<tr>
<td>CYRUS_IDLE</td>
+</tr>
+<tr>
<td>CYRUS_USER</td>
-</tr>
-<tr>
<td>DAEMONTOOLS_GROUP</td>
+</tr>
+<tr>
<td>DAEMONTOOLS_LOG_USER</td>
-</tr>
-<tr>
<td>DBUS_GROUP</td>
+</tr>
+<tr>
<td>DBUS_USER</td>
-</tr>
-<tr>
<td>DEFANG_GROUP</td>
+</tr>
+<tr>
<td>DEFANG_USER</td>
-</tr>
-<tr>
<td>DEFAULT_ACCEPTABLE_LICENSES</td>
+</tr>
+<tr>
<td>DEFAULT_DISTFILES</td>
-</tr>
-<tr>
<td>DEFAULT_IRC_SERVER</td>
+</tr>
+<tr>
<td>DEFAULT_SERIAL_DEVICE</td>
-</tr>
-<tr>
<td>DEF_UMASK</td>
+</tr>
+<tr>
<td>DEINSTALLDEPENDS</td>
-</tr>
-<tr>
<td>DEINSTALL_SRC</td>
+</tr>
+<tr>
<td>DEINSTALL_TEMPLATES</td>
-</tr>
-<tr>
<td>DELAYED_ERROR_MSG</td>
+</tr>
+<tr>
<td>DELAYED_WARNING_MSG</td>
-</tr>
-<tr>
<td>DEPENDS</td>
+</tr>
+<tr>
<td>DEPENDS_TARGET</td>
-</tr>
-<tr>
<td>DEPENDS_TYPE</td>
+</tr>
+<tr>
<td>DESTDIR</td>
-</tr>
-<tr>
<td>DESTDIR_VARNAME</td>
+</tr>
+<tr>
<td>DIALER_GROUP</td>
-</tr>
-<tr>
<td>DIGEST_REQD</td>
+</tr>
+<tr>
<td>DISTDIR</td>
-</tr>
-<tr>
<td>DISTFILES</td>
+</tr>
Home |
Main Index |
Thread Index |
Old Index