Release 2.3.142.3.14

16 files changed, 707 insertions, 232 deletions

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 76674cd37..55469d8d4 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -200,7 +200,7 @@ endif()
 # Configure some variables like package, version and architecture.
 set(PACKAGE ${PROJECT_NAME})
 set(PACKAGE_MAIL "APT Development Team <deity@lists.debian.org>")
-set(PACKAGE_VERSION "2.3.13")
+set(PACKAGE_VERSION "2.3.14")
 string(REGEX MATCH "^[0-9.]+" PROJECT_VERSION ${PACKAGE_VERSION})
 
 if (NOT DEFINED DPKG_DATADIR)
diff --git a/debian/changelog b/debian/changelog
index fc5214a77..f4525287c 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,30 @@
+apt (2.3.14) unstable; urgency=medium
+
+  [ Helge Kreutzmann ]
+  * German program translation update (Closes: #1000537)
+
+  [ Walter Lozano ]
+  * Use short options for cmp
+
+  [ Ville Skyttä ]
+  * Spelling fixes
+
+  [ Zhang Boyang ]
+  * Fix incorrect SIGWINCH handling (Closes: #852757)
+
+  [ Johannes Schauer Marin Rodrigues ]
+  * add pattern to select packages by codename (closes: #1002646)
+  * test/integration/test-policy-pinning: test listing multiple package in Package: field
+  * doc/apt_preferences.5.xml: document Package field syntax
+
+  [ Frans Spiesschaert ]
+  * Dutch program translation update (Closes: #1002476)
+
+  [ Julian Andres Klode ]
+  * Introduce and use isalpha_ascii() in debversion rather than isalpha()
+
+ -- Julian Andres Klode <jak@debian.org>  Thu, 06 Jan 2022 20:57:39 +0100
+
 apt (2.3.13) unstable; urgency=medium
 
   [ Alexander Kanavin ]
diff --git a/doc/apt-patterns.7.xml b/doc/apt-patterns.7.xml
index 0c786ce15..45f2f9fd7 100644
--- a/doc/apt-patterns.7.xml
+++ b/doc/apt-patterns.7.xml
@@ -13,7 +13,7 @@
    &apt-email;
    &apt-product;
    <!-- The last update date -->
-   <date>2021-09-07T00:00:00Z</date>
+   <date>2021-12-26T00:00:00Z</date>
  </refentryinfo>
 
  <refmeta>
diff --git a/doc/apt-verbatim.ent b/doc/apt-verbatim.ent
index 33903e1e3..9d11593a3 100644
--- a/doc/apt-verbatim.ent
+++ b/doc/apt-verbatim.ent
@@ -274,7 +274,7 @@
 ">
 
 <!-- this will be updated by 'prepare-release' -->
-<!ENTITY apt-product-version "2.3.13">
+<!ENTITY apt-product-version "2.3.14">
 
 <!-- (Code)names for various things used all over the place -->
 <!ENTITY debian-oldstable-codename "buster">
diff --git a/doc/apt_preferences.5.xml b/doc/apt_preferences.5.xml
index de8cb0664..1b38ae1c6 100644
--- a/doc/apt_preferences.5.xml
+++ b/doc/apt_preferences.5.xml
@@ -13,7 +13,7 @@
    &apt-email;
    &apt-product;
    <!-- The last update date -->
-   <date>2020-08-10T00:00:00Z</date>
+   <date>2022-01-03T00:00:00Z</date>
  </refentryinfo>
 
  <refmeta>
diff --git a/doc/po/apt-doc.pot b/doc/po/apt-doc.pot
index cbaa44bc8..d481cc219 100644
--- a/doc/po/apt-doc.pot
+++ b/doc/po/apt-doc.pot
@@ -5,9 +5,9 @@
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: apt-doc 2.3.13\n"
+"Project-Id-Version: apt-doc 2.3.14\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2021-11-24 16:24+0100\n"
+"POT-Creation-Date: 2022-01-06 20:58+0100\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -4744,17 +4744,37 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><title>
 #: apt_preferences.5.xml
-msgid "Regular expressions and &glob; syntax"
+msgid "Matching packages in the Package field"
 msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><para>
 #: apt_preferences.5.xml
 msgid ""
-"APT also supports pinning by &glob; expressions, and regular expressions "
-"surrounded by slashes. For example, the following example assigns the "
-"priority 500 to all packages from experimental where the name starts with "
-"gnome (as a &glob;-like expression) or contains the word kde (as a POSIX "
-"extended regular expression surrounded by slashes)."
+"The <literal>Package</literal> field specifies the package that a pinning "
+"priority is applied to. The field can either contain a binary package name, "
+"a source package name (prefixed with \"src:\"), a &glob; expression or a "
+"regular expression (surrounded by slashes). Multiple package names, &glob; "
+"expressions and regular expressions can be listed separated by whitespace in "
+"which case the record will match any of the matched packages."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"By default, only packages of the native architecture are matched. To match "
+"binary packages of any architecture, add the <literal>:any</literal> suffix "
+"to the package name. You can also limit matching to a specific architecture "
+"by appending the architecture name to the package name, separated by a colon "
+"character."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"For example, the following example uses a glob expression and a regular "
+"expression to assign the priority 500 to all packages from experimental "
+"where the name starts with gnome (as a &glob;-like expression) or contains "
+"the word kde (as a POSIX extended regular expression surrounded by slashes)."
 msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><programlisting>
@@ -4794,23 +4814,11 @@ msgid ""
 "Package field is not considered a &glob; expression in itself."
 msgstr ""
 
-#. type: Content of: <refentry><refsect1><refsect2><title>
-#: apt_preferences.5.xml
-msgid "Pinning by source package"
-msgstr ""
-
 #. type: Content of: <refentry><refsect1><refsect2><para>
 #: apt_preferences.5.xml
 msgid ""
-"APT supports pinning by source packages. To pin by a source package, prepend "
-"\"src:\" to the package name."
-msgstr ""
-
-#. type: Content of: <refentry><refsect1><refsect2><para>
-#: apt_preferences.5.xml
-msgid ""
-"For example, to pin all binaries produced by the apt source package of this "
-"APT's version to 990, you can do:"
+"To pin all binaries produced by the apt source package of this APT's version "
+"to 990, you can do:"
 msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><programlisting>
@@ -4845,6 +4853,15 @@ msgid ""
 "Pin-Priority: 990\n"
 msgstr ""
 
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"The <literal>:any</literal> suffix makes sure to select binary packages from "
+"any architecture. Without that suffix, apt implicitly assumes the "
+"<literal>:native</literal> suffix which would only select packages from the "
+"native architecture."
+msgstr ""
+
 #. type: Content of: <refentry><refsect1><refsect2><title>
 #: apt_preferences.5.xml
 msgid "How APT Interprets Priorities"
@@ -8268,6 +8285,19 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
 #: apt-patterns.7.xml
+msgid "<code>?codename(REGEX)</code>"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-patterns.7.xml
+msgid ""
+"Selects versions that come from the codename that matches the specified "
+"regular expression. Codename, here, means the values after <code>n=</code> "
+"in <command>apt-cache policy</command>."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
+#: apt-patterns.7.xml
 msgid "<code>?origin(REGEX)</code>"
 msgstr ""
 
diff --git a/doc/po/de.po b/doc/po/de.po
index 05aabe9f4..4dddef902 100644
--- a/doc/po/de.po
+++ b/doc/po/de.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: apt 2.0.1\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2021-10-18 16:36+0200\n"
+"POT-Creation-Date: 2022-01-06 20:58+0100\n"
 "PO-Revision-Date: 2020-04-04 08:45+0200\n"
 "Last-Translator: Chris Leick <c.leick@vollbio.de>\n"
 "Language-Team: German <debian-l10n-german@lists.debian.org>\n"
@@ -6819,17 +6819,44 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><title>
 #: apt_preferences.5.xml
-msgid "Regular expressions and &glob; syntax"
-msgstr "Reguläre Ausdrücke und &glob;-Syntax"
+msgid "Matching packages in the Package field"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"The <literal>Package</literal> field specifies the package that a pinning "
+"priority is applied to. The field can either contain a binary package name, "
+"a source package name (prefixed with \"src:\"), a &glob; expression or a "
+"regular expression (surrounded by slashes). Multiple package names, &glob; "
+"expressions and regular expressions can be listed separated by whitespace in "
+"which case the record will match any of the matched packages."
+msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><para>
 #: apt_preferences.5.xml
 msgid ""
-"APT also supports pinning by &glob; expressions, and regular expressions "
-"surrounded by slashes. For example, the following example assigns the "
-"priority 500 to all packages from experimental where the name starts with "
-"gnome (as a &glob;-like expression) or contains the word kde (as a POSIX "
-"extended regular expression surrounded by slashes)."
+"By default, only packages of the native architecture are matched. To match "
+"binary packages of any architecture, add the <literal>:any</literal> suffix "
+"to the package name. You can also limit matching to a specific architecture "
+"by appending the architecture name to the package name, separated by a colon "
+"character."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+#, fuzzy
+#| msgid ""
+#| "APT also supports pinning by &glob; expressions, and regular expressions "
+#| "surrounded by slashes. For example, the following example assigns the "
+#| "priority 500 to all packages from experimental where the name starts with "
+#| "gnome (as a &glob;-like expression) or contains the word kde (as a POSIX "
+#| "extended regular expression surrounded by slashes)."
+msgid ""
+"For example, the following example uses a glob expression and a regular "
+"expression to assign the priority 500 to all packages from experimental "
+"where the name starts with gnome (as a &glob;-like expression) or contains "
+"the word kde (as a POSIX extended regular expression surrounded by slashes)."
 msgstr ""
 "APT unterstützt außerdem Pinning mittels &glob;-Ausdrücken und regulären "
 "Ausdrücken, die von »/« umschlossen sind. Das folgende Beispiel weist "
@@ -6891,25 +6918,15 @@ msgstr ""
 "außer Kraft setzen können. Das Muster »<literal>*</literal>« in einem "
 "»Package«-Feld wird selbst nicht als ein &glob;-Ausdruck angesehen."
 
-#. type: Content of: <refentry><refsect1><refsect2><title>
-#: apt_preferences.5.xml
-msgid "Pinning by source package"
-msgstr "Pinning nach Quellpaket"
-
-#. type: Content of: <refentry><refsect1><refsect2><para>
-#: apt_preferences.5.xml
-msgid ""
-"APT supports pinning by source packages. To pin by a source package, prepend "
-"\"src:\" to the package name."
-msgstr ""
-"APT unterstützt Pinning nach Quellpaketen. Um Pinning nach Quellpaket "
-"durchzuführen, stellen Sie dem Paketnamen »src:« voran."
-
 #. type: Content of: <refentry><refsect1><refsect2><para>
 #: apt_preferences.5.xml
+#, fuzzy
+#| msgid ""
+#| "For example, to pin all binaries produced by the apt source package of "
+#| "this APT's version to 990, you can do:"
 msgid ""
-"For example, to pin all binaries produced by the apt source package of this "
-"APT's version to 990, you can do:"
+"To pin all binaries produced by the apt source package of this APT's version "
+"to 990, you can do:"
 msgstr ""
 "Um zum Beispiel ein Pinning für alle von einem Apt-Quellpaket dieser APT-"
 "Version erzeugten Programme auf 990 durchzuführen, können Sie Folgendes tun:"
@@ -6958,6 +6975,15 @@ msgstr ""
 "Pin: version *\n"
 "Pin-Priority: 990\n"
 
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"The <literal>:any</literal> suffix makes sure to select binary packages from "
+"any architecture. Without that suffix, apt implicitly assumes the <literal>:"
+"native</literal> suffix which would only select packages from the native "
+"architecture."
+msgstr ""
+
 #. type: Content of: <refentry><refsect1><refsect2><title>
 #: apt_preferences.5.xml
 msgid "How APT Interprets Priorities"
@@ -11746,6 +11772,29 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
 #: apt-patterns.7.xml
+#, fuzzy
+#| msgid "<code>?name(REGEX)</code>"
+msgid "<code>?codename(REGEX)</code>"
+msgstr "<code>?name(REGULÄRER_AUSDRUCK)</code>"
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-patterns.7.xml
+#, fuzzy
+#| msgid ""
+#| "Selects versions that come from the origin that matches the specified "
+#| "regular expression. Origin, here, means the values after <code>o=</code> "
+#| "in <command>apt-cache policy</command>."
+msgid ""
+"Selects versions that come from the codename that matches the specified "
+"regular expression. Codename, here, means the values after <code>n=</code> "
+"in <command>apt-cache policy</command>."
+msgstr ""
+"wählt Versionen aus, deren Ursprung auf den regulären Ausdruck passt. "
+"Ursprung bedeutet hier, die Werte nach <code>o=</code> in <command>apt-cache "
+"policy</command>."
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
+#: apt-patterns.7.xml
 msgid "<code>?origin(REGEX)</code>"
 msgstr "<code>?origin(REGULÄRER_AUSDRUCK)</code>"
 
@@ -13803,6 +13852,19 @@ msgstr ""
 "fortfahren, wodurch die bereits auf der Platte heruntergeladenen Archive "
 "benutzt werden."
 
+#~ msgid "Regular expressions and &glob; syntax"
+#~ msgstr "Reguläre Ausdrücke und &glob;-Syntax"
+
+#~ msgid "Pinning by source package"
+#~ msgstr "Pinning nach Quellpaket"
+
+#~ msgid ""
+#~ "APT supports pinning by source packages. To pin by a source package, "
+#~ "prepend \"src:\" to the package name."
+#~ msgstr ""
+#~ "APT unterstützt Pinning nach Quellpaketen. Um Pinning nach Quellpaket "
+#~ "durchzuführen, stellen Sie dem Paketnamen »src:« voran."
+
 #~ msgid ""
 #~ "Note that if usage of <command>apt-key</command> is desired the "
 #~ "additional installation of the GNU Privacy Guard suite (packaged in "
diff --git a/doc/po/es.po b/doc/po/es.po
index 74a757c10..20f2f30fa 100644
--- a/doc/po/es.po
+++ b/doc/po/es.po
@@ -38,7 +38,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: apt-doc 1.0.5\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2021-10-18 16:36+0200\n"
+"POT-Creation-Date: 2022-01-06 20:58+0100\n"
 "PO-Revision-Date: 2014-07-04 01:31+0200\n"
 "Last-Translator: Omar Campagne <ocampagne@gmail.com>\n"
 "Language-Team: Debian l10n Spanish <debian-l10n-spanish@lists.debian.org>\n"
@@ -6735,17 +6735,44 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><title>
 #: apt_preferences.5.xml
-msgid "Regular expressions and &glob; syntax"
-msgstr "Expresiones regulares y sintaxis &glob;"
+msgid "Matching packages in the Package field"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"The <literal>Package</literal> field specifies the package that a pinning "
+"priority is applied to. The field can either contain a binary package name, "
+"a source package name (prefixed with \"src:\"), a &glob; expression or a "
+"regular expression (surrounded by slashes). Multiple package names, &glob; "
+"expressions and regular expressions can be listed separated by whitespace in "
+"which case the record will match any of the matched packages."
+msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><para>
 #: apt_preferences.5.xml
 msgid ""
-"APT also supports pinning by &glob; expressions, and regular expressions "
-"surrounded by slashes. For example, the following example assigns the "
-"priority 500 to all packages from experimental where the name starts with "
-"gnome (as a &glob;-like expression) or contains the word kde (as a POSIX "
-"extended regular expression surrounded by slashes)."
+"By default, only packages of the native architecture are matched. To match "
+"binary packages of any architecture, add the <literal>:any</literal> suffix "
+"to the package name. You can also limit matching to a specific architecture "
+"by appending the architecture name to the package name, separated by a colon "
+"character."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+#, fuzzy
+#| msgid ""
+#| "APT also supports pinning by &glob; expressions, and regular expressions "
+#| "surrounded by slashes. For example, the following example assigns the "
+#| "priority 500 to all packages from experimental where the name starts with "
+#| "gnome (as a &glob;-like expression) or contains the word kde (as a POSIX "
+#| "extended regular expression surrounded by slashes)."
+msgid ""
+"For example, the following example uses a glob expression and a regular "
+"expression to assign the priority 500 to all packages from experimental "
+"where the name starts with gnome (as a &glob;-like expression) or contains "
+"the word kde (as a POSIX extended regular expression surrounded by slashes)."
 msgstr ""
 "APT también permite el anclaje mediante expresiones &glob;, y expresiones "
 "regulares delimitadas con barras. Por ejemplo, la siguiente opción asigna "
@@ -6806,23 +6833,11 @@ msgstr ""
 "específicos los anulen en caso de ser necesario. El patrón «<literal>*</"
 "literal>» en un campo «Package» no se considera una expresión &glob;."
 
-#. type: Content of: <refentry><refsect1><refsect2><title>
-#: apt_preferences.5.xml
-msgid "Pinning by source package"
-msgstr ""
-
 #. type: Content of: <refentry><refsect1><refsect2><para>
 #: apt_preferences.5.xml
 msgid ""
-"APT supports pinning by source packages. To pin by a source package, prepend "
-"\"src:\" to the package name."
-msgstr ""
-
-#. type: Content of: <refentry><refsect1><refsect2><para>
-#: apt_preferences.5.xml
-msgid ""
-"For example, to pin all binaries produced by the apt source package of this "
-"APT's version to 990, you can do:"
+"To pin all binaries produced by the apt source package of this APT's version "
+"to 990, you can do:"
 msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><programlisting>
@@ -6871,6 +6886,15 @@ msgstr ""
 "Pin: origin \"\"\n"
 "Pin-Priority: 999\n"
 
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"The <literal>:any</literal> suffix makes sure to select binary packages from "
+"any architecture. Without that suffix, apt implicitly assumes the <literal>:"
+"native</literal> suffix which would only select packages from the native "
+"architecture."
+msgstr ""
+
 #. type: Content of: <refentry><refsect1><refsect2><title>
 #: apt_preferences.5.xml
 msgid "How APT Interprets Priorities"
@@ -11184,6 +11208,19 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
 #: apt-patterns.7.xml
+msgid "<code>?codename(REGEX)</code>"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-patterns.7.xml
+msgid ""
+"Selects versions that come from the codename that matches the specified "
+"regular expression. Codename, here, means the values after <code>n=</code> "
+"in <command>apt-cache policy</command>."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
+#: apt-patterns.7.xml
 msgid "<code>?origin(REGEX)</code>"
 msgstr ""
 
@@ -13118,6 +13155,9 @@ msgstr "  # apt-get -o dir::cache::archives=\"/disc/\" dist-upgrade\n"
 msgid "Which will use the already fetched archives on the disc."
 msgstr "Esto utiliza los archivos del disco previamente obtenidos."
 
+#~ msgid "Regular expressions and &glob; syntax"
+#~ msgstr "Expresiones regulares y sintaxis &glob;"
+
 #~ msgid ""
 #~ "<literal>http::Proxy</literal> sets the default proxy to use for HTTP "
 #~ "URIs. It is in the standard form of <literal>http://[[user][:pass]@]host[:"
diff --git a/doc/po/fr.po b/doc/po/fr.po
index 07fee6795..1a4ae8415 100644
--- a/doc/po/fr.po
+++ b/doc/po/fr.po
@@ -12,7 +12,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: apt-doc 1.8.0\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2021-10-18 16:36+0200\n"
+"POT-Creation-Date: 2022-01-06 20:58+0100\n"
 "PO-Revision-Date: 2019-05-01 17:00+0100\n"
 "Last-Translator: Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>\n"
 "Language-Team: French <debian-l10n-french@lists.debian.org>\n"
@@ -6788,17 +6788,44 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><title>
 #: apt_preferences.5.xml
-msgid "Regular expressions and &glob; syntax"
-msgstr "Expressions régulières et syntaxe &glob;"
+msgid "Matching packages in the Package field"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"The <literal>Package</literal> field specifies the package that a pinning "
+"priority is applied to. The field can either contain a binary package name, "
+"a source package name (prefixed with \"src:\"), a &glob; expression or a "
+"regular expression (surrounded by slashes). Multiple package names, &glob; "
+"expressions and regular expressions can be listed separated by whitespace in "
+"which case the record will match any of the matched packages."
+msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><para>
 #: apt_preferences.5.xml
 msgid ""
-"APT also supports pinning by &glob; expressions, and regular expressions "
-"surrounded by slashes. For example, the following example assigns the "
-"priority 500 to all packages from experimental where the name starts with "
-"gnome (as a &glob;-like expression) or contains the word kde (as a POSIX "
-"extended regular expression surrounded by slashes)."
+"By default, only packages of the native architecture are matched. To match "
+"binary packages of any architecture, add the <literal>:any</literal> suffix "
+"to the package name. You can also limit matching to a specific architecture "
+"by appending the architecture name to the package name, separated by a colon "
+"character."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+#, fuzzy
+#| msgid ""
+#| "APT also supports pinning by &glob; expressions, and regular expressions "
+#| "surrounded by slashes. For example, the following example assigns the "
+#| "priority 500 to all packages from experimental where the name starts with "
+#| "gnome (as a &glob;-like expression) or contains the word kde (as a POSIX "
+#| "extended regular expression surrounded by slashes)."
+msgid ""
+"For example, the following example uses a glob expression and a regular "
+"expression to assign the priority 500 to all packages from experimental "
+"where the name starts with gnome (as a &glob;-like expression) or contains "
+"the word kde (as a POSIX extended regular expression surrounded by slashes)."
 msgstr ""
 "APT gére également l'épinglage (« pinning ») avec des expressions &glob; et "
 "des expressions régulières entourées par des barres obliques. Par exemple, "
@@ -6862,23 +6889,11 @@ msgstr ""
 "« <literal>*</literal> » dans un champ Package n'est pas considéré comme une "
 "expression &glob; en soi."
 
-#. type: Content of: <refentry><refsect1><refsect2><title>
-#: apt_preferences.5.xml
-msgid "Pinning by source package"
-msgstr ""
-
 #. type: Content of: <refentry><refsect1><refsect2><para>
 #: apt_preferences.5.xml
 msgid ""
-"APT supports pinning by source packages. To pin by a source package, prepend "
-"\"src:\" to the package name."
-msgstr ""
-
-#. type: Content of: <refentry><refsect1><refsect2><para>
-#: apt_preferences.5.xml
-msgid ""
-"For example, to pin all binaries produced by the apt source package of this "
-"APT's version to 990, you can do:"
+"To pin all binaries produced by the apt source package of this APT's version "
+"to 990, you can do:"
 msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><programlisting>
@@ -6927,6 +6942,15 @@ msgstr ""
 "Pin: origin \"\"\n"
 "Pin-Priority: 999\n"
 
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"The <literal>:any</literal> suffix makes sure to select binary packages from "
+"any architecture. Without that suffix, apt implicitly assumes the <literal>:"
+"native</literal> suffix which would only select packages from the native "
+"architecture."
+msgstr ""
+
 #. type: Content of: <refentry><refsect1><refsect2><title>
 #: apt_preferences.5.xml
 msgid "How APT Interprets Priorities"
@@ -11649,6 +11673,19 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
 #: apt-patterns.7.xml
+msgid "<code>?codename(REGEX)</code>"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-patterns.7.xml
+msgid ""
+"Selects versions that come from the codename that matches the specified "
+"regular expression. Codename, here, means the values after <code>n=</code> "
+"in <command>apt-cache policy</command>."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
+#: apt-patterns.7.xml
 msgid "<code>?origin(REGEX)</code>"
 msgstr ""
 
@@ -13623,6 +13660,9 @@ msgstr "  # apt-get -o dir::cache::archives=\"/disc/\" dist-upgrade\n"
 msgid "Which will use the already fetched archives on the disc."
 msgstr "Cette commande utilisera les fichiers récupérés sur le disque."
 
+#~ msgid "Regular expressions and &glob; syntax"
+#~ msgstr "Expressions régulières et syntaxe &glob;"
+
 #~ msgid ""
 #~ "Note that if usage of <command>apt-key</command> is desired the "
 #~ "additional installation of the GNU Privacy Guard suite (packaged in "
diff --git a/doc/po/it.po b/doc/po/it.po
index 88c73e117..99a3b25d5 100644
--- a/doc/po/it.po
+++ b/doc/po/it.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: apt-doc 1.0.5\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2021-10-18 16:36+0200\n"
+"POT-Creation-Date: 2022-01-06 20:58+0100\n"
 "PO-Revision-Date: 2017-03-27 19:05+0200\n"
 "Last-Translator: Beatrice Torracca <beatricet@libero.it>\n"
 "Language-Team: Italian <debian-l10n-italian@lists.debian.org>\n"
@@ -6778,20 +6778,46 @@ msgstr ""
 "Esiste una sola eccezione: per ciascun tipo di condizione (come due "
 "condizioni «a»), solo l'ultima di queste condizioni viene controllata."
 
-# &glob; è rimpiazzato da "glob(7)"
 #. type: Content of: <refentry><refsect1><refsect2><title>
 #: apt_preferences.5.xml
-msgid "Regular expressions and &glob; syntax"
-msgstr "Sintassi per le espressioni regolari e &glob;"
+msgid "Matching packages in the Package field"
+msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><para>
 #: apt_preferences.5.xml
 msgid ""
-"APT also supports pinning by &glob; expressions, and regular expressions "
-"surrounded by slashes. For example, the following example assigns the "
-"priority 500 to all packages from experimental where the name starts with "
-"gnome (as a &glob;-like expression) or contains the word kde (as a POSIX "
-"extended regular expression surrounded by slashes)."
+"The <literal>Package</literal> field specifies the package that a pinning "
+"priority is applied to. The field can either contain a binary package name, "
+"a source package name (prefixed with \"src:\"), a &glob; expression or a "
+"regular expression (surrounded by slashes). Multiple package names, &glob; "
+"expressions and regular expressions can be listed separated by whitespace in "
+"which case the record will match any of the matched packages."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"By default, only packages of the native architecture are matched. To match "
+"binary packages of any architecture, add the <literal>:any</literal> suffix "
+"to the package name. You can also limit matching to a specific architecture "
+"by appending the architecture name to the package name, separated by a colon "
+"character."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+#, fuzzy
+#| msgid ""
+#| "APT also supports pinning by &glob; expressions, and regular expressions "
+#| "surrounded by slashes. For example, the following example assigns the "
+#| "priority 500 to all packages from experimental where the name starts with "
+#| "gnome (as a &glob;-like expression) or contains the word kde (as a POSIX "
+#| "extended regular expression surrounded by slashes)."
+msgid ""
+"For example, the following example uses a glob expression and a regular "
+"expression to assign the priority 500 to all packages from experimental "
+"where the name starts with gnome (as a &glob;-like expression) or contains "
+"the word kde (as a POSIX extended regular expression surrounded by slashes)."
 msgstr ""
 "APT permette anche di impostare priorità di pin usando espressioni &glob; ed "
 "espressioni regolari racchiuse tra sbarre («/»). L'esempio seguente assegna, "
@@ -6854,23 +6880,11 @@ msgstr ""
 "precedenza su di essi. Il modello «<literal>*</literal>» in un campo Package "
 "non viene considerato come un'espressione &glob;."
 
-#. type: Content of: <refentry><refsect1><refsect2><title>
-#: apt_preferences.5.xml
-msgid "Pinning by source package"
-msgstr ""
-
 #. type: Content of: <refentry><refsect1><refsect2><para>
 #: apt_preferences.5.xml
 msgid ""
-"APT supports pinning by source packages. To pin by a source package, prepend "
-"\"src:\" to the package name."
-msgstr ""
-
-#. type: Content of: <refentry><refsect1><refsect2><para>
-#: apt_preferences.5.xml
-msgid ""
-"For example, to pin all binaries produced by the apt source package of this "
-"APT's version to 990, you can do:"
+"To pin all binaries produced by the apt source package of this APT's version "
+"to 990, you can do:"
 msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><programlisting>
@@ -6919,6 +6933,15 @@ msgstr ""
 "Pin: origin \"\"\n"
 "Pin-Priority: 999\n"
 
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"The <literal>:any</literal> suffix makes sure to select binary packages from "
+"any architecture. Without that suffix, apt implicitly assumes the <literal>:"
+"native</literal> suffix which would only select packages from the native "
+"architecture."
+msgstr ""
+
 #. type: Content of: <refentry><refsect1><refsect2><title>
 #: apt_preferences.5.xml
 msgid "How APT Interprets Priorities"
@@ -11400,6 +11423,21 @@ msgstr ""
 #: apt-patterns.7.xml
 #, fuzzy
 #| msgid "<option>--installed</option>"
+msgid "<code>?codename(REGEX)</code>"
+msgstr "<option>--installed</option>"
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-patterns.7.xml
+msgid ""
+"Selects versions that come from the codename that matches the specified "
+"regular expression. Codename, here, means the values after <code>n=</code> "
+"in <command>apt-cache policy</command>."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
+#: apt-patterns.7.xml
+#, fuzzy
+#| msgid "<option>--installed</option>"
 msgid "<code>?origin(REGEX)</code>"
 msgstr "<option>--installed</option>"
 
@@ -13401,6 +13439,10 @@ msgstr "  # apt-get -o dir::cache::archives=\"/disc/\" dist-upgrade\n"
 msgid "Which will use the already fetched archives on the disc."
 msgstr "che userà gli archivi già scaricati e presenti sul disco."
 
+# &glob; è rimpiazzato da "glob(7)"
+#~ msgid "Regular expressions and &glob; syntax"
+#~ msgstr "Sintassi per le espressioni regolari e &glob;"
+
 #~ msgid ""
 #~ "Note that if usage of <command>apt-key</command> is desired the "
 #~ "additional installation of the GNU Privacy Guard suite (packaged in "
diff --git a/doc/po/ja.po b/doc/po/ja.po
index de678da9a..c468dfdbc 100644
--- a/doc/po/ja.po
+++ b/doc/po/ja.po
@@ -10,7 +10,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: apt-doc 1.4\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2021-10-18 16:36+0200\n"
+"POT-Creation-Date: 2022-01-06 20:58+0100\n"
 "PO-Revision-Date: 2017-01-06 04:50+0900\n"
 "Last-Translator: Takuma Yamada <tyamada@takumayamada.com>\n"
 "Language-Team: Japanese <debian-japanese@lists.debian.org>\n"
@@ -6500,17 +6500,44 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><title>
 #: apt_preferences.5.xml
-msgid "Regular expressions and &glob; syntax"
-msgstr "正規表現と &glob; 構文"
+msgid "Matching packages in the Package field"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"The <literal>Package</literal> field specifies the package that a pinning "
+"priority is applied to. The field can either contain a binary package name, "
+"a source package name (prefixed with \"src:\"), a &glob; expression or a "
+"regular expression (surrounded by slashes). Multiple package names, &glob; "
+"expressions and regular expressions can be listed separated by whitespace in "
+"which case the record will match any of the matched packages."
+msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><para>
 #: apt_preferences.5.xml
 msgid ""
-"APT also supports pinning by &glob; expressions, and regular expressions "
-"surrounded by slashes. For example, the following example assigns the "
-"priority 500 to all packages from experimental where the name starts with "
-"gnome (as a &glob;-like expression) or contains the word kde (as a POSIX "
-"extended regular expression surrounded by slashes)."
+"By default, only packages of the native architecture are matched. To match "
+"binary packages of any architecture, add the <literal>:any</literal> suffix "
+"to the package name. You can also limit matching to a specific architecture "
+"by appending the architecture name to the package name, separated by a colon "
+"character."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+#, fuzzy
+#| msgid ""
+#| "APT also supports pinning by &glob; expressions, and regular expressions "
+#| "surrounded by slashes. For example, the following example assigns the "
+#| "priority 500 to all packages from experimental where the name starts with "
+#| "gnome (as a &glob;-like expression) or contains the word kde (as a POSIX "
+#| "extended regular expression surrounded by slashes)."
+msgid ""
+"For example, the following example uses a glob expression and a regular "
+"expression to assign the priority 500 to all packages from experimental "
+"where the name starts with gnome (as a &glob;-like expression) or contains "
+"the word kde (as a POSIX extended regular expression surrounded by slashes)."
 msgstr ""
 "APT は &glob; 表現と、スラッシュで囲んだ正規表現による pin もサポートしていま"
 "す。例えば以下の例は、gnome で始まる (&glob; 風表現) か kde を含む (スラッ"
@@ -6569,23 +6596,11 @@ msgstr ""
 "ます。Package フィールドの \"<literal>*</literal>\" パターンは、&glob; 表現自"
 "体とは見なされません。"
 
-#. type: Content of: <refentry><refsect1><refsect2><title>
-#: apt_preferences.5.xml
-msgid "Pinning by source package"
-msgstr ""
-
 #. type: Content of: <refentry><refsect1><refsect2><para>
 #: apt_preferences.5.xml
 msgid ""
-"APT supports pinning by source packages. To pin by a source package, prepend "
-"\"src:\" to the package name."
-msgstr ""
-
-#. type: Content of: <refentry><refsect1><refsect2><para>
-#: apt_preferences.5.xml
-msgid ""
-"For example, to pin all binaries produced by the apt source package of this "
-"APT's version to 990, you can do:"
+"To pin all binaries produced by the apt source package of this APT's version "
+"to 990, you can do:"
 msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><programlisting>
@@ -6634,6 +6649,15 @@ msgstr ""
 "Pin: origin \"\"\n"
 "Pin-Priority: 999\n"
 
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"The <literal>:any</literal> suffix makes sure to select binary packages from "
+"any architecture. Without that suffix, apt implicitly assumes the <literal>:"
+"native</literal> suffix which would only select packages from the native "
+"architecture."
+msgstr ""
+
 #. type: Content of: <refentry><refsect1><refsect2><title>
 #: apt_preferences.5.xml
 msgid "How APT Interprets Priorities"
@@ -10962,6 +10986,19 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
 #: apt-patterns.7.xml
+msgid "<code>?codename(REGEX)</code>"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-patterns.7.xml
+msgid ""
+"Selects versions that come from the codename that matches the specified "
+"regular expression. Codename, here, means the values after <code>n=</code> "
+"in <command>apt-cache policy</command>."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
+#: apt-patterns.7.xml
 msgid "<code>?origin(REGEX)</code>"
 msgstr ""
 
@@ -12857,6 +12894,9 @@ msgstr "  # apt-get -o dir::cache::archives=\"/disc/\" dist-upgrade\n"
 msgid "Which will use the already fetched archives on the disc."
 msgstr "これで、ディスクにある取得済みのアーカイブを使用するようになります。"
 
+#~ msgid "Regular expressions and &glob; syntax"
+#~ msgstr "正規表現と &glob; 構文"
+
 #~ msgid ""
 #~ "Note that if usage of <command>apt-key</command> is desired the "
 #~ "additional installation of the GNU Privacy Guard suite (packaged in "
diff --git a/doc/po/nl.po b/doc/po/nl.po
index 991634778..6162181ef 100644
--- a/doc/po/nl.po
+++ b/doc/po/nl.po
@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: apt-doc 2.3.11\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2021-11-09 15:29+0100\n"
+"POT-Creation-Date: 2022-01-06 20:58+0100\n"
 "PO-Revision-Date: 2021-10-25 12:46+0200\n"
 "Last-Translator: Frans Spiesschaert <Frans.Spiesschaert@yucom.be>\n"
 "Language-Team: Debian Dutch l10n Team <debian-l10n-dutch@lists.debian.org>\n"
@@ -6945,17 +6945,44 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><title>
 #: apt_preferences.5.xml
-msgid "Regular expressions and &glob; syntax"
-msgstr "Reguliere expressies en &glob; syntaxis"
+msgid "Matching packages in the Package field"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"The <literal>Package</literal> field specifies the package that a pinning "
+"priority is applied to. The field can either contain a binary package name, "
+"a source package name (prefixed with \"src:\"), a &glob; expression or a "
+"regular expression (surrounded by slashes). Multiple package names, &glob; "
+"expressions and regular expressions can be listed separated by whitespace in "
+"which case the record will match any of the matched packages."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"By default, only packages of the native architecture are matched. To match "
+"binary packages of any architecture, add the <literal>:any</literal> suffix "
+"to the package name. You can also limit matching to a specific architecture "
+"by appending the architecture name to the package name, separated by a colon "
+"character."
+msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><para>
 #: apt_preferences.5.xml
+#, fuzzy
+#| msgid ""
+#| "APT also supports pinning by &glob; expressions, and regular expressions "
+#| "surrounded by slashes. For example, the following example assigns the "
+#| "priority 500 to all packages from experimental where the name starts with "
+#| "gnome (as a &glob;-like expression) or contains the word kde (as a POSIX "
+#| "extended regular expression surrounded by slashes)."
 msgid ""
-"APT also supports pinning by &glob; expressions, and regular expressions "
-"surrounded by slashes. For example, the following example assigns the "
-"priority 500 to all packages from experimental where the name starts with "
-"gnome (as a &glob;-like expression) or contains the word kde (as a POSIX "
-"extended regular expression surrounded by slashes)."
+"For example, the following example uses a glob expression and a regular "
+"expression to assign the priority 500 to all packages from experimental "
+"where the name starts with gnome (as a &glob;-like expression) or contains "
+"the word kde (as a POSIX extended regular expression surrounded by slashes)."
 msgstr ""
 "APT ondersteunt bij het pinnen ook het gebruik van &glob;-expressies, en "
 "reguliere expressies die door slashes ingesloten worden. Het volgende "
@@ -7017,25 +7044,15 @@ msgstr ""
 "\" in een Package-veld wordt op zichzelf niet als een &glob;-expressie "
 "beschouwd."
 
-#. type: Content of: <refentry><refsect1><refsect2><title>
-#: apt_preferences.5.xml
-msgid "Pinning by source package"
-msgstr "Vastzetten op bronpakket"
-
-#. type: Content of: <refentry><refsect1><refsect2><para>
-#: apt_preferences.5.xml
-msgid ""
-"APT supports pinning by source packages. To pin by a source package, prepend "
-"\"src:\" to the package name."
-msgstr ""
-"APT ondersteunt het vastzetten op bronpakket. Om op een bronpakket vast te "
-"zetten, laat u \"src:\" voorafgaan aan de pakketnaam."
-
 #. type: Content of: <refentry><refsect1><refsect2><para>
 #: apt_preferences.5.xml
+#, fuzzy
+#| msgid ""
+#| "For example, to pin all binaries produced by the apt source package of "
+#| "this APT's version to 990, you can do:"
 msgid ""
-"For example, to pin all binaries produced by the apt source package of this "
-"APT's version to 990, you can do:"
+"To pin all binaries produced by the apt source package of this APT's version "
+"to 990, you can do:"
 msgstr ""
 "Bijvoorbeeld, om alle binaire pakketten die met het apt-bronpakket van deze "
 "APT-versie geproduceerd worden, vast te zetten op 990, kunt u als volgt te "
@@ -7085,6 +7102,15 @@ msgstr ""
 "Pin: version *\n"
 "Pin-Priority: 990\n"
 
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"The <literal>:any</literal> suffix makes sure to select binary packages from "
+"any architecture. Without that suffix, apt implicitly assumes the <literal>:"
+"native</literal> suffix which would only select packages from the native "
+"architecture."
+msgstr ""
+
 #. type: Content of: <refentry><refsect1><refsect2><title>
 #: apt_preferences.5.xml
 msgid "How APT Interprets Priorities"
@@ -11904,6 +11930,29 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
 #: apt-patterns.7.xml
+#, fuzzy
+#| msgid "<code>?name(REGEX)</code>"
+msgid "<code>?codename(REGEX)</code>"
+msgstr "<code>?name(REGEX)</code>"
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-patterns.7.xml
+#, fuzzy
+#| msgid ""
+#| "Selects versions that come from the origin that matches the specified "
+#| "regular expression. Origin, here, means the values after <code>o=</code> "
+#| "in <command>apt-cache policy</command>."
+msgid ""
+"Selects versions that come from the codename that matches the specified "
+"regular expression. Codename, here, means the values after <code>n=</code> "
+"in <command>apt-cache policy</command>."
+msgstr ""
+"Selecteert versies die afkomstig zijn van de origine die overeenkomt met de "
+"opgegeven reguliere expressie. Origine (origin) betekent hier de waarden na "
+"<code>o=</code> in <command>apt-cache policy</command>."
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
+#: apt-patterns.7.xml
 msgid "<code>?origin(REGEX)</code>"
 msgstr "<code>?origin(REGEX)</code>"
 
@@ -13941,3 +13990,16 @@ msgstr "  # apt-get -o dir::cache::archives=\"/disc/\" dist-upgrade\n"
 msgid "Which will use the already fetched archives on the disc."
 msgstr ""
 "En dit zal gebruik maken van de reeds opgehaalde archieven op de schijf."
+
+#~ msgid "Regular expressions and &glob; syntax"
+#~ msgstr "Reguliere expressies en &glob; syntaxis"
+
+#~ msgid "Pinning by source package"
+#~ msgstr "Vastzetten op bronpakket"
+
+#~ msgid ""
+#~ "APT supports pinning by source packages. To pin by a source package, "
+#~ "prepend \"src:\" to the package name."
+#~ msgstr ""
+#~ "APT ondersteunt het vastzetten op bronpakket. Om op een bronpakket vast "
+#~ "te zetten, laat u \"src:\" voorafgaan aan de pakketnaam."
diff --git a/doc/po/pl.po b/doc/po/pl.po
index 182597bbd..6a6a2fa4c 100644
--- a/doc/po/pl.po
+++ b/doc/po/pl.po
@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: apt-doc 1.0.5\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2021-10-18 16:36+0200\n"
+"POT-Creation-Date: 2022-01-06 20:58+0100\n"
 "PO-Revision-Date: 2014-07-04 02:13+0200\n"
 "Last-Translator: Robert Luberda <robert@debian.org>\n"
 "Language-Team: Polish <manpages-pl-list@lists.sourceforge.net>\n"
@@ -6165,17 +6165,44 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><title>
 #: apt_preferences.5.xml
-msgid "Regular expressions and &glob; syntax"
-msgstr "Składnia wyrażeń regularnych i &glob;"
+msgid "Matching packages in the Package field"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"The <literal>Package</literal> field specifies the package that a pinning "
+"priority is applied to. The field can either contain a binary package name, "
+"a source package name (prefixed with \"src:\"), a &glob; expression or a "
+"regular expression (surrounded by slashes). Multiple package names, &glob; "
+"expressions and regular expressions can be listed separated by whitespace in "
+"which case the record will match any of the matched packages."
+msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><para>
 #: apt_preferences.5.xml
 msgid ""
-"APT also supports pinning by &glob; expressions, and regular expressions "
-"surrounded by slashes. For example, the following example assigns the "
-"priority 500 to all packages from experimental where the name starts with "
-"gnome (as a &glob;-like expression) or contains the word kde (as a POSIX "
-"extended regular expression surrounded by slashes)."
+"By default, only packages of the native architecture are matched. To match "
+"binary packages of any architecture, add the <literal>:any</literal> suffix "
+"to the package name. You can also limit matching to a specific architecture "
+"by appending the architecture name to the package name, separated by a colon "
+"character."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+#, fuzzy
+#| msgid ""
+#| "APT also supports pinning by &glob; expressions, and regular expressions "
+#| "surrounded by slashes. For example, the following example assigns the "
+#| "priority 500 to all packages from experimental where the name starts with "
+#| "gnome (as a &glob;-like expression) or contains the word kde (as a POSIX "
+#| "extended regular expression surrounded by slashes)."
+msgid ""
+"For example, the following example uses a glob expression and a regular "
+"expression to assign the priority 500 to all packages from experimental "
+"where the name starts with gnome (as a &glob;-like expression) or contains "
+"the word kde (as a POSIX extended regular expression surrounded by slashes)."
 msgstr ""
 "APT także wspiera dopasowywanie przy użyciu wzorców &glob; i wyrażeń "
 "regularnych otoczonych znakami /. Następujący przykład ustawia priorytet 500 "
@@ -6238,23 +6265,11 @@ msgstr ""
 "dotyczące specyficznych pakietów. Wzorzec \"<literal>*</literal>\" w polu "
 "<literal>Package</literal> nie jest uznawany za wyrażenie &glob;."
 
-#. type: Content of: <refentry><refsect1><refsect2><title>
-#: apt_preferences.5.xml
-msgid "Pinning by source package"
-msgstr ""
-
 #. type: Content of: <refentry><refsect1><refsect2><para>
 #: apt_preferences.5.xml
 msgid ""
-"APT supports pinning by source packages. To pin by a source package, prepend "
-"\"src:\" to the package name."
-msgstr ""
-
-#. type: Content of: <refentry><refsect1><refsect2><para>
-#: apt_preferences.5.xml
-msgid ""
-"For example, to pin all binaries produced by the apt source package of this "
-"APT's version to 990, you can do:"
+"To pin all binaries produced by the apt source package of this APT's version "
+"to 990, you can do:"
 msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><programlisting>
@@ -6303,6 +6318,15 @@ msgstr ""
 "Pin: origin \"\"\n"
 "Pin-Priority: 999\n"
 
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"The <literal>:any</literal> suffix makes sure to select binary packages from "
+"any architecture. Without that suffix, apt implicitly assumes the <literal>:"
+"native</literal> suffix which would only select packages from the native "
+"architecture."
+msgstr ""
+
 #. type: Content of: <refentry><refsect1><refsect2><title>
 #: apt_preferences.5.xml
 msgid "How APT Interprets Priorities"
@@ -10328,6 +10352,19 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
 #: apt-patterns.7.xml
+msgid "<code>?codename(REGEX)</code>"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-patterns.7.xml
+msgid ""
+"Selects versions that come from the codename that matches the specified "
+"regular expression. Codename, here, means the values after <code>n=</code> "
+"in <command>apt-cache policy</command>."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
+#: apt-patterns.7.xml
 msgid "<code>?origin(REGEX)</code>"
 msgstr ""
 
@@ -12275,6 +12312,9 @@ msgstr "  # apt-get -o dir::cache::archives=\"/disc/\" dist-upgrade\n"
 msgid "Which will use the already fetched archives on the disc."
 msgstr "Które użyje pobranych uprzednio archiwów z dysku."
 
+#~ msgid "Regular expressions and &glob; syntax"
+#~ msgstr "Składnia wyrażeń regularnych i &glob;"
+
 #~ msgid ""
 #~ "The http scheme specifies an HTTP server for the archive. If an "
 #~ "environment variable <envar>http_proxy</envar> is set with the format "
diff --git a/doc/po/pt.po b/doc/po/pt.po
index 9112e6c0d..3be367ef9 100644
--- a/doc/po/pt.po
+++ b/doc/po/pt.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: apt 2.3.12\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2021-11-23 14:13+0100\n"
+"POT-Creation-Date: 2022-01-06 20:58+0100\n"
 "PO-Revision-Date: 2021-11-22 22:20+0000\n"
 "Last-Translator: Américo Monteiro <a_monteiro@gmx.com>\n"
 "Language-Team: Portuguese <>\n"
@@ -6745,17 +6745,44 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><title>
 #: apt_preferences.5.xml
-msgid "Regular expressions and &glob; syntax"
-msgstr "Expressões regulares e sintaxe &glob;"
+msgid "Matching packages in the Package field"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"The <literal>Package</literal> field specifies the package that a pinning "
+"priority is applied to. The field can either contain a binary package name, "
+"a source package name (prefixed with \"src:\"), a &glob; expression or a "
+"regular expression (surrounded by slashes). Multiple package names, &glob; "
+"expressions and regular expressions can be listed separated by whitespace in "
+"which case the record will match any of the matched packages."
+msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><para>
 #: apt_preferences.5.xml
 msgid ""
-"APT also supports pinning by &glob; expressions, and regular expressions "
-"surrounded by slashes. For example, the following example assigns the "
-"priority 500 to all packages from experimental where the name starts with "
-"gnome (as a &glob;-like expression) or contains the word kde (as a POSIX "
-"extended regular expression surrounded by slashes)."
+"By default, only packages of the native architecture are matched. To match "
+"binary packages of any architecture, add the <literal>:any</literal> suffix "
+"to the package name. You can also limit matching to a specific architecture "
+"by appending the architecture name to the package name, separated by a colon "
+"character."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+#, fuzzy
+#| msgid ""
+#| "APT also supports pinning by &glob; expressions, and regular expressions "
+#| "surrounded by slashes. For example, the following example assigns the "
+#| "priority 500 to all packages from experimental where the name starts with "
+#| "gnome (as a &glob;-like expression) or contains the word kde (as a POSIX "
+#| "extended regular expression surrounded by slashes)."
+msgid ""
+"For example, the following example uses a glob expression and a regular "
+"expression to assign the priority 500 to all packages from experimental "
+"where the name starts with gnome (as a &glob;-like expression) or contains "
+"the word kde (as a POSIX extended regular expression surrounded by slashes)."
 msgstr ""
 "O APT também suporta \"pinning\" por expressões &glob;, e expressões "
 "regulares rodeadas por barras. Por exemplo, o seguinte designa a prioridade "
@@ -6816,25 +6843,15 @@ msgstr ""
 "sobreporem. O padrão \"<literal>*</literal>\" num campo Package não é "
 "considerado uma expressão &glob; em si próprio."
 
-#. type: Content of: <refentry><refsect1><refsect2><title>
-#: apt_preferences.5.xml
-msgid "Pinning by source package"
-msgstr "Fixação pelo pacote de origem"
-
-#. type: Content of: <refentry><refsect1><refsect2><para>
-#: apt_preferences.5.xml
-msgid ""
-"APT supports pinning by source packages. To pin by a source package, prepend "
-"\"src:\" to the package name."
-msgstr ""
-"O APT suporta fixar pelo pacote fonte. Para fixar um pacote fonte, preceda "
-"\"src:\" ao nome do pacote."
-
 #. type: Content of: <refentry><refsect1><refsect2><para>
 #: apt_preferences.5.xml
+#, fuzzy
+#| msgid ""
+#| "For example, to pin all binaries produced by the apt source package of "
+#| "this APT's version to 990, you can do:"
 msgid ""
-"For example, to pin all binaries produced by the apt source package of this "
-"APT's version to 990, you can do:"
+"To pin all binaries produced by the apt source package of this APT's version "
+"to 990, you can do:"
 msgstr ""
 "Por exemplo, para fixar todos os binários produzidos pelo pacote fonte do "
 "apt desta versão do APT para 990, você pode fazer:"
@@ -6881,6 +6898,15 @@ msgstr ""
 "Pin: version *\n"
 "Pin-Priority: 990\n"
 
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"The <literal>:any</literal> suffix makes sure to select binary packages from "
+"any architecture. Without that suffix, apt implicitly assumes the <literal>:"
+"native</literal> suffix which would only select packages from the native "
+"architecture."
+msgstr ""
+
 #. type: Content of: <refentry><refsect1><refsect2><title>
 #: apt_preferences.5.xml
 msgid "How APT Interprets Priorities"
@@ -11588,6 +11614,29 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
 #: apt-patterns.7.xml
+#, fuzzy
+#| msgid "<code>?name(REGEX)</code>"
+msgid "<code>?codename(REGEX)</code>"
+msgstr "<code>?name(REGEX)</code>"
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-patterns.7.xml
+#, fuzzy
+#| msgid ""
+#| "Selects versions that come from the origin that matches the specified "
+#| "regular expression. Origin, here, means the values after <code>o=</code> "
+#| "in <command>apt-cache policy</command>."
+msgid ""
+"Selects versions that come from the codename that matches the specified "
+"regular expression. Codename, here, means the values after <code>n=</code> "
+"in <command>apt-cache policy</command>."
+msgstr ""
+"Seleciona versões que vêm do arquivo que correspondem à expressão regular "
+"fornecida. Origin, aqui, significa os valores após <code>a=</code> em  "
+"<command>apt-cache policy</command>."
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
+#: apt-patterns.7.xml
 msgid "<code>?origin(REGEX)</code>"
 msgstr "<code>?origin(REGEX)</code>"
 
@@ -13554,6 +13603,19 @@ msgstr "  # apt-get -o dir::cache::archives=\"/disc/\" dist-upgrade\n"
 msgid "Which will use the already fetched archives on the disc."
 msgstr "O qual irá usar os arquivos já obtidos e que estão no disco."
 
+#~ msgid "Regular expressions and &glob; syntax"
+#~ msgstr "Expressões regulares e sintaxe &glob;"
+
+#~ msgid "Pinning by source package"
+#~ msgstr "Fixação pelo pacote de origem"
+
+#~ msgid ""
+#~ "APT supports pinning by source packages. To pin by a source package, "
+#~ "prepend \"src:\" to the package name."
+#~ msgstr ""
+#~ "O APT suporta fixar pelo pacote fonte. Para fixar um pacote fonte, "
+#~ "preceda \"src:\" ao nome do pacote."
+
 #~ msgid ""
 #~ "Note that if usage of <command>apt-key</command> is desired the "
 #~ "additional installation of the GNU Privacy Guard suite (packaged in "
diff --git a/doc/po/pt_BR.po b/doc/po/pt_BR.po
index 8573a2c75..5c2b2b74c 100644
--- a/doc/po/pt_BR.po
+++ b/doc/po/pt_BR.po
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: apt-doc 1.0.5\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2021-10-18 16:36+0200\n"
+"POT-Creation-Date: 2022-01-06 20:58+0100\n"
 "PO-Revision-Date: 2004-09-20 17:02+0000\n"
 "Last-Translator: André Luís Lopes <andrelop@debian.org>\n"
 "Language-Team: <debian-l10n-portuguese@lists.debian.org>\n"
@@ -4838,17 +4838,37 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><title>
 #: apt_preferences.5.xml
-msgid "Regular expressions and &glob; syntax"
+msgid "Matching packages in the Package field"
 msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><para>
 #: apt_preferences.5.xml
 msgid ""
-"APT also supports pinning by &glob; expressions, and regular expressions "
-"surrounded by slashes. For example, the following example assigns the "
-"priority 500 to all packages from experimental where the name starts with "
-"gnome (as a &glob;-like expression) or contains the word kde (as a POSIX "
-"extended regular expression surrounded by slashes)."
+"The <literal>Package</literal> field specifies the package that a pinning "
+"priority is applied to. The field can either contain a binary package name, "
+"a source package name (prefixed with \"src:\"), a &glob; expression or a "
+"regular expression (surrounded by slashes). Multiple package names, &glob; "
+"expressions and regular expressions can be listed separated by whitespace in "
+"which case the record will match any of the matched packages."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"By default, only packages of the native architecture are matched. To match "
+"binary packages of any architecture, add the <literal>:any</literal> suffix "
+"to the package name. You can also limit matching to a specific architecture "
+"by appending the architecture name to the package name, separated by a colon "
+"character."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"For example, the following example uses a glob expression and a regular "
+"expression to assign the priority 500 to all packages from experimental "
+"where the name starts with gnome (as a &glob;-like expression) or contains "
+"the word kde (as a POSIX extended regular expression surrounded by slashes)."
 msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><programlisting>
@@ -4894,23 +4914,11 @@ msgid ""
 "Package field is not considered a &glob; expression in itself."
 msgstr ""
 
-#. type: Content of: <refentry><refsect1><refsect2><title>
-#: apt_preferences.5.xml
-msgid "Pinning by source package"
-msgstr ""
-
 #. type: Content of: <refentry><refsect1><refsect2><para>
 #: apt_preferences.5.xml
 msgid ""
-"APT supports pinning by source packages. To pin by a source package, prepend "
-"\"src:\" to the package name."
-msgstr ""
-
-#. type: Content of: <refentry><refsect1><refsect2><para>
-#: apt_preferences.5.xml
-msgid ""
-"For example, to pin all binaries produced by the apt source package of this "
-"APT's version to 990, you can do:"
+"To pin all binaries produced by the apt source package of this APT's version "
+"to 990, you can do:"
 msgstr ""
 
 #. type: Content of: <refentry><refsect1><refsect2><programlisting>
@@ -4959,6 +4967,15 @@ msgstr ""
 "Pin: origin \"\"\n"
 "Pin-Priority: 999\n"
 
+#. type: Content of: <refentry><refsect1><refsect2><para>
+#: apt_preferences.5.xml
+msgid ""
+"The <literal>:any</literal> suffix makes sure to select binary packages from "
+"any architecture. Without that suffix, apt implicitly assumes the <literal>:"
+"native</literal> suffix which would only select packages from the native "
+"architecture."
+msgstr ""
+
 #. type: Content of: <refentry><refsect1><refsect2><title>
 #: apt_preferences.5.xml
 #, fuzzy
@@ -8617,6 +8634,19 @@ msgstr ""
 
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
 #: apt-patterns.7.xml
+msgid "<code>?codename(REGEX)</code>"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: apt-patterns.7.xml
+msgid ""
+"Selects versions that come from the codename that matches the specified "
+"regular expression. Codename, here, means the values after <code>n=</code> "
+"in <command>apt-cache policy</command>."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
+#: apt-patterns.7.xml
 msgid "<code>?origin(REGEX)</code>"
 msgstr ""
 
diff --git a/po/apt-all.pot b/po/apt-all.pot
index cad6773e3..138b63303 100644
--- a/po/apt-all.pot
+++ b/po/apt-all.pot
@@ -5,9 +5,9 @@
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: apt 2.3.13\n"
+"Project-Id-Version: apt 2.3.14\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2021-11-24 16:24+0100\n"
+"POT-Creation-Date: 2022-01-06 20:58+0100\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"