Release 3.1.103.1.10

11 files changed, 363 insertions, 12 deletions

diff --git a/doc/apt-verbatim.ent b/doc/apt-verbatim.ent
index 3fea1088c..f603d1a25 100644
--- a/doc/apt-verbatim.ent
+++ b/doc/apt-verbatim.ent
@@ -268,7 +268,7 @@
 ">
 
 <!-- this will be updated by 'prepare-release' -->
-<!ENTITY apt-product-version "3.1.9">
+<!ENTITY apt-product-version "3.1.10">
 
 <!-- (Code)names for various things used all over the place -->
 <!ENTITY debian-oldstable-codename "bookworm">
diff --git a/doc/po/apt-doc.pot b/doc/po/apt-doc.pot
index d42abd4da..8286e367c 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 3.1.9\n"
+"Project-Id-Version: apt-doc 3.1.10\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2025-10-21 19:28+0200\n"
+"POT-Creation-Date: 2025-10-25 20:53+0000\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"
@@ -155,6 +155,51 @@ msgstr ""
 #, no-wrap
 msgid ""
 "     <varlistentry>\n"
+"      <term><option>--cli-version</option></term>\n"
+"     <listitem><para>Requests a specific CLI version. This is a pattern that "
+"takes\n"
+"    a MAJOR.MINOR version. You may omit the MINOR version, in which case the "
+"latest\n"
+"    supported minor level will be used.\n"
+"     </para>\n"
+"     <para>\n"
+"     Version tracks are presented as follows: The version 3.2 has equivalent "
+"versions\n"
+"     0.32, 1.22, and 2.12, implementing new features for their specified "
+"major versions.\n"
+"     </para>\n"
+"     <para>\n"
+"     A special case is the X.9 version pattern: A version like 2.9 is "
+"followed by 3.0,\n"
+"     but 2.10 follows directly on 2.8; given that we use odd version numbers "
+"as development\n"
+"     series (2.9 is the 3.0 development series).\n"
+"     </para>\n"
+"     <para>\n"
+"     This feature has been introduced in APT 3.1.10, and replaces the "
+"binary-specific\n"
+"configuration. You may use the <option>APT::Version</option> to similar "
+"effect on older\n"
+"binaries, for example, use <option>-o APT::Version=2</option> to make &apt; "
+"behave like\n"
+"the 2.x series.\n"
+"     </para>\n"
+"     <para>\n"
+"     The default value is the current APT version for &apt; and "
+"<literal>0.(10 * major + minor)</literal>\n"
+"     for the classic commands. The 0.X series is soft-deprecated and the "
+"other commands will\n"
+"     roll over to the 2.x series in the future.\n"
+"     </para>\n"
+"     </listitem>\n"
+"     </varlistentry>\n"
+msgstr ""
+
+#. type: Plain text
+#: apt.ent
+#, no-wrap
+msgid ""
+"     <varlistentry>\n"
 "      <term><option>--no-color</option></term>\n"
 "      <term><option>--color</option></term>\n"
 "<listitem><para>Turn colors on or off. Colors are on by default on supported "
diff --git a/doc/po/de.po b/doc/po/de.po
index 3e6c0ae29..ccb54de5e 100644
--- a/doc/po/de.po
+++ b/doc/po/de.po
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: apt 2.9.27\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2025-05-19 18:28+0200\n"
+"POT-Creation-Date: 2025-10-25 20:53+0000\n"
 "PO-Revision-Date: 2025-02-28 15:48+0100\n"
 "Last-Translator: Chris Leick <c.leick@vollbio.de>\n"
 "Language-Team: German <debian-l10n-german@lists.debian.org>\n"
@@ -220,6 +220,40 @@ msgstr ""
 #, no-wrap
 msgid ""
 "     <varlistentry>\n"
