diff options
author | reed <reed> | 2005-06-03 16:09:11 +0000 |
---|---|---|
committer | reed <reed> | 2005-06-03 16:09:11 +0000 |
commit | 34a0f88f2ac1469964eaeeba7fe159113144ab89 (patch) | |
tree | cf1bad9f27549e7ce30f2350056113a1c323cac3 /doc/guide | |
parent | 8acedb7d773746c9eea626dcdce5509c7fce7ccc (diff) | |
download | pkgsrc-34a0f88f2ac1469964eaeeba7fe159113144ab89.tar.gz |
Document IGNORE_RECOMMENDED=YES. This includes sentences from tv@
that I read on tech-pkg@.
Diffstat (limited to 'doc/guide')
-rw-r--r-- | doc/guide/files/fixes.xml | 28 |
1 files changed, 20 insertions, 8 deletions
diff --git a/doc/guide/files/fixes.xml b/doc/guide/files/fixes.xml index 4a50f199e27..c9db0695ec5 100644 --- a/doc/guide/files/fixes.xml +++ b/doc/guide/files/fixes.xml @@ -1,4 +1,4 @@ -<!-- $NetBSD: fixes.xml,v 1.19 2005/06/03 12:27:48 jmmv Exp $ --> +<!-- $NetBSD: fixes.xml,v 1.20 2005/06/03 16:09:11 reed Exp $ --> <chapter id="fixes"> <?dbhtml filename="fixes.html"?> <title>Notes on fixes for packages</title> @@ -214,18 +214,30 @@ <varname>RECOMMENDED</varname>: </para> <programlisting>RECOMMENDED+= tiff>=3.6.1:../../graphics/tiff</programlisting> - + <para> In addition to the above <varname>DEPENDS</varname> line, this denotes that while a package will build against tiff>=3.5.4, at least version 3.6.1 is recommended. <varname>RECOMMENDED</varname> entries will be turned into dependencies unless explicitly ignored (in which case a - warning will be printed). Packages that are built with - recommendations ignored may not be uploaded to - ftp.NetBSD.org by developers and should not be used across - different systems that may have different versions of binary - packages installed. </para> - + warning will be printed). </para> + + <para>To ignore these dependency recommendations and just + use the required <varname>DEPENDS</varname>, set + <varname>IGNORE_RECOMMENDED=YES</varname>. This may make + it easier and faster to update packages built using pkgsrc, + since older compatible dependencies can continue to be + used. This is useful for people who watch their rebuilds + very carefully; it is not very good as a general-purpose + hammer. If you use it, you need to be mindful of possible + ABI changes, including those from the underlying OS. + </para> + + <para> Packages that are built with recommendations ignored + may not be uploaded to ftp.NetBSD.org by developers and + should not be used across different systems that may have + different versions of binary packages installed. </para> + <para> For security fixes, please update the package vulnerabilities file as well as setting <varname>RECOMMENDED</varname>, see <xref |