X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/ad2d0cef574ff0143ee27cdbd058cba179368dbd..422a2eba84361a8dfd84b549c13037512779c572:/doc/apt-cache.8.xml?ds=sidebyside diff --git a/doc/apt-cache.8.xml b/doc/apt-cache.8.xml index 0955c1c9e..5c16ce851 100644 --- a/doc/apt-cache.8.xml +++ b/doc/apt-cache.8.xml @@ -1,13 +1,9 @@ -%aptent; - - -%aptverbatiment; - + %aptent; + %aptverbatiment; + %aptvendor; ]> @@ -18,7 +14,7 @@ &apt-email; &apt-product; - 2012-06-09T00:00:00Z + 2016-08-30T00:00:00Z @@ -36,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. @@ -126,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. @@ -140,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. + @@ -176,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. @@ -285,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 implicitly added based on the encountered data. + A Conflicts: foo e.g. expresses implicitly 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. @@ -312,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. @@ -335,6 +350,21 @@ Reverse Provides: Configuration Item: APT::Cache::Installed. + + + Adds the given file as a source for metadata. Can be repeated to add multiple files. + Supported are currently *.deb, *.dsc, + *.changes, Sources and + Packages files as well as source package directories. + Files are matched based on their name only, not their content! + Sources and Packages can be compressed in any + format apt supports as long as they have the correct extension. If you need to store + multiple of these files in one directory you can prefix a name of your choice with the + last character being an underscore ("_"). Example: my.example_Packages.xz + Note that these sources are treated as trusted (see &apt-secure;). + Configuration Item: APT::Sources::With. + + &apt-commonoptions;