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</>
  <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><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</>
          <arg>stats</>
          <arg>dump</>
          <arg>dumpavail</>


@@ -60,7 +61,8 @@
    <VariableList>
      <VarListEntry><Term>add</Term>
      <ListItem><Para>
    <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>
      </VarListEntry>
      
      <VarListEntry><Term>gencaches</Term>


@@ -170,6 +172,14 @@ Reverse Provides:
      </itemizedlist>
      </VarListEntry>
      
      </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 
      <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 
      <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. 
      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>
 
      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/.
      <ListItem><Para>
      Only search on the package names, not the long description. 
      Configuration Item: <literal/APT::Cache::NamesOnly/.