+"      <term><option>--cli-version</option></term>\n"
+"     <listitem><para>Requests a specific CLI version. This is a pattern that takes\n"
+"    a MAJOR.MINOR version. You may omit the MINOR version, in which case the latest\n"
+"    supported minor level will be used.\n"
+"     </para>\n"
+"     <para>\n"
+"     Version tracks are presented as follows: The version 3.2 has equivalent versions\n"
+"     0.32, 1.22, and 2.12, implementing new features for their specified major versions.\n"
+"     </para>\n"
+"     <para>\n"
+"     A special case is the X.9 version pattern: A version like 2.9 is followed by 3.0,\n"
+"     but 2.10 follows directly on 2.8; given that we use odd version numbers as development\n"
+"     series (2.9 is the 3.0 development series).\n"
+"     </para>\n"
+"     <para>\n"
+"     This feature has been introduced in APT 3.1.10, and replaces the binary-specific\n"
+"configuration. You may use the <option>APT::Version</option> to similar effect on older\n"
+"binaries, for example, use <option>-o APT::Version=2</option> to make &apt; behave like\n"
+"the 2.x series.\n"
+"     </para>\n"
+"     <para>\n"
+"     The default value is the current APT version for &apt; and <literal>0.(10 * major + minor)</literal>\n"
+"     for the classic commands. The 0.X series is soft-deprecated and the other commands will\n"
+"     roll over to the 2.x series in the future.\n"
+"     </para>\n"
+"     </listitem>\n"
+"     </varlistentry>\n"
+msgstr ""
+
+#. type: Plain text
+#: apt.ent
+#, no-wrap
+msgid ""
+"     <varlistentry>\n"
 "      <term><option>--no-color</option></term>\n"
 "      <term><option>--color</option></term>\n"
 "<listitem><para>Turn colors on or off. Colors are on by default on supported terminals for &apt; and\n"
diff --git a/doc/po/es.po b/doc/po/es.po
index 7ab874119..7d4b8a3b6 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: 2025-05-19 18:28+0200\n"
+"POT-Creation-Date: 2025-10-25 20:53+0000\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"
@@ -272,6 +272,40 @@ msgstr ""
 
 #. type: Plain text
 #: apt.ent
+#, no-wrap
+msgid ""
+"     <varlistentry>\n"
+"      <term><option>--cli-version</option></term>\n"
+"     <listitem><para>Requests a specific CLI version. This is a pattern that takes\n"
+"    a MAJOR.MINOR version. You may omit the MINOR version, in which case the latest\n"
+"    supported minor level will be used.\n"
+"     </para>\n"
+"     <para>\n"
+"     Version tracks are presented as follows: The version 3.2 has equivalent versions\n"
+"     0.32, 1.22, and 2.12, implementing new features for their specified major versions.\n"
+"     </para>\n"
+"     <para>\n"
+"     A special case is the X.9 version pattern: A version like 2.9 is followed by 3.0,\n"
+"     but 2.10 follows directly on 2.8; given that we use odd version numbers as development\n"
+"     series (2.9 is the 3.0 development series).\n"
+"     </para>\n"
+"     <para>\n"
+"     This feature has been introduced in APT 3.1.10, and replaces the binary-specific\n"
+"configuration. You may use the <option>APT::Version</option> to similar effect on older\n"
+"binaries, for example, use <option>-o APT::Version=2</option> to make &apt; behave like\n"
+"the 2.x series.\n"
+"     </para>\n"
+"     <para>\n"
+"     The default value is the current APT version for &apt; and <literal>0.(10 * major + minor)</literal>\n"
+"     for the classic commands. The 0.X series is soft-deprecated and the other commands will\n"
+"     roll over to the 2.x series in the future.\n"
+"     </para>\n"
+"     </listitem>\n"
+"     </varlistentry>\n"
+msgstr ""
+
+#. type: Plain text
+#: apt.ent
 #, fuzzy, no-wrap
 #| msgid ""
 #| "     <varlistentry>\n"
