X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/cfe0526e097983680ce7c3675bbf77f735675e9d..3fa950f16cb2997bccd97475f75c5f3e37609dd3:/doc/apt-cache.8.xml diff --git a/doc/apt-cache.8.xml b/doc/apt-cache.8.xml index 6416f4edf..42d700c82 100644 --- a/doc/apt-cache.8.xml +++ b/doc/apt-cache.8.xml @@ -5,6 +5,9 @@ %aptent; + +%aptverbatiment; + ]> @@ -15,48 +18,23 @@ &apt-email; &apt-product; - 29 February 2004 + 04 February 2011 apt-cache 8 + APT apt-cache - APT package handling utility -- cache manipulator + query the APT cache - - - - apt-cache - - - - - add file - gencaches - showpkg pkg - showsrc pkg - stats - dump - dumpavail - unmet - search regex - show pkg - depends pkg - rdepends pkg - pkgnames prefix - dotty pkg - policy pkgs - madison pkgs - - - - + &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 @@ -67,11 +45,6 @@ commands below must be present. - add file(s) - add adds the named package index files to the package cache. - This is for debugging only. - - gencaches gencaches performs the same operation as apt-get check. It builds the source and package caches from @@ -149,7 +122,7 @@ Reverse Provides: Missing is the number of package names that were referenced in a dependency but were not provided by any package. Missing packages may - be in evidence if a full distribution is not accessed, or if a package + be an evidence if a full distribution is not accessed, or if a package (real or virtual) has been dropped from the distribution. Usually they are referenced from Conflicts or Breaks statements. @@ -224,11 +197,14 @@ Reverse Provides: pkgnames [ prefix ] - This command prints the name of each package in the system. The optional + This command prints the name of each package APT knows. The optional argument is a prefix match to filter the name list. The output is suitable for use in a shell tab complete function and the output is generated extremely quickly. This command is best used with the - option. + option. + Note that a package which APT knows of is not necessarily available to download, + installable or installed, e.g. virtual packages are also listed in the generated list. + dotty pkg(s) @@ -249,6 +225,11 @@ Reverse Provides: Caution, dotty cannot graph larger sets of packages. + xvcg pkg(s) + The same as dotty, only for xvcg from the + VCG tool. + + policy [ pkg(s) ] policy is meant to help debug issues relating to the preferences file. With no arguments it will print out the @@ -256,7 +237,7 @@ Reverse Provides: about the priority selection of the named package. - madison /[ pkg(s) ] + madison [ pkg(s) ] apt-cache's madison command attempts to mimic the output format and a subset of the functionality of the Debian archive management tool, madison. It displays @@ -294,11 +275,25 @@ Reverse Provides: - Print only important dependencies; for use with unmet. 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. + + + + + + + + + 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. + Print full package records when searching. Configuration Item: APT::Cache::ShowFull. @@ -350,21 +345,8 @@ Reverse Provides: Files - /etc/apt/sources.list - Locations to fetch packages from. - Configuration Item: Dir::Etc::SourceList. - - - &statedir;/lists/ - Storage area for state information for each package resource specified in - &sources-list; - Configuration Item: Dir::State::Lists. - - - &statedir;/lists/partial/ - Storage area for state information in transit. - Configuration Item: Dir::State::Lists (implicit partial). - + &file-sourceslist; + &file-statelists;