Add a command-line action that exposes the code to cut out a subset of the cache.

1 files changed, 32 insertions, 0 deletions

diff --git a/doc/en/manpage.xml b/doc/en/manpage.xml
index 4143c502..c05cedc8 100644
--- a/doc/en/manpage.xml
+++ b/doc/en/manpage.xml
@@ -106,6 +106,15 @@
     <cmdsynopsis>
       <command>aptitude</command>
 
+      <arg choice='plain'>extract-cache-subset</arg>
+
+      <arg choice='plain'><replaceable>output-directory</replaceable></arg>
+      <arg choice='plain' rep='repeat'><replaceable>packages</replaceable></arg>
+    </cmdsynopsis>
+
+    <cmdsynopsis>
+      <command>aptitude</command>
+
       <arg choice='opt' rep='repeat'><replaceable>options</replaceable></arg>
 
       <arg choice='plain'>search</arg>
@@ -836,6 +845,29 @@ i A texlive-latex-extra Conflicts textopo</screen>
       </varlistentry>
 
       <varlistentry>
+	<term><literal>extract-cache-subset</literal></term>
+
+	<listitem>
+	  <para>
+	    Extract a subset of the package cache to the specified
+	    directory.  If no packages are listed, the entire package
+	    cache is copied; otherwise only the entries corresponding
+	    to the named packages are copied.  Each package name may
+	    be a search pattern, and all the packages matching that
+	    pattern will be selected (see the section <quote><link
+	    linkend='secSearchPatterns'>Search Patterns</link></quote>
+	    in the &aptitude; reference manual).  Any existing package
+	    lists in the output directory will be overwritten.
+	  </para>
+
+	  <para>
+	    Dependencies in binary package stanzas will be rewritten
+	    to remove references to packages not in the selected set.
+	  </para>
+	</listitem>
+      </varlistentry>
+
+      <varlistentry>
 	<term><literal>help</literal></term>
 
 	<listitem>