From 76e2632459410dec81337edb6a9fee33c9a660f3 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sat, 13 Apr 2024 11:59:37 +0200 Subject: Adding upstream version 2.7.12. Signed-off-by: Daniel Baumann --- doc/apt.8.xml | 187 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 187 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 0000000..b897369 --- /dev/null +++ b/doc/apt.8.xml @@ -0,0 +1,187 @@ + + %aptent; + %aptverbatiment; + %aptvendor; +]> + + + + + &apt-author.team; + &apt-email; + &apt-product; + + 2023-12-28T00:00:00Z + + + + apt + 8 + APT + + + + + apt + command-line interface + + + &synopsis-command-apt; + + Description + apt provides a high-level commandline interface for + the package management system. It is intended as an end user interface and + enables some options better suited for interactive usage by default + compared to more specialized APT tools like &apt-get; and &apt-cache;. + + Much like apt itself, its manpage is intended as an end + user interface and as such only mentions the most used commands and options + partly to not duplicate information in multiple places and partly to avoid + overwhelming readers with a cornucopia of options and details. + + + + (&apt-get;) + is used to download package + information from all configured sources. Other commands operate on + this data to e.g. perform package upgrades or search in and display + details about all packages available for installation. + + + + (&apt-get;) + is used to install available + upgrades of all packages currently installed on the system from the + sources configured via &sources-list;. New packages will be + installed if required to satisfy dependencies, but existing + packages will never be removed. If an upgrade for a package requires + the removal of an installed package the upgrade for this package + isn't performed. + + + + (&apt-get;) + full-upgrade performs the function of + upgrade but will remove currently installed packages if this is + needed to upgrade the system as a whole. + + + + , , , (&apt-get;) + Performs the requested action on one or more packages + specified via ®ex;, &glob; or exact match. The requested action + can be overridden for specific packages by appending a plus (+) to the + package name to install this package or a minus (-) to remove it. + + 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. Alternatively the version from a specific release can be + selected by following the package name with a forward slash (/) and + codename (&debian-stable-codename;, &debian-testing-codename;, sid …) or suite name (stable, + testing, unstable). This will also select versions from this release + for dependencies of this package if needed to satisfy the request. + + Removing a package removes all packaged data, but leaves usually + small (modified) user configuration files behind, in case the + remove was an accident. Just issuing an installation request for the + accidentally removed package will restore its function as before in + that case. On the other hand you can get rid of these leftovers + by calling purge even on already removed + packages. Note that this does not affect any data or configuration + stored in your home directory. + + + + (&apt-get;) + + autoremove is used to remove packages that were + automatically installed to satisfy dependencies for other packages + and are now no longer needed as dependencies changed or the package(s) + needing them were removed in the meantime. + + You should check that the list does not include applications you have + grown to like even though they were once installed just as a + dependency of another package. You can mark such a package as manually + installed by using &apt-mark;. Packages which you have installed explicitly + via install are also never proposed for automatic removal. + + + + (&apt-get;) + satisfies dependency strings, as + used in Build-Depends. It also handles conflicts, by prefixing an argument + with "Conflicts: ". + Example: apt satisfy "foo, bar (>= 1.0)" "Conflicts: baz, fuzz" + + + + + (&apt-cache;) + can be used to search for the given + ®ex; term(s) in the list of available packages and display + matches. This can e.g. be useful if you are looking for packages + having a specific feature. If you are looking for a package + including a specific file try &apt-file;. + + + + (&apt-cache;) + Show information about the given package(s) including + its dependencies, installation and download size, sources the + package is available from, the description of the packages content + and much more. It can e.g. be helpful to look at this information + before allowing &apt; to remove a package or while searching for + new packages to install. + + + + + is somewhat similar to dpkg-query --list + in that it can display a list of packages satisfying certain + criteria. It supports &glob; patterns for matching package names, + &apt-patterns;, as well as options to list installed + (), upgradeable () + or all available () versions. + + + + (work-in-progress) + edit-sources lets you edit + your &sources-list; files in your preferred text editor while also + providing basic sanity checks. + + + + (summarised in &apt-cache;) + (summarised in &apt-get;) + + + + Script Usage and Differences from Other APT Tools + + The &apt; commandline is designed as an end-user tool and it may + change behavior between versions. While it tries not to break + backward compatibility this is not guaranteed either if a change + seems beneficial for interactive use. + + All features of &apt; are available in dedicated APT tools like &apt-get; + and &apt-cache; as well. &apt; just changes the default value of some + options (see &apt-conf; and specifically the Binary scope). So you should + prefer using these commands (potentially with some additional options + enabled) in your scripts as they keep backward compatibility as much as possible. + + + + See Also + &apt-get;, &apt-cache;, &sources-list;, + &apt-conf;, &apt-config;, &apt-patterns;, + 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