From 77c9def7e8caf13bb1630bc4e3bdc4f2c1853dd4 Mon Sep 17 00:00:00 2001 From: "Eugene V. Lyubimkin" Date: Sat, 1 Nov 2008 13:19:15 +0200 Subject: Clearly documented '/' and '=' in apt-get.8. --- doc/apt-get.8.xml | 37 ++++++++++++++++++++++++++++++++----- 1 file changed, 32 insertions(+), 5 deletions(-) (limited to 'doc/apt-get.8.xml') diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index 2ea6ea1d4..7dc2fedb9 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -15,7 +15,7 @@ &apt-email; &apt-product; - 29 February 2004 + 28 October 2008 @@ -40,10 +40,30 @@ update upgrade dselect-upgrade - install pkg + install + pkg + + + =pkg_version_number + + + /target_release_name + + + + remove pkg purge pkg - source pkg + + source + pkg + + + =pkg_version_number + + + + build-dep pkg check clean @@ -495,7 +515,14 @@ Diagnostics apt-get returns zero on normal operation, decimal 100 on error. - + + ORIGINAL AUTHORS + &apt-author.jgunthorpe; + + + CURRENT AUTHORS + &apt-author.team; + &apt-qapage; + &manbugs; - -- cgit v1.2.3 From 7e4c7441e83fc2cf37436d0d22b9004392759ec0 Mon Sep 17 00:00:00 2001 From: "Eugene V. Lyubimkin" Date: Sat, 1 Nov 2008 13:42:09 +0200 Subject: Mentioned more short options in the apt-get's manpage. Documented 'xvcg' in the apt-get manpage. --- doc/apt-get.8.xml | 36 ++++++++++++++++++++++++++++++++---- 1 file changed, 32 insertions(+), 4 deletions(-) (limited to 'doc/apt-get.8.xml') diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index 7dc2fedb9..f0c740cd2 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -15,7 +15,7 @@ &apt-email; &apt-product; - 28 October 2008 + 30 October 2008 @@ -33,9 +33,37 @@ apt-get - - - + + + + + + + + + + + update upgrade -- cgit v1.2.3 From 2b0de496a89d9ba180853484fe55b0e437ab7059 Mon Sep 17 00:00:00 2001 From: "Eugene V. Lyubimkin" Date: Sat, 1 Nov 2008 13:53:30 +0200 Subject: Advanced documentation for 'apt-get install' command, mentioned upgrading possibility. --- doc/apt-get.8.xml | 41 ++++++++++++++++++++++++++++++----------- 1 file changed, 30 insertions(+), 11 deletions(-) (limited to 'doc/apt-get.8.xml') 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. -- cgit v1.2.3 From ef48e3ae39501a416274e55067412e5d6048fa43 Mon Sep 17 00:00:00 2001 From: "Eugene V. Lyubimkin" Date: Sat, 1 Nov 2008 14:35:17 +0200 Subject: Removed unneeded . --- doc/apt-get.8.xml | 39 +++++++++++++++++++-------------------- 1 file changed, 19 insertions(+), 20 deletions(-) (limited to 'doc/apt-get.8.xml') diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index fdf3e00ed..40027b9f0 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -69,29 +69,28 @@ upgrade dselect-upgrade install - pkg - - - =pkg_version_number - - - /target_release_name - - - - + pkg + + + =pkg_version_number + + + /target_release_name + + + + remove pkg purge pkg - source - pkg - - - =pkg_version_number - - - - + pkg + + + =pkg_version_number + + + + build-dep pkg check clean -- cgit v1.2.3 From 4a09fd30563425de225a33974e9522c8e8e09553 Mon Sep 17 00:00:00 2001 From: "Eugene V. Lyubimkin" Date: Sat, 1 Nov 2008 16:15:25 +0200 Subject: Fixed validation of apt-get.8.xml --- doc/apt-get.8.xml | 40 +++++++++++++++++----------------------- 1 file changed, 17 insertions(+), 23 deletions(-) (limited to 'doc/apt-get.8.xml') diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index 40027b9f0..817ebe1b0 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -36,14 +36,7 @@ @@ -52,16 +45,15 @@ - + + + + target_release_name + + + target_release_number_expression + + @@ -563,12 +555,14 @@ ORIGINAL AUTHORS - &apt-author.jgunthorpe; + &apt-author.jgunthorpe; - + CURRENT AUTHORS - &apt-author.team; - &apt-qapage; - + + &apt-author.team; + &apt-qapage; + + &manbugs; -- cgit v1.2.3 From 060d44030cddd071cf7cd6923645de4f2bffd454 Mon Sep 17 00:00:00 2001 From: "Eugene V. Lyubimkin" Date: Sat, 1 Nov 2008 16:41:24 +0200 Subject: Corrected synopsis part for 'apt-get' source. --- doc/apt-get.8.xml | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) (limited to 'doc/apt-get.8.xml') diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index 817ebe1b0..9e6c01de4 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -76,11 +76,9 @@ purge pkg source pkg - - - =pkg_version_number - - + + =pkg_version_number + build-dep pkg -- cgit v1.2.3 From 763f954953478df8afb78a19fa007e5d7f5c80c9 Mon Sep 17 00:00:00 2001 From: "Eugene V. Lyubimkin" Date: Sun, 2 Nov 2008 12:38:08 +0200 Subject: Typo fix. --- doc/apt-get.8.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'doc/apt-get.8.xml') diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index 9e6c01de4..73ad09c62 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -506,7 +506,7 @@ /etc/apt/apt.conf.d/ - APT configuration file fragments + APT configuration file fragments. Configuration Item: Dir::Etc::Parts. -- cgit v1.2.3 From d914c3b7f836ec6dc2e74e98720c4a16e6ea258e Mon Sep 17 00:00:00 2001 From: "Eugene V. Lyubimkin" Date: Sun, 2 Nov 2008 12:49:16 +0200 Subject: Documented '--no-install-recommends' in apt-get manpage. --- doc/apt-get.8.xml | 5 +++++ 1 file changed, 5 insertions(+) (limited to 'doc/apt-get.8.xml') diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index 73ad09c62..75fda1320 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -278,6 +278,11 @@ &apt-cmdblurb; + + Do not consider recommended packages as a dependency for installing. + Configuration Item: APT::Install-Recommends. + + Download only; package files are only retrieved, not unpacked or installed. Configuration Item: APT::Get::Download-Only. -- cgit v1.2.3 From 78482e30ed7d898a05023bf77beb3d46eb06d544 Mon Sep 17 00:00:00 2001 From: "Eugene V. Lyubimkin" Date: Sun, 2 Nov 2008 15:00:29 +0200 Subject: Another fix for synopsis of 'apt-get install'. --- doc/apt-get.8.xml | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) (limited to 'doc/apt-get.8.xml') diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index 75fda1320..797a6562e 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -62,14 +62,16 @@ dselect-upgrade install pkg - - - =pkg_version_number - - - /target_release_name - - + + + + =pkg_version_number + + + /target_release_name + + + remove pkg -- cgit v1.2.3 From fc91816f90f5229170f487b0ce3e300f133525e9 Mon Sep 17 00:00:00 2001 From: "Eugene V. Lyubimkin" Date: Sun, 2 Nov 2008 15:02:58 +0200 Subject: Another fix for 'apt-get <...> -t' synopsis. --- doc/apt-get.8.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'doc/apt-get.8.xml') diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index 797a6562e..a69fbcd48 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -48,10 +48,10 @@ - target_release_name + target_release_name - target_release_number_expression + target_release_number_expression -- cgit v1.2.3 From c74e6100c542c456340d241fd907d7f5fc10c98f Mon Sep 17 00:00:00 2001 From: "Eugene V. Lyubimkin" Date: Sun, 2 Nov 2008 15:10:21 +0200 Subject: Cleaned up unnecessary [<...>] from apt-get synopsis. Added '--help'. --- doc/apt-get.8.xml | 32 +++++++++++++++++++------------- 1 file changed, 19 insertions(+), 13 deletions(-) (limited to 'doc/apt-get.8.xml') diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index a69fbcd48..c63011b2a 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -33,7 +33,7 @@ apt-get - + - update - upgrade - dselect-upgrade - install + update + upgrade + dselect-upgrade + install pkg @@ -74,20 +74,26 @@ - remove pkg - purge pkg - source + remove pkg + purge pkg + source pkg =pkg_version_number - build-dep pkg - check - clean - autoclean - autoremove + build-dep pkg + check + clean + autoclean + autoremove + + + -h + --help + + -- cgit v1.2.3