Bug#908767: apt: contradictory information about apt-get upgrade in manpage
Package: apt
Version: 0.9.12
Quoting apt-get's manpage:
,----
| upgrade
| upgrade is used to install the newest versions of all packages
| currently installed on the system from the sources enumerated
| in /etc/apt/sources.list. Packages currently installed with
| new versions available are retrieved and upgraded; under no
| circumstances are currently installed packages removed, or
| packages not already installed retrieved and installed.
`----
This paragraph has been unchanged for the last 14 years, but the last
half-sentence is no longer correct. In apt 0.9.12 apt-get learned an
option which does allow installing new packages, as mentioned further
down in the manpage.
,----
| --with-new-pkgs
| Allow installing new packages when used in conjunction with
| upgrade. This is useful if the update of a installed package
| requires new dependencies to be installed. Instead of holding
| the package back upgrade will upgrade the package and install
| the new dependencies. Note that upgrade with this option will
| never remove packages, only allow adding new ones.
| Configuration Item: APT::Get::Upgrade-Allow-New.
`----
Reply to: