summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJulian Andres Klode <jak@debian.org>2020-02-18 12:38:46 +0000
committerJulian Andres Klode <jak@debian.org>2020-02-18 12:38:46 +0000
commit62683ed6459e874119f3346d8be66b85e8a90533 (patch)
tree438581b4c0d1ee233244d7a20636eba96950adfc /doc
parent9a0a2daa268bd718a4b7fd9617b46ed74c76e94a (diff)
parent450af26202424bef33e0c58f3f99dfd0c21e7297 (diff)
Merge branch 'pu/source-version' into 'master'
ABI BREAK: Implement pinning by source package See merge request apt-team/apt!96
Diffstat (limited to 'doc')
-rw-r--r--doc/apt_preferences.5.xml21
1 files changed, 21 insertions, 0 deletions
diff --git a/doc/apt_preferences.5.xml b/doc/apt_preferences.5.xml
index cac9a96e1..dacf3dc21 100644
--- a/doc/apt_preferences.5.xml
+++ b/doc/apt_preferences.5.xml
@@ -303,7 +303,28 @@ a &glob; expression in itself.
</para>
</refsect2>
+<refsect2><title>Pinning by source package</title>
+<para>APT supports pinning by source packages. To pin by a source package,
+prepend "src:" to the package name.</para>
+<para>For example, to pin all binaries produced by the apt source package
+of this APT's version to 990, you can do:</para>
+<programlisting>
+Package: src:apt
+Pin: version &apt-product-version;
+Pin-Priority: 990
+</programlisting>
+
+<para>Source package pinning can be combined with regular expressions and
+glob patterns, and can also take a binary architecture.</para>
+<para>For example, let's pin all binaries for all architectures produced by
+any source package containing apt in its name to 990:</para>
+<programlisting>
+Package: src:*apt*:any
+Pin: version *
+Pin-Priority: 990
+</programlisting>
+</refsect2>