X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/5abbf5bbb5ee8717f89cac6ef409c4cec79259f6..d1bdb73a96d01896ec8e213a0f14abc38d19a929:/doc/apt-cache.8.xml
diff --git a/doc/apt-cache.8.xml b/doc/apt-cache.8.xml
index a9f6c8da2..66f608b13 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 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.
@@ -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.
@@ -331,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;