X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/45fb8bf7f0b3f1e5b69b37a2f9a07a6864448f03..c38847ebbbab115b01dd1421dee55d5a50d404f1:/doc/apt-cache.8.xml diff --git a/doc/apt-cache.8.xml b/doc/apt-cache.8.xml index f36347107..ac3aaa37a 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 @@ -100,20 +96,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. @@ -127,8 +123,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 + number of total package names. 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. @@ -142,7 +138,7 @@ 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. + records that declare the name to be a binary package. @@ -168,9 +164,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 +172,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 +210,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 +267,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 +281,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 +307,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 +319,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.