Options MaxArgs,MaxBytes to allow a much longer dpkg co...

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

diff --git a/doc/apt-cache.8.sgml b/doc/apt-cache.8.sgml
index 4490aea2a5eb542b8ea2501c857a5b6c99c0eb4d..e3210c1e7bcac3b1b7c629d86755ecf8041b51d3 100644 (file)
--- a/doc/apt-cache.8.sgml
+++ b/doc/apt-cache.8.sgml
@@ -23,7 +23,7 @@
  <!-- Arguments -->
  <refsynopsisdiv>
    <cmdsynopsis>
-      <command>apt-config</>
+      <command>apt-cache</>
       <arg><option>-hvs</></arg>
       <arg><option>-o=<replaceable/config string/</></arg>
       <arg><option>-c=<replaceable/file/</></arg>
@@ -31,6 +31,7 @@
          <arg>add <arg choice="plain" rep="repeat"><replaceable>file</replaceable></arg></arg>
          <arg>gencaches</>
          <arg>showpkg <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
+         <arg>showsrc <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
          <arg>stats</>
          <arg>dump</>
          <arg>dumpavail</>
@@ -41,6 +42,7 @@
          <arg>depends <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
          <arg>pkgnames <arg choice="plain"><replaceable>prefix</replaceable></arg></arg>
          <arg>dotty <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
+         <arg>policy <arg choice="plain" rep="repeat"><replaceable>pkgs</replaceable></arg></arg>
       </group>   
    </cmdsynopsis>
  </refsynopsisdiv>
@@ -53,13 +55,14 @@
    from the package metadata.
 
    <para>
-   Unless the <option/-h/, or <option/--help/ option is given one of the 
-   above commands must be present.
+   Unless the <option/-h/, or <option/--help/ option is given one of the
+   commands below must be present.
 
    <VariableList>
      <VarListEntry><Term>add</Term>
      <ListItem><Para>
-     <literal/add/ adds the names package index files to the package cache.
+     <literal/add/ adds the named package index files to the package cache.
+     This is for debugging only.
      </VarListEntry>
      
      <VarListEntry><Term>gencaches</Term>
@@ -96,8 +99,8 @@ Reverse Provides:
 </programlisting></informalexample>
                            
      <para>
-     Thus it may be seen that libreadline2, version 2.1-8, depends on libc5,
-     ncurses3.0, and ldso, which must be installed for libreadline2 to work. 
+     Thus it may be seen that libreadline2, version 2.1-12, depends on libc5 and
+     ncurses3.0 which must be installed for libreadline2 to work. 
      In turn, libreadlineg2 and libreadline2-altdev depend on libreadline2. If
      libreadline2 is installed, libc5, ncurses3.0, and ldso must also be
      installed; libreadlineg2 and libreadline2-altdev do not have to be
@@ -169,6 +172,14 @@ Reverse Provides:
      </itemizedlist>
      </VarListEntry>
      
+     <VarListEntry><Term>showsrc</Term>
+     <ListItem><Para>
+     <literal/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.
+     named packages.
+     </VarListEntry>
+     
      <VarListEntry><Term>dump</Term>
      <ListItem><Para>
      <literal/dump/ shows a short listing of every package in the cache. It is 
@@ -227,7 +238,7 @@ Reverse Provides:
      <ListItem><Para>
      <literal/dotty/ takes a list of packages on the command line and 
      gernerates output suitable for use by dotty from the 
-     <ulink url="http://www.research.att.com/sw/tools/graphviz/">GraphVis</>
+     <ulink url="http://www.research.att.com/sw/tools/graphviz/">GraphViz</>
      package. The result will be a set of nodes and edges representing the 
      relationships between the packages. By default the given packages will 
      trace out all dependent packages which can produce a very large graph. 
@@ -242,6 +253,13 @@ Reverse Provides:
 
      <para>
      Caution, dotty cannot graph larger sets of packages.
+     
+     <VarListEntry><Term>policy</Term>
+     <ListItem><Para>
+     <literal/policy/ is ment to help debug issues relating to the 
+     preferences file. With no arguments it will print out the 
+     priorities of each source. Otherwise it prints out detailed information
+     about the priority selection of the named package.
      </VarListEntry>
    </VariableList>
  </RefSect1>
@@ -318,7 +336,7 @@ Reverse Provides:
      <ListItem><Para>
      Make <literal/depends/ recursive so that all packages mentioned are 
      printed once.
-     Configuration Item: <literal/APT::Cache::RecruseDepends/.
+     Configuration Item: <literal/APT::Cache::RecurseDepends/.
      </VarListEntry>
 
      &apt-commonoptions;