summaryrefslogtreecommitdiff
path: root/doc/apt_preferences.5.xml
diff options
context:
space:
mode:
authorJulian Andres Klode <jak@debian.org>2015-08-12 20:46:00 +0200
committerJulian Andres Klode <jak@debian.org>2015-08-12 20:51:08 +0200
commit85b9b32933eaeda6119d7a0224b5070ab8230c6b (patch)
tree02bad5f7147140bcf9d756175308e610e4240e7e /doc/apt_preferences.5.xml
parent809aa216c630f1cc61b0c3b9d992d4a3be14be3c (diff)
apt_preferences(5): Re-document how priorities are calculated
The old text did not match either the old or the new implementation, so let's rewrite it to explain the new implementation. Closes: #554773
Diffstat (limited to 'doc/apt_preferences.5.xml')
-rw-r--r--doc/apt_preferences.5.xml13
1 files changed, 8 insertions, 5 deletions
diff --git a/doc/apt_preferences.5.xml b/doc/apt_preferences.5.xml
index 5703203b0..81e0bd220 100644
--- a/doc/apt_preferences.5.xml
+++ b/doc/apt_preferences.5.xml
@@ -346,11 +346,14 @@ only if there is no installed version of the package</simpara></listitem>
</variablelist>
</para>
-<para>If any specific-form records match an available package version then the
-first such record determines the priority of the package version.
-Failing that,
-if any general-form records match an available package version then the
-first such record determines the priority of the package version.</para>
+<para>
+The first specific-form record matching an available package version determines
+the priority of the package version.
+Failing that, the priority of the package is defined as the maximum of all
+priorities defined by generic-form records matching the version.
+Records defined using patterns in the Pin field other than "*" are treated like
+specific-form records.
+</para>
<para>For example, suppose the APT preferences file contains the three
records presented earlier:</para>