From 2b0de496a89d9ba180853484fe55b0e437ab7059 Mon Sep 17 00:00:00 2001 From: "Eugene V. Lyubimkin" Date: Sat, 1 Nov 2008 13:53:30 +0200 Subject: [PATCH] Advanced documentation for 'apt-get install' command, mentioned upgrading possibility. --- debian/changelog | 3 +++ doc/apt-get.8.xml | 41 ++++++++++++++++++++++++++++++----------- 2 files changed, 33 insertions(+), 11 deletions(-) diff --git a/debian/changelog b/debian/changelog index 69f1500fc..271f8a6f3 100644 --- a/debian/changelog +++ b/debian/changelog @@ -45,6 +45,9 @@ apt (0.7.17) unstable; urgency=low - Mentioned more short options in the apt-get manpage. Documented 'xvcg' option in the apt-cache manpage. The part of patch by Andre Felipe Machado. (Closes: #176106) + - Documented that 'apt-get install' command should be used for upgrading + some of installed packages. Based on patch by Nori Heikkinen and + Andre Felipe Machado. (Closes: #267087) -- Eugene V. Lyubimkin Fri, 24 Oct 2008 23:45:17 +0300 diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index f0c740cd2..fdf3e00ed 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -159,17 +159,25 @@ install - install is followed by one or more packages desired for - installation. Each package is a package name, not a fully qualified - filename (for instance, in a Debian GNU/Linux system, libc6 would be the - argument provided, not libc6_1.9.6-2.deb) All packages required - by the package(s) specified for installation will also be retrieved and - installed. The /etc/apt/sources.list file is used to locate - the desired packages. If a hyphen is appended to the package name (with - no intervening space), the identified package will be removed if it is - installed. Similarly a plus sign can be used to designate a package to - install. These latter features may be used to override decisions made by - apt-get's conflict resolution system. + + + install is followed by one or more + packages desired for installation or upgrading. + Each package is a package name, not a fully qualified + filename (for instance, in a Debian GNU/Linux system, + libc6 would be the argument provided, not + libc6_1.9.6-2.deb). All packages required + by the package(s) specified for installation will also + be retrieved and installed. + The /etc/apt/sources.list file is + used to locate the desired packages. If a hyphen is + appended to the package name (with no intervening space), + the identified package will be removed if it is installed. + Similarly a plus sign can be used to designate a + package to install. These latter features may be used + to override decisions made by apt-get's conflict + resolution system. + A specific version of a package can be selected for installation by following the package name with an equals and the version of the package @@ -181,6 +189,17 @@ Both of the version selection mechanisms can downgrade packages and must be used with care. + This is also the target to use if you want to upgrade one or + more already-installed packages without upgrading every package + you have on your system. Unlike the "upgrade" target, which + installs the newest version of all currently installed packages, + "install" will install the newest version of only the package(s) + specified. Simply provide the name of the package(s) you wish + to upgrade, and if a newer version is available, it (and its + dependencies, as described above) will be downloaded and + installed. + + Finally, the &apt-preferences; mechanism allows you to create an alternative installation policy for individual packages. -- 2.47.2