* Add an "apt-cache madison" command with an output for...

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

diff --git a/doc/apt-cache.8.sgml b/doc/apt-cache.8.sgml
index b817a181f70e44498cf1d9974ec36b03854fe70e..2ef3a2d259f8a070953a0e451b36cbe3b64631cf 100644 (file)
--- a/doc/apt-cache.8.sgml
+++ b/doc/apt-cache.8.sgml
@@ -43,6 +43,7 @@
          <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>
+         <arg>madison <arg choice="plain" rep="repeat"><replaceable>pkgs</replaceable></arg></arg>
       </group>   
    </cmdsynopsis>
  </refsynopsisdiv>
@@ -214,7 +215,7 @@ Reverse Provides:
      package, and if <option/--names-only/ is given then the long description
      is not searched, only the package name is.
      <para>
-     Seperate arguments can be used to specify multiple search patterns that 
+     Separate arguments can be used to specify multiple search patterns that 
      are and'ed together.
      </VarListEntry>
 
@@ -266,6 +267,16 @@ Reverse Provides:
      priorities of each source. Otherwise it prints out detailed information
      about the priority selection of the named package.
      </VarListEntry>
+
+     <VarListEntry><Term>madison <replaceable/[ pkg(s) ]/</Term>
+     <ListItem><Para>
+
+     <literal/apt-cache/'s <literal/madison/ command attempts to mimic
+     the output format and a subset of the functionality of the katie
+     program, <literal/madison/.  It displays available versions of a
+     package in a tabular format.
+
+     </VarListEntry>
    </VariableList>
  </RefSect1>
  
@@ -292,14 +303,14 @@ Reverse Provides:
      <VarListEntry><term><option/-q/</><term><option/--quiet/</>
      <ListItem><Para>
      Quiet; produces output suitable for logging, omitting progress indicators.
-     More qs will produce more quietness up to a maximum of 2. You can also use
+     More q's will produce more quietness up to a maximum of 2. You can also use
      <option/-q=#/ to set the quietness level, overriding the configuration file.
      Configuration Item: <literal/quiet/.
      </VarListEntry>
 
      <VarListEntry><term><option/-i/</><term><option/--important/</>
      <ListItem><Para>
-     Print only important deps; for use with unmet. Causes only Depends and 
+     Print only important dependencies; for use with unmet. Causes only Depends and 
      Pre-Depends relations to be printed.
      Configuration Item: <literal/APT::Cache::Important/.
      </VarListEntry>
@@ -342,11 +353,18 @@ Reverse Provides:
 
      <VarListEntry><term><option/--recurse/</>
      <ListItem><Para>
-     Make <literal/depends/ recursive so that all packages mentioned are 
-     printed once.
+     Make <literal/depends/ and <literal/rdepends/ recursive so that
+     all packages mentioned are printed once.
      Configuration Item: <literal/APT::Cache::RecurseDepends/.
      </VarListEntry>
 
+     <VarListEntry><term><option/--installed/</>
+     <ListItem><Para>
+     Limit the output of <literal/depends/ and <literal/rdepends/ to
+     packages which are currently installed.
+     Configuration Item: <literal/APT::Cache::Installed/.
+     </VarListEntry>
+
      &apt-commonoptions;
      
    </VariableList>