X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/c7c71e20d8f1e055ec55c7afeaee52381acfed5b..4b8f2236b40599e191814fcd74e6a48eeafd757f:/doc/apt-cache.8.xml?ds=sidebyside
diff --git a/doc/apt-cache.8.xml b/doc/apt-cache.8.xml
index daccb6c6f..b649149af 100644
--- a/doc/apt-cache.8.xml
+++ b/doc/apt-cache.8.xml
@@ -1,13 +1,9 @@
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
-
-<!ENTITY % aptent SYSTEM "apt.ent">
-%aptent;
-
-<!ENTITY % aptverbatiment SYSTEM "apt-verbatim.ent">
-%aptverbatiment;
-
+<!ENTITY % aptent SYSTEM "apt.ent"> %aptent;
+<!ENTITY % aptverbatiment SYSTEM "apt-verbatim.ent"> %aptverbatiment;
+<!ENTITY % aptvendor SYSTEM "apt-vendor.ent"> %aptvendor;
]>
<refentry>
@@ -18,7 +14,7 @@
&apt-email;
&apt-product;
<!-- The last update date -->
- <date>2012-05-21T00:00:00Z</date>
+ <date>2012-06-09T00:00:00Z</date>
</refentryinfo>
<refmeta>
@@ -126,9 +122,8 @@ Reverse Provides:
</listitem>
<listitem><para><literal>Total distinct</literal> 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.</para>
</listitem>
@@ -140,9 +135,12 @@ Reverse Provides:
</varlistentry>
<varlistentry><term><option>showsrc</option> <option><replaceable>&synopsis-pkg;</replaceable>â¦</option></term>
- <listitem><para><literal>showsrc</literal> 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.</para></listitem>
+ <listitem><para><literal>showsrc</literal> 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 <option>--only-source</option> to
+ display only source package names.
+ </para></listitem>
</varlistentry>
<varlistentry><term><option>dump</option></term>
@@ -176,7 +174,7 @@ Reverse Provides:
If <option>--full</option> is given
then output identical to <literal>show</literal> is produced for each matched
package, and if <option>--names-only</option> is given then the long description
- is not searched, only the package name is.</para>
+ is not searched, only the package name and provided packages are.</para>
<para>
Separate arguments can be used to specify multiple search patterns that
are and'ed together.</para></listitem>
@@ -214,9 +212,9 @@ Reverse Provides:
set the <literal>APT::Cache::GivenOnly</literal> option.</para>
<para>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.</para>
+ (leaf packages), blue lines are pre-depends, green lines are conflicts.</para>
<para>Caution, dotty cannot graph larger sets of packages.</para></listitem>
</varlistentry>
@@ -285,12 +283,23 @@ Reverse Provides:
<term><option>--no-breaks</option></term>
<term><option>--no-replaces</option></term>
<term><option>--no-enhances</option></term>
- <listitem><para>Per default the <literal>depends</literal> and
- <literal>rdepends</literal> print all dependencies. This can be tweaked with
+ <listitem><para>Per default the <command>depends</command> and
+ <command>rdepends</command> print all dependencies. This can be tweaked with
these flags which will omit the specified dependency type.
Configuration Item: <literal>APT::Cache::Show<replaceable>DependencyType</replaceable></literal>
e.g. <literal>APT::Cache::ShowRecommends</literal>.</para></listitem>
</varlistentry>
+
+ <varlistentry><term><option>--implicit</option></term>
+ <listitem><para>Per default <command>depends</command> and <command>rdepends</command>
+ print only dependencies explicitly expressed in the metadata. With this flag
+ it will also show dependencies implicitely added based on the encountered data.
+ A <literal>Conflicts: foo</literal> e.g. expresses implicitely that this package
+ also conflicts with the package foo from any other architecture.
+ Configuration Item: <literal>APT::Cache::ShowImplicit</literal>.
+ </para></listitem>
+ </varlistentry>
+
<varlistentry><term><option>-f</option></term><term><option>--full</option></term>
<listitem><para>Print full package records when searching.
Configuration Item: <literal>APT::Cache::ShowFull</literal>.</para></listitem>
@@ -312,7 +321,7 @@ Reverse Provides:
</varlistentry>
<varlistentry><term><option>--names-only</option></term><term><option>-n</option></term>
- <listitem><para>Only search on the package names, not the long descriptions.
+ <listitem><para>Only search on the package and provided package names, not the long descriptions.
Configuration Item: <literal>APT::Cache::NamesOnly</literal>.</para></listitem>
</varlistentry>