fix some build-dep bugs; update changelog

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

diff --git a/doc/apt-cache.8.sgml b/doc/apt-cache.8.sgml
index 2ed4c84b85739857337c87f481893c7e7b63a6fb..ef923579dd7d3f4d515971e8c9e1e7dd6c23abea 100644 (file)
--- a/doc/apt-cache.8.sgml
+++ b/doc/apt-cache.8.sgml
@@ -24,13 +24,14 @@
  <refsynopsisdiv>
    <cmdsynopsis>
       <command>apt-cache</>
-      <arg><option>-hvs</></arg>
+      <arg><option>-hvsn</></arg>
       <arg><option>-o=<replaceable/config string/</></arg>
       <arg><option>-c=<replaceable/file/</></arg>
       <group choice=req>
          <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</>
@@ -60,7 +61,8 @@
    <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>
@@ -170,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 
@@ -228,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. 
@@ -309,7 +319,7 @@ Reverse Provides:
      Configuration Item: <literal/APT::Cache::Generate/.
      </VarListEntry>
 
-     <VarListEntry><term><option/--names-only/</>
+     <VarListEntry><term><option/--names-only/</><term><options/-n/</>
      <ListItem><Para>
      Only search on the package names, not the long description. 
      Configuration Item: <literal/APT::Cache::NamesOnly/.