From 36c34abfb13980a8191f359d07d06a0339c7f8af Mon Sep 17 00:00:00 2001
From: Daniel Burrows <dburrows@debian.org>
Date: Tue, 18 Mar 2008 11:00:20 -0700
Subject: Add a command-line action that exposes the code to cut out a subset
 of the cache.

---
 doc/en/manpage.xml | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

(limited to 'doc/en/manpage.xml')

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
@@ -103,6 +103,15 @@
       <arg choice='plain' rep='repeat'><replaceable>packages</replaceable></arg>
     </cmdsynopsis>
 
+    <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>
 
@@ -835,6 +844,29 @@ i A texlive-latex-extra Conflicts textopo</screen>
 	</listitem>
       </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>
 
-- 
cgit v1.2.3