Bug#931637: Slight inaccuracy in explanation of "apt upgrade"

[Ben Harris]

Package: release-notes
Severity: minor

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.

To correct this, I think the words "or installed" should be omitted from
the end of the sentence.

[Justin B Rye]

merge Bug#931637 931559
thanks

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?