[SCM] live-manual branch, debian, updated. debian/2.0.0-1-43-gbef1887

[Ben Armstrong]

The following commit has been merged in the debian branch:
commit bdc67d513fef4acb6a6d6c80e7e1745092af499d
Author: Ben Armstrong <synrg at debian.org>
Date:   Sun Dec 19 10:06:49 2010 -0400

    Adding tip about APT pinning with negative priority as alternative to disabling recommends.

diff --git a/manual/en/user_customization-packages.ssi b/manual/en/user_customization-packages.ssi
index fb39290..e445ed8 100644
--- a/manual/en/user_customization-packages.ssi
+++ b/manual/en/user_customization-packages.ssi
@@ -315,7 +315,7 @@ $ lb config --apt-recommends false
 
 }code
 
-The tradeoff here is that recommended packages are defined as "packages that would be found together with this one in all but unusual installations" (Debian Policy Manual, §7.2). This may lead to some packages that you actually need being omitted, so we suggest you review the difference this makes to your packages list (see the #{binary.packages}# file generated by #{lb build}#) and re-include in your list any missing packages that you still want installed.
+The tradeoff here is that if you don't install recommended packages for a given package, that is, "packages that would be found together with this one in all but unusual installations" (Debian Policy Manual, §7.2), some packages that you actually need may be omitted. Therefore, we suggest you review the difference turning off recommends makes to your packages list (see the #{binary.packages}# file generated by #{lb build}#) and re-include in your list any missing packages that you still want installed. Alternatively, if you find you only want a small number of recommended packages left out, leave recommends enabled and set a negative APT pin priority on selected packages to prevent them from being installed, as explained in {APT pinning}#apt-pinning.
 
 3~ Passing options to apt or aptitude
 
@@ -342,3 +342,13 @@ END
 
 }code
 
+Negative pin priorities will prevent a package from being installed, as in the case where you do not want a package that is recommended by another package. Suppose you are building a GNOME image but don't want the user prompted to store wifi passwords in the keyring, so you want to omit the recommended #{gnome-keyring}# package. This can be done by adding the following stanza to #{config/chroot_apt/preferences}#:
+
+code{
+
+Package: gnome-keyring
+Pin: version *
+Pin-Priority: -1
+
+}code
+

-- 
live-manual