From e5a15f0d330ecd6b0d26233b64183e93ca4a57bb Mon Sep 17 00:00:00 2001
From: Wesley Schwengle <wesleys@opperschaap.net>
Date: Tue, 12 Mar 2024 12:21:28 -0400
Subject: Update documentation for apt-get upgrade with pkg arg

Closes: #1065831

Signed-off-by: Wesley Schwengle <wesleys@opperschaap.net>
---
 doc/apt-get.8.xml | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml
index 8d6bd8ede..cab6120f9 100644
--- a/doc/apt-get.8.xml
+++ b/doc/apt-get.8.xml
@@ -62,8 +62,10 @@
      retrieved and installed. New versions of currently installed packages that 
      cannot be upgraded without changing the install status of another package 
      will be left at their current version. An <literal>update</literal> must be 
-     performed first so that <command>apt-get</command> knows that new versions of packages are 
-     available.</para></listitem>
+     performed first so that <command>apt-get</command> knows that new versions
+     of packages are available.</para><para>When a package is supplied as an
+     argument, the package will be installed prior to the upgrade
+     action.</para></listitem>
      </varlistentry>
 
      <varlistentry><term><option>dist-upgrade</option></term>
@@ -76,7 +78,9 @@
      The <filename>/etc/apt/sources.list</filename> file contains a list of locations 
      from which to retrieve desired package files.
      See also &apt-preferences; for a mechanism for
-     overriding the general settings for individual packages.</para></listitem>
+     overriding the general settings for individual packages.</para><para>When
+     a package is supplied as an argument, the package will be installed prior
+     to the upgrade action.</para></listitem>
      </varlistentry>
 
      <varlistentry><term><option>dselect-upgrade</option></term>
-- 
cgit v1.2.3-70-g09d2


From 13e5e601d9a3f7d13e058bb5c52d72840b96e286 Mon Sep 17 00:00:00 2001
From: Wesley Schwengle <wesleys@opperschaap.net>
Date: Tue, 12 Mar 2024 12:26:20 -0400
Subject: Update documentation for apt upgrade with pkg arg

Closes: #1065831

Signed-off-by: Wesley Schwengle <wesleys@opperschaap.net>
---
 doc/apt.8.xml | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/doc/apt.8.xml b/doc/apt.8.xml
index b897369b2..51ed820dc 100644
--- a/doc/apt.8.xml
+++ b/doc/apt.8.xml
@@ -59,14 +59,18 @@
 	   packages will never be removed. If an upgrade for a package requires
 	   the removal of an installed package the upgrade for this package
 	   isn't performed.
-     </para></listitem>
+     </para>
+     <para>When a package is supplied as an argument, the package will be
+     installed prior to the upgrade action.</para>
+     </listitem>
      </varlistentry>
 
      <varlistentry><term><option>full-upgrade</option> (&apt-get;)</term>
      <listitem><para><literal>full-upgrade</literal> performs the function of
 	   upgrade but will remove currently installed packages if this is
 	   needed to upgrade the system as a whole.
-     </para></listitem>
+     </para><para>When a package is supplied as an argument, the package will
+     be installed prior to the upgrade action.</para></listitem>
      </varlistentry>
 
      <varlistentry><term><option>install</option>, <option>reinstall</option>, <option>remove</option>, <option>purge</option> (&apt-get;)</term>
-- 
cgit v1.2.3-70-g09d2


From 16a8cbb11305adff4fff0f30270feb3faf5a59ce Mon Sep 17 00:00:00 2001
From: Wesley Schwengle <wesleys@opperschaap.net>
Date: Tue, 12 Mar 2024 12:42:45 -0400
Subject: Include Dutch translation for apt/apt-get upgrade documenation update

Signed-off-by: Wesley Schwengle <wesleys@opperschaap.net>
---
 doc/po/nl.po | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/po/nl.po b/doc/po/nl.po
index a9a0f6b58..a1d2241b2 100644
--- a/doc/po/nl.po
+++ b/doc/po/nl.po
@@ -770,6 +770,13 @@ msgstr ""
 "opwaardering van een pakket vereist dat een geïnstalleerd pakket verwijderd "
 "wordt, zal de opwaardering voor dat pakket niet uitgevoerd worden."
 
+msgid ""
+"When a package is supplied as an argument, the package will be installed "
+"prior to the upgrade action."
+msgstr ""
+"Wanneer een pakket wordt opgegeven als argument, zal het pakket geïnstalleerd "
+"worden voordat de opwaardering plaats vindt."
+
 #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
 #: apt.8.xml
 msgid ""
-- 
cgit v1.2.3-70-g09d2