X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/facac1c52ebe40656af693502cab66eb4c09ad2f..3fc8752ba81be4aea05d52039f959fe03be64002:/doc/apt-cache.8.xml diff --git a/doc/apt-cache.8.xml b/doc/apt-cache.8.xml index 0e1d2f8d9..9851135b1 100644 --- a/doc/apt-cache.8.xml +++ b/doc/apt-cache.8.xml @@ -21,6 +21,7 @@ apt-cache 8 + APT @@ -51,6 +52,7 @@ rdepends pkg pkgnames prefix dotty pkg + xvcg pkg policy pkgs madison pkgs @@ -151,7 +153,7 @@ Reverse Provides: 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 (real or virtual) has been dropped from the distribution. Usually they - are referenced from Conflicts statements. + are referenced from Conflicts or Breaks statements. Total distinct versions is the number of package versions @@ -191,15 +193,20 @@ Reverse Provides: show pkg(s) show performs a function similar to - dpkg --print-availi; it displays the package records for the + dpkg --print-avail; it displays the package records for the named packages. search regex [ regex ... ] search performs a full text search on all available package - lists for the regex pattern given. It searches the package names and the + lists for the POSIX regex pattern given, see + regex + 7. + 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. If is given + the package name and the short description, including virtual package + names. + 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. @@ -219,11 +226,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 nessasarily available to download, + installable or installed, e.g. virtual packages are also listed in the generated list. + dotty pkg(s) @@ -244,6 +254,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 @@ -277,7 +292,7 @@ Reverse Provides: Select the file to store the source cache. The source is used only by gencaches and it stores a parsed version of the package information from remote sources. When building the package cache the - source cache is used to advoid reparsing all of the package files. + source cache is used to avoid reparsing all of the package files. Configuration Item: Dir::Cache::srcpkgcache. @@ -289,7 +304,7 @@ 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. @@ -345,21 +360,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;