methods: read config in most to least specific order

[apt.git] / doc / apt-cache.8.xml

diff --git a/doc/apt-cache.8.xml b/doc/apt-cache.8.xml
index 71bbca60d86e4a63a99879c1ee953b6e39ca33c3..66f608b135c957258c29210fbcf0a4e7859f8643 100644 (file)
--- a/doc/apt-cache.8.xml
+++ b/doc/apt-cache.8.xml
@@ -299,8 +299,8 @@ Reverse Provides:
      <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
+             it will also show dependencies implicitly added based on the encountered data.
+             A <literal>Conflicts: foo</literal> e.g. expresses implicitly that this package
              also conflicts with the package foo from any other architecture.
              Configuration Item: <literal>APT::Cache::ShowImplicit</literal>.
        </para></listitem>
@@ -350,6 +350,21 @@ Reverse Provides:
       Configuration Item: <literal>APT::Cache::Installed</literal>.</para></listitem>
       </varlistentry>
 
+      <varlistentry><term><option>--with-source</option> <option>&synopsis-param-filename;</option></term>
+      <listitem><para>
+      Adds the given file as a source for metadata. Can be repeated to add multiple files.
+      Supported are currently <literal>*.deb</literal>, <literal>*.dsc</literal>,
+      <literal>*.changes</literal>, <literal>Sources</literal> and
+      <literal>Packages</literal> files as well as source package directories.
+      Files are matched based on their name only, not their content!</para>
+      <para><literal>Sources</literal> and <literal>Packages</literal> can be compressed in any
+      format apt supports as long as they have the correct extension. If you need to store
+      multiple of these files in one directory you can prefix a name of your choice with the
+      last character being an underscore ("<literal>_</literal>"). Example: my.example_Packages.xz</para>
+      <para>Note that these sources are treated as trusted (see &apt-secure;).
+      Configuration Item: <literal>APT::Sources::With</literal>.</para></listitem>
+      </varlistentry>
+
      &apt-commonoptions;
      
    </variablelist>