diff --git a/doc/po/fr.po b/doc/po/fr.po
index b63bef4c2..5559af243 100644
--- a/doc/po/fr.po
+++ b/doc/po/fr.po
@@ -13,7 +13,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: apt-doc 2.9.14\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2025-06-13 12:41+0200\n"
+"POT-Creation-Date: 2025-10-25 20:53+0000\n"
 "PO-Revision-Date: 2025-04-15 13:14+0200\n"
 "Last-Translator: bubu <bubub@no-log.org>\n"
 "Language-Team: French <debian-l10n-french@lists.debian.org>\n"
@@ -228,6 +228,40 @@ msgstr ""
 #, no-wrap
 msgid ""
 "     <varlistentry>\n"
+"      <term><option>--cli-version</option></term>\n"
+"     <listitem><para>Requests a specific CLI version. This is a pattern that takes\n"
+"    a MAJOR.MINOR version. You may omit the MINOR version, in which case the latest\n"
+"    supported minor level will be used.\n"
+"     </para>\n"
+"     <para>\n"
+"     Version tracks are presented as follows: The version 3.2 has equivalent versions\n"
+"     0.32, 1.22, and 2.12, implementing new features for their specified major versions.\n"
+"     </para>\n"
+"     <para>\n"
+"     A special case is the X.9 version pattern: A version like 2.9 is followed by 3.0,\n"
+"     but 2.10 follows directly on 2.8; given that we use odd version numbers as development\n"
+"     series (2.9 is the 3.0 development series).\n"
+"     </para>\n"
+"     <para>\n"
+"     This feature has been introduced in APT 3.1.10, and replaces the binary-specific\n"
+"configuration. You may use the <option>APT::Version</option> to similar effect on older\n"
+"binaries, for example, use <option>-o APT::Version=2</option> to make &apt; behave like\n"
+"the 2.x series.\n"
+"     </para>\n"
+"     <para>\n"
+"     The default value is the current APT version for &apt; and <literal>0.(10 * major + minor)</literal>\n"
+"     for the classic commands. The 0.X series is soft-deprecated and the other commands will\n"
+"     roll over to the 2.x series in the future.\n"
+"     </para>\n"
+"     </listitem>\n"
+"     </varlistentry>\n"
+msgstr ""
+
+#. type: Plain text
+#: apt.ent
+#, no-wrap
+msgid ""
+"     <varlistentry>\n"
 "      <term><option>--no-color</option></term>\n"
 "      <term><option>--color</option></term>\n"
 "<listitem><para>Turn colors on or off. Colors are on by default on supported terminals for &apt; and\n"
diff --git a/doc/po/it.po b/doc/po/it.po
index 9d468067a..14954df43 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: 2025-05-19 18:28+0200\n"
+"POT-Creation-Date: 2025-10-25 20:53+0000\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"
@@ -242,6 +242,40 @@ msgstr ""
 
 #. type: Plain text
 #: apt.ent
+#, no-wrap
+msgid ""
+"     <varlistentry>\n"
+"      <term><option>--cli-version</option></term>\n"
+"     <listitem><para>Requests a specific CLI version. This is a pattern that takes\n"
+"    a MAJOR.MINOR version. You may omit the MINOR version, in which case the latest\n"
+"    supported minor level will be used.\n"
+"     </para>\n"
+"     <para>\n"
+"     Version tracks are presented as follows: The version 3.2 has equivalent versions\n"
+"     0.32, 1.22, and 2.12, implementing new features for their specified major versions.\n"
+"     </para>\n"
+"     <para>\n"
+"     A special case is the X.9 version pattern: A version like 2.9 is followed by 3.0,\n"
+"     but 2.10 follows directly on 2.8; given that we use odd version numbers as development\n"
+"     series (2.9 is the 3.0 development series).\n"
+"     </para>\n"
+"     <para>\n"
+"     This feature has been introduced in APT 3.1.10, and replaces the binary-specific\n"
+"configuration. You may use the <option>APT::Version</option> to similar effect on older\n"
+"binaries, for example, use <option>-o APT::Version=2</option> to make &apt; behave like\n"
+"the 2.x series.\n"
+"     </para>\n"
+"     <para>\n"
+"     The default value is the current APT version for &apt; and <literal>0.(10 * major + minor)</literal>\n"
+"     for the classic commands. The 0.X series is soft-deprecated and the other commands will\n"
+"     roll over to the 2.x series in the future.\n"
+"     </para>\n"
+"     </listitem>\n"
+"     </varlistentry>\n"
+msgstr ""
+
+#. type: Plain text
+#: apt.ent
 #, fuzzy, no-wrap
 #| msgid ""
 #| "     <varlistentry>\n"
