X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/6c1f5d2c3c8df164e78dda8f24d28667634403e1..bc7a59dded57338e9b5e523726b246dbdd4e0935:/doc/apt-cache.8.xml diff --git a/doc/apt-cache.8.xml b/doc/apt-cache.8.xml index f36347107..a76eb1000 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-05-21T00:00:00Z + 2012-06-09T00: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. @@ -100,20 +102,20 @@ Reverse Provides: Pure virtual packages is the number of packages that exist only as a virtual package name; that is, packages only "provide" the virtual package name, and no package actually uses the name. For - instance, "mail-transport-agent" in the Debian GNU/Linux system is a + instance, "mail-transport-agent" in the Debian system is a pure virtual package; several packages provide "mail-transport-agent", but there is no package named "mail-transport-agent". Single virtual packages is the number of packages with only one package providing a particular virtual package. For example, in the - Debian GNU/Linux system, "X11-text-viewer" is a virtual package, but + Debian system, "X11-text-viewer" is a virtual package, but only one package, xless, provides "X11-text-viewer". Mixed virtual packages is the number of packages that either provide a particular virtual package or have the virtual package name - as the package name. For instance, in the Debian GNU/Linux system, + as the package name. For instance, in the Debian system, "debconf" is both an actual package, and provided by the debconf-tiny package. @@ -126,9 +128,8 @@ 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 (both - "stable" and "unstable", for instance), is being accessed, this value + 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. + 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. + @@ -168,9 +172,7 @@ Reverse Provides: search performs a full text search on all available package - lists for the POSIX regex pattern given, see - regex - 7. + lists for the POSIX regex pattern given, see ®ex;. It searches the package names and the descriptions for an occurrence of the regular expression and prints out the package name and the short description, including virtual package @@ -178,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. @@ -216,9 +218,9 @@ Reverse Provides: set the APT::Cache::GivenOnly option. The resulting nodes will have several shapes; normal packages are boxes, - pure provides are triangles, mixed provides are diamonds, + pure virtual packages are triangles, mixed virtual packages are diamonds, missing packages are hexagons. Orange boxes mean recursion was stopped - [leaf packages], blue lines are pre-depends, green lines are conflicts. + (leaf packages), blue lines are pre-depends, green lines are conflicts. Caution, dotty cannot graph larger sets of packages. @@ -273,7 +275,8 @@ Reverse Provides: - Print only important dependencies; for use with unmet and depends. Causes only Depends and + Print only important dependencies; for use with unmet + and depends. Causes only Depends and Pre-Depends relations to be printed. Configuration Item: APT::Cache::Important. @@ -286,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. @@ -301,7 +315,7 @@ Reverse Provides: Print full records for all available versions. This is the default; to turn it off, use . If is specified, only the candidate version - will displayed (the one which would be selected for installation). + will be displayed (the one which would be selected for installation). This option is only applicable to the show command. Configuration Item: APT::Cache::AllVersions. @@ -313,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.