X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/8c782efd93342c6119e8ba2ff6989b7a164b7f3d..c1ab34c75f7e98fa1a9686c7bc59e578e1ae9572:/doc/apt-cache.8.xml diff --git a/doc/apt-cache.8.xml b/doc/apt-cache.8.xml index a9f6c8da2..71bbca60d 100644 --- a/doc/apt-cache.8.xml +++ b/doc/apt-cache.8.xml @@ -14,7 +14,7 @@ &apt-email; &apt-product; - 2012-06-09T00:00:00Z + 2015-10-27T00:00:00Z @@ -32,10 +32,16 @@ &synopsis-command-apt-cache; Description - apt-cache performs a variety of operations on APT's package - cache. apt-cache does not manipulate the state of the system - but does provide operations to search and generate interesting output - from the package metadata. + + apt-cache performs a variety of operations on APT's + package cache. apt-cache does not manipulate the + state of the system but does provide operations to search and generate + interesting output from the package metadata. The metadata is acquired + and updated via the 'update' command of e.g. apt-get, + so that it can be outdated if the last update is too long ago, but in + exchange apt-cache works independently of the + availability of the configured sources (e.g. offline). + Unless the , or option is given, one of the commands below must be present. @@ -122,8 +128,7 @@ Reverse Provides: Total distinct versions is the number of package versions - found in the cache; this value is therefore at least equal to the - number of total package names. If more than one distribution is being accessed + found in the cache. If more than one distribution is being accessed (for instance, "stable" and "unstable"), this value can be considerably larger than the number of total package names. @@ -136,9 +141,12 @@ Reverse Provides: - showsrc displays all the source package records that match - the given package names. All versions are shown, as well as all - records that declare the name to be a binary package. + showsrc displays all the + source package records that match the given package names. All + versions are shown, as well as all records that declare the name + to be a binary package. Use to + display only source package names. + @@ -172,7 +180,7 @@ Reverse Provides: If is given then output identical to show is produced for each matched package, and if is given then the long description - is not searched, only the package name is. + is not searched, only the package name and provided packages are. Separate arguments can be used to specify multiple search patterns that are and'ed together. @@ -281,12 +289,23 @@ Reverse Provides: - Per default the depends and - rdepends print all dependencies. This can be tweaked with + Per default the depends and + rdepends print all dependencies. This can be tweaked with these flags which will omit the specified dependency type. Configuration Item: APT::Cache::ShowDependencyType e.g. APT::Cache::ShowRecommends. + + + Per default depends and rdepends + print only dependencies explicitly expressed in the metadata. With this flag + it will also show dependencies implicitely added based on the encountered data. + A Conflicts: foo e.g. expresses implicitely that this package + also conflicts with the package foo from any other architecture. + Configuration Item: APT::Cache::ShowImplicit. + + + Print full package records when searching. Configuration Item: APT::Cache::ShowFull. @@ -308,7 +327,7 @@ Reverse Provides: - Only search on the package names, not the long descriptions. + Only search on the package and provided package names, not the long descriptions. Configuration Item: APT::Cache::NamesOnly.