diff --git a/doc/po/ja.po b/doc/po/ja.po
index b2690da24..4860993bf 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: 2025-05-19 18:28+0200\n"
+"POT-Creation-Date: 2025-10-25 20:53+0000\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"
@@ -239,6 +239,40 @@ msgstr ""
 
 #. type: Plain text
 #: apt.ent
+#, no-wrap
+msgid ""
+"     <varlistentry>\n"
+"      <term><option>--cli-version</option></term>\n"
+"     <listitem><para>Requests a specific CLI version. This is a pattern that takes\n"
+"    a MAJOR.MINOR version. You may omit the MINOR version, in which case the latest\n"
+"    supported minor level will be used.\n"
+"     </para>\n"
+"     <para>\n"
+"     Version tracks are presented as follows: The version 3.2 has equivalent versions\n"
+"     0.32, 1.22, and 2.12, implementing new features for their specified major versions.\n"
+"     </para>\n"
+"     <para>\n"
+"     A special case is the X.9 version pattern: A version like 2.9 is followed by 3.0,\n"
+"     but 2.10 follows directly on 2.8; given that we use odd version numbers as development\n"
+"     series (2.9 is the 3.0 development series).\n"
+"     </para>\n"
+"     <para>\n"
+"     This feature has been introduced in APT 3.1.10, and replaces the binary-specific\n"
+"configuration. You may use the <option>APT::Version</option> to similar effect on older\n"
+"binaries, for example, use <option>-o APT::Version=2</option> to make &apt; behave like\n"
+"the 2.x series.\n"
+"     </para>\n"
+"     <para>\n"
+"     The default value is the current APT version for &apt; and <literal>0.(10 * major + minor)</literal>\n"
+"     for the classic commands. The 0.X series is soft-deprecated and the other commands will\n"
+"     roll over to the 2.x series in the future.\n"
+"     </para>\n"
+"     </listitem>\n"
+"     </varlistentry>\n"
+msgstr ""
+
+#. type: Plain text
+#: apt.ent
 #, fuzzy, no-wrap
 #| msgid ""
 #| "     <varlistentry>\n"
diff --git a/doc/po/nl.po b/doc/po/nl.po
index adea1aa19..421a6bc56 100644
--- a/doc/po/nl.po
+++ b/doc/po/nl.po
@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: apt-doc 3.1.5\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2025-10-21 19:19+0200\n"
+"POT-Creation-Date: 2025-10-25 20:53+0000\n"
 "PO-Revision-Date: 2025-08-28 22:52+0200\n"
 "Last-Translator: Frans Spiesschaert <Frans.Spiesschaert@yucom.be>\n"
 "Language-Team: Debian Dutch l10n Team <debian-l10n-dutch@lists.debian.org>\n"
@@ -219,6 +219,40 @@ msgstr ""
 #, no-wrap
 msgid ""
 "     <varlistentry>\n"
+"      <term><option>--cli-version</option></term>\n"
+"     <listitem><para>Requests a specific CLI version. This is a pattern that takes\n"
+"    a MAJOR.MINOR version. You may omit the MINOR version, in which case the latest\n"
+"    supported minor level will be used.\n"
+"     </para>\n"
+"     <para>\n"
+"     Version tracks are presented as follows: The version 3.2 has equivalent versions\n"
+"     0.32, 1.22, and 2.12, implementing new features for their specified major versions.\n"
+"     </para>\n"
+"     <para>\n"
+"     A special case is the X.9 version pattern: A version like 2.9 is followed by 3.0,\n"
+"     but 2.10 follows directly on 2.8; given that we use odd version numbers as development\n"
+"     series (2.9 is the 3.0 development series).\n"
+"     </para>\n"
+"     <para>\n"
+"     This feature has been introduced in APT 3.1.10, and replaces the binary-specific\n"
+"configuration. You may use the <option>APT::Version</option> to similar effect on older\n"
+"binaries, for example, use <option>-o APT::Version=2</option> to make &apt; behave like\n"
+"the 2.x series.\n"
+"     </para>\n"
+"     <para>\n"
+"     The default value is the current APT version for &apt; and <literal>0.(10 * major + minor)</literal>\n"
+"     for the classic commands. The 0.X series is soft-deprecated and the other commands will\n"
+"     roll over to the 2.x series in the future.\n"
+"     </para>\n"
+"     </listitem>\n"
+"     </varlistentry>\n"
+msgstr ""
+
+#. type: Plain text
+#: apt.ent
+#, no-wrap
+msgid ""
+"     <varlistentry>\n"
 "      <term><option>--no-color</option></term>\n"
 "      <term><option>--color</option></term>\n"
 "<listitem><para>Turn colors on or off. Colors are on by default on supported terminals for &apt; and\n"
diff --git a/doc/po/pl.po b/doc/po/pl.po
index 9925edf20..a02d07355 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: 2025-05-19 18:28+0200\n"
+"POT-Creation-Date: 2025-10-25 20:53+0000\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"
@@ -242,6 +242,40 @@ msgstr ""
 
 #. type: Plain text
 #: apt.ent
+#, no-wrap
+msgid ""
+"     <varlistentry>\n"
+"      <term><option>--cli-version</option></term>\n"
+"     <listitem><para>Requests a specific CLI version. This is a pattern that takes\n"
+"    a MAJOR.MINOR version. You may omit the MINOR version, in which case the latest\n"
+"    supported minor level will be used.\n"
+"     </para>\n"
+"     <para>\n"
+"     Version tracks are presented as follows: The version 3.2 has equivalent versions\n"
+"     0.32, 1.22, and 2.12, implementing new features for their specified major versions.\n"
+"     </para>\n"
+"     <para>\n"
+"     A special case is the X.9 version pattern: A version like 2.9 is followed by 3.0,\n"
+"     but 2.10 follows directly on 2.8; given that we use odd version numbers as development\n"
+"     series (2.9 is the 3.0 development series).\n"
+"     </para>\n"
+"     <para>\n"
+"     This feature has been introduced in APT 3.1.10, and replaces the binary-specific\n"
+"configuration. You may use the <option>APT::Version</option> to similar effect on older\n"
+"binaries, for example, use <option>-o APT::Version=2</option> to make &apt; behave like\n"
+"the 2.x series.\n"
+"     </para>\n"
+"     <para>\n"
+"     The default value is the current APT version for &apt; and <literal>0.(10 * major + minor)</literal>\n"
+"     for the classic commands. The 0.X series is soft-deprecated and the other commands will\n"
+"     roll over to the 2.x series in the future.\n"
+"     </para>\n"
+"     </listitem>\n"
+"     </varlistentry>\n"
+msgstr ""
+
+#. type: Plain text
+#: apt.ent
 #, fuzzy, no-wrap
 #| msgid ""
 #| "     <varlistentry>\n"
diff --git a/doc/po/pt.po b/doc/po/pt.po
index 6199f62fb..954c31ea8 100644
--- a/doc/po/pt.po
+++ b/doc/po/pt.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: apt 3.1.4\n"
 "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
-"POT-Creation-Date: 2025-08-26 13:40+0200\n"
+"POT-Creation-Date: 2025-10-25 20:53+0000\n"
 "PO-Revision-Date: 2025-08-14 23:16+0100\n"
 "Last-Translator: Américo Monteiro <a_monteiro@gmx.com>\n"
 "Language-Team: Portuguese <>\n"
@@ -221,6 +221,40 @@ msgstr ""
 #, no-wrap
 msgid ""
 "     <varlistentry>\n"
+"      <term><option>--cli-version</option></term>\n"
+"     <listitem><para>Requests a specific CLI version. This is a pattern that takes\n"
+"    a MAJOR.MINOR version. You may omit the MINOR version, in which case the latest\n"
+"    supported minor level will be used.\n"
+"     </para>\n"
+"     <para>\n"
+"     Version tracks are presented as follows: The version 3.2 has equivalent versions\n"
+"     0.32, 1.22, and 2.12, implementing new features for their specified major versions.\n"
+"     </para>\n"
+"     <para>\n"
+"     A special case is the X.9 version pattern: A version like 2.9 is followed by 3.0,\n"
+"     but 2.10 follows directly on 2.8; given that we use odd version numbers as development\n"
+"     series (2.9 is the 3.0 development series).\n"
+"     </para>\n"
+"     <para>\n"
+"     This feature has been introduced in APT 3.1.10, and replaces the binary-specific\n"
+"configuration. You may use the <option>APT::Version</option> to similar effect on older\n"
+"binaries, for example, use <option>-o APT::Version=2</option> to make &apt; behave like\n"
+"the 2.x series.\n"
+"     </para>\n"
+"     <para>\n"
+"     The default value is the current APT version for &apt; and <literal>0.(10 * major + minor)</literal>\n"
+"     for the classic commands. The 0.X series is soft-deprecated and the other commands will\n"
+"     roll over to the 2.x series in the future.\n"
+"     </para>\n"
+"     </listitem>\n"
+"     </varlistentry>\n"
+msgstr ""
+
+#. type: Plain text
+#: apt.ent
+#, no-wrap
+msgid ""
+"     <varlistentry>\n"
 "      <term><option>--no-color</option></term>\n"
 "      <term><option>--color</option></term>\n"
 "<listitem><para>Turn colors on or off. Colors are on by default on supported terminals for &apt; and\n"
diff --git a/doc/po/pt_BR.po b/doc/po/pt_BR.po
index 951683055..42ee2c3b0 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: 2025-05-19 18:28+0200\n"
+"POT-Creation-Date: 2025-10-25 20:53+0000\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"
@@ -159,6 +159,40 @@ msgstr ""
 #, no-wrap
 msgid ""
 "     <varlistentry>\n"
+"      <term><option>--cli-version</option></term>\n"
+"     <listitem><para>Requests a specific CLI version. This is a pattern that takes\n"
+"    a MAJOR.MINOR version. You may omit the MINOR version, in which case the latest\n"
+"    supported minor level will be used.\n"
+"     </para>\n"
+"     <para>\n"
+"     Version tracks are presented as follows: The version 3.2 has equivalent versions\n"
+"     0.32, 1.22, and 2.12, implementing new features for their specified major versions.\n"
+"     </para>\n"
+"     <para>\n"
+"     A special case is the X.9 version pattern: A version like 2.9 is followed by 3.0,\n"
+"     but 2.10 follows directly on 2.8; given that we use odd version numbers as development\n"
+"     series (2.9 is the 3.0 development series).\n"
+"     </para>\n"
+"     <para>\n"
+"     This feature has been introduced in APT 3.1.10, and replaces the binary-specific\n"
+"configuration. You may use the <option>APT::Version</option> to similar effect on older\n"
+"binaries, for example, use <option>-o APT::Version=2</option> to make &apt; behave like\n"
+"the 2.x series.\n"
+"     </para>\n"
+"     <para>\n"
+"     The default value is the current APT version for &apt; and <literal>0.(10 * major + minor)</literal>\n"
+"     for the classic commands. The 0.X series is soft-deprecated and the other commands will\n"
+"     roll over to the 2.x series in the future.\n"
+"     </para>\n"
+"     </listitem>\n"
+"     </varlistentry>\n"
+msgstr ""
+
+#. type: Plain text
+#: apt.ent
+#, no-wrap
+msgid ""
+"     <varlistentry>\n"
 "      <term><option>--no-color</option></term>\n"
 "      <term><option>--color</option></term>\n"
 "<listitem><para>Turn colors on or off. Colors are on by default on supported terminals for &apt; and\n"