Bug#931637: Slight inaccuracy in explanation of "apt upgrade"
merge Bug#931637 931559
thanks
Ben Harris wrote:
> In section 4.4.4, "Minimal system upgrade", the Release notes say that "apt
> upgrade" "has the effect of upgrading those packages which can be upgraded
> without requiring any other packages to be removed or installed".
>
> However, when I ran this command (and consistently with my past experience
> of "apt upgrade"), it didn't just upgrade packages, but also installed new
> ones. I think this is a change from "apt-get upgrade", which behaved as
> described here.
Yes, sorry, we'd just noticed this (bug #931559). Let's see if I can
work out how to do a merge.
> To correct this, I think the words "or installed" should be omitted from the
> end of the sentence.
That would accurately reflect the fact that the instructions given no
longer provide a minimal upgrade, but I would prefer to correct them
so that they do - this is all the result of a search-and-replace of
"apt-get" to "apt" where the two in fact behave slightly differently.
I attach a patch that does only that. It has also been suggested
that we could add a footnote suggesting that users might
alternatively use "apt upgrade" but that this also installs new
packages - what do you think?
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
diff --git a/en/upgrading.dbk b/en/upgrading.dbk
index 90e8b9c3..3b372999 100644
--- a/en/upgrading.dbk
+++ b/en/upgrading.dbk
@@ -930,7 +930,7 @@ E: You don't have enough free space in /var/cache/apt/archives/.
To do this, first run:
</para>
<screen>
-# apt upgrade
+# apt-get upgrade
</screen>
<para>
This has the effect of upgrading those packages which can be upgraded without
Reply to: