X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/5b42c812e5f689206f5e3ad4196f17c97ca34415..bb1293d975294884a95b9cb298432c9cf9ecc995:/doc/apt_preferences.5.xml
diff --git a/doc/apt_preferences.5.xml b/doc/apt_preferences.5.xml
index 162c2f00e..159d61f2b 100644
--- a/doc/apt_preferences.5.xml
+++ b/doc/apt_preferences.5.xml
@@ -14,12 +14,13 @@
&apt-email;
&apt-product;
- 29 February 2004
+ 04 May 2009
apt_preferences
5
+ APT
@@ -31,7 +32,8 @@
Description
The APT preferences file /etc/apt/preferences
-can be used to control which versions of packages will be selected
+and the fragment files in the /etc/apt/preferences.d/
+folder can be used to control which versions of packages will be selected
for installation.
Several versions of a package may be available for installation when
@@ -190,6 +192,15 @@ Pin: release a=unstable
Pin-Priority: 50
+The following record assigns a high priority to all package versions
+belonging to any distribution whose Codename is "squeeze".
+
+
+Package: *
+Pin: release n=squeeze
+Pin-Priority: 900
+
+
The following record assigns a high priority to all package versions
belonging to any release whose Archive name is "stable"
and whose release Version number is "3.0".
@@ -327,10 +338,11 @@ file are relevant for setting APT priorities:
-the Archive: line
+the Archive: or Suite: line
names the archive to which all the packages
in the directory tree belong. For example, the line
-"Archive: stable"
+"Archive: stable" or
+"Suite: stable"
specifies that all of the packages in the directory
tree below the parent of the Release file are in a
stable archive. Specifying this value in the APT preferences file
@@ -342,6 +354,22 @@ Pin: release a=stable
+
+the Codename: line
+names the codename to which all the packages
+in the directory tree belong. For example, the line
+"Codename: squeeze"
+specifies that all of the packages in the directory
+tree below the parent of the Release file belong to a version named
+squeeze. Specifying this value in the APT preferences file
+would require the line:
+
+
+Pin: release n=squeeze
+
+
+
+
the Version: line
names the release version. For example, the
@@ -522,10 +550,74 @@ version.
apt-get install package/unstable
+
+
+
+Tracking the evolution of a codename release
+
+The following APT preferences file will cause APT to assign a
+priority higher than the default (500) to all package versions belonging
+to a specified codename of a distribution and a prohibitively low priority to
+package versions belonging to other Debian distributions,
+codenames and archives.
+Note that with this APT preference APT will follow the migration of a release
+from the archive testing to stable and
+later oldstable. If you want to follow for example the progress
+in testing notwithstanding the codename changes you should use
+the example configurations above.
+
+
+Explanation: Uninstall or do not install any Debian-originated package versions
+Explanation: other than those in the distribution codenamed with squeeze or sid
+Package: *
+Pin: release n=squeeze
+Pin-Priority: 900
+
+Explanation: Debian unstable is always codenamed with sid
+Package: *
+Pin: release a=sid
+Pin-Priority: 800
+
+Package: *
+Pin: release o=Debian
+Pin-Priority: -10
+
+
+
+With a suitable &sources-list; file and the above preferences file,
+any of the following commands will cause APT to upgrade to the
+latest version(s) in the release codenamed with squeeze.
+
+
+apt-get install package-name
+apt-get upgrade
+apt-get dist-upgrade
+
+
+
+The following command will cause APT to upgrade the specified
+package to the latest version from the sid distribution.
+Thereafter, apt-get upgrade will upgrade
+the package to the most recent squeeze version if that is
+more recent than the installed version, otherwise, to the most recent
+sid version if that is more recent than the installed
+version.
+
+
+apt-get install package/sid
+
+
+
+Files
+
+ &file-preferences;
+
+
+
See Also
&apt-get; &apt-cache; &apt-conf; &sources-list;
@@ -535,4 +627,3 @@ apt-get install package/unstable
&manbugs;
-