From 81d183681aea972fddd453d62109f8ccda3f447a Mon Sep 17 00:00:00 2001 From: Michael Vogt Date: Mon, 25 Nov 2013 08:16:37 +0100 Subject: start adding apt.8.xml --- doc/apt.8.xml | 128 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 128 insertions(+) create mode 100644 doc/apt.8.xml (limited to 'doc/apt.8.xml') diff --git a/doc/apt.8.xml b/doc/apt.8.xml new file mode 100644 index 000000000..0340e043f --- /dev/null +++ b/doc/apt.8.xml @@ -0,0 +1,128 @@ + + +%aptent; + + +%aptverbatiment; + +]> + + + + + &apt-author.jgunthorpe; + &apt-author.team; + &apt-email; + &apt-product; + + 2013-11-25T00:00:00Z + + + + apt + 8 + APT + + + + + apt + APT package -- command-line interface + + + &synopsis-command-apt; + + Description + apt is the command-line tool for handling packages. It provides a commandline interface for the package management of the system. + + See also &apt-get; and &apt-cache; for more low-level command options. + + + + + update is used to + resynchronize the package index files from their sources. + + + + + 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. New package will be + installed, but existing package will never removed. + + + + + + install is followed by one or more + package names desired for installation or upgrading. + + + 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 + to select. This will cause that version to be located and selected for + install. Alternatively a specific distribution can be selected by + following the package name with a slash and the version of the + distribution or the Archive name (stable, testing, unstable). + + + + + remove is identical to install except that packages are + removed instead of installed. Note that removing a package leaves its + configuration files on the system. If a plus sign is appended to the package + name (with no intervening space), the identified package will be + installed instead of removed. + + + + + + options + &apt-cmdblurb; + + + + &apt-commonoptions; + + + + + Differences to &apt-get; + The apt command is meant to be pleasant for + end users and does not need to be backward compatilbe like + &apt-get;. Therefore some options are different: + + + The option DPkgPM::Progress-Fancy is enabled. + + The option APT::Color is enabled. + + A new list command is available + similar to dpkg --list. + + The option upgrade has + --with-new-pkgs enabled by default. + + + + + + + + See Also + &apt-get; &apt-cache;, &sources-list;, + &apt-conf;, &apt-config;, + The APT User's guide in &guidesdir;, &apt-preferences;, the APT Howto. + + + Diagnostics + apt returns zero on normal operation, decimal 100 on error. + + &manbugs; + -- cgit v1.2.3 From 132a7f8811f4558a7cbab620b0de4401f5d27d66 Mon Sep 17 00:00:00 2001 From: Michael Vogt Date: Mon, 6 Jan 2014 07:49:01 +0100 Subject: document list/search --- doc/apt.8.xml | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) (limited to 'doc/apt.8.xml') diff --git a/doc/apt.8.xml b/doc/apt.8.xml index 0340e043f..a0ae9086d 100644 --- a/doc/apt.8.xml +++ b/doc/apt.8.xml @@ -13,7 +13,6 @@ - &apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; @@ -42,11 +41,28 @@ + + list is used to + display a list of packages. It supports shell pattern for matching + package names and the following options: + + + + are supported. + + + + + search searches for the given + term(s) and display matching packages. + + + update is used to resynchronize the package index files from their sources. - + upgrade is used to install the -- cgit v1.2.3 From 54864645c108130633037590321a5ec8d3e29f2a Mon Sep 17 00:00:00 2001 From: Michael Vogt Date: Wed, 22 Jan 2014 08:14:18 +0100 Subject: add "Script usage" section and bugfixes --- doc/apt.8.xml | 30 +++++++++++++++++++++--------- 1 file changed, 21 insertions(+), 9 deletions(-) (limited to 'doc/apt.8.xml') diff --git a/doc/apt.8.xml b/doc/apt.8.xml index bb1f6bb91..91e22b1ef 100644 --- a/doc/apt.8.xml +++ b/doc/apt.8.xml @@ -29,13 +29,15 @@ apt - APT package -- command-line interface + command-line interface &synopsis-command-apt; Description - apt is the command-line tool for handling packages. It provides a commandline interface for the package management of the system. + apt (Advanced Package Tool) is the + command-line tool for handling packages. It provides a commandline + interface for the package management of the system. See also &apt-get; and &apt-cache; for more low-level command options. @@ -122,26 +124,36 @@ + + Differences to &apt-get; The apt command is meant to be pleasant for end users and does not need to be backward compatilbe like &apt-get;. Therefore some options are different: - The option DPkgPM::Progress-Fancy is enabled. + + The option DPkgPM::Progress-Fancy is enabled. + - The option APT::Color is enabled. + + The option APT::Color is enabled. + - A new list command is available - similar to dpkg --list. + + A new list command is available + similar to dpkg --list. + - The option upgrade has - --with-new-pkgs enabled by default. + + The option upgrade has + --with-new-pkgs enabled by default. + - + See Also -- cgit v1.2.3 From a555cf8be53d8b5557f004ecbde8482a169b79f3 Mon Sep 17 00:00:00 2001 From: Michael Vogt Date: Fri, 24 Jan 2014 20:04:26 +0100 Subject: describe script usage in the manpage --- doc/apt.8.xml | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) (limited to 'doc/apt.8.xml') diff --git a/doc/apt.8.xml b/doc/apt.8.xml index 91e22b1ef..3ac54fb0b 100644 --- a/doc/apt.8.xml +++ b/doc/apt.8.xml @@ -124,7 +124,15 @@ - + Script usage + + The &apt; commandline is designed as a end-user tool and it may + change the output between versions. While it tries to not break + backward compatibility there is no guarantee for it either. + All features of &apt; are available in &apt-cache; and &apt-get; + via APT options. Please prefer using these commands in your scripts. + + Differences to &apt-get; The apt command is meant to be pleasant for -- cgit v1.2.3 From c4383ac4a47d58347afa2a45bbf31d7bc2d18b89 Mon Sep 17 00:00:00 2001 From: Michael Vogt Date: Tue, 1 Apr 2014 12:33:00 +0200 Subject: add "full-upgrade" to the apt.5.xml documentation --- doc/apt.8.xml | 7 +++++++ 1 file changed, 7 insertions(+) (limited to 'doc/apt.8.xml') diff --git a/doc/apt.8.xml b/doc/apt.8.xml index 3ac54fb0b..716b685f6 100644 --- a/doc/apt.8.xml +++ b/doc/apt.8.xml @@ -110,6 +110,13 @@ + + full-upgrade performs the + function of upgrade but may also remove installed packages + if that is required in order to resolve a package conflict. + + + -- cgit v1.2.3