abstract the code to iterate over all targets a bit

[apt.git] / doc / apt-extracttemplates.1.xml

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % aptent SYSTEM "apt.ent"> %aptent;
<!ENTITY % aptverbatiment SYSTEM "apt-verbatim.ent"> %aptverbatiment;
<!ENTITY % aptvendor SYSTEM "apt-vendor.ent"> %aptvendor;
]>

<refentry>

 <refentryinfo>
   &apt-author.jgunthorpe;
   &apt-author.team;
   &apt-email;
   &apt-product;
   <!-- The last update date -->
   <date>2012-06-09T00:00:00Z</date>
 </refentryinfo>
 
 <refmeta>
   <refentrytitle>apt-extracttemplates</refentrytitle>
   <manvolnum>1</manvolnum>
   <refmiscinfo class="manual">APT</refmiscinfo>
 </refmeta>
 
 <!-- Man page title -->
 <refnamediv>
    <refname>apt-extracttemplates</refname>
    <refpurpose>Utility to extract <command>debconf</command> config and templates from Debian packages</refpurpose>
 </refnamediv>

 &synopsis-command-apt-extracttemplates;

 <refsect1><title>Description</title>
   <para><command>apt-extracttemplates</command> will take one or more Debian package files
   as input and write out (to a temporary directory) all associated config
   scripts and template files. For each passed in package that contains 
   config scripts and templates, one line of output will be generated
   in the format:</para>
   <para>package version template-file config-script</para>
   <para>template-file and config-script are written to the temporary directory
   specified by the <option>-t</option> or <option>--tempdir</option>
   (<literal>APT::ExtractTemplates::TempDir</literal>) directory,
   with filenames of the form <filename>package.template.XXXXXX</filename> and
   <filename>package.config.XXXXXX</filename></para>
 </refsect1>
 
 <refsect1><title>options</title>
   &apt-cmdblurb;

   <variablelist>
     <varlistentry><term><option>-t</option></term><term><option>--tempdir</option></term>
     <listitem><para>
     Temporary directory in which to write extracted <command>debconf</command> template files
     and config scripts.
     Configuration Item: <literal>APT::ExtractTemplates::TempDir</literal></para></listitem>
     </varlistentry>

     &apt-commonoptions;
     
   </variablelist>
     
   
 </refsect1>

 <refsect1><title>See Also</title>
   <para>&apt-conf;</para>
 </refsect1>

 <refsect1><title>Diagnostics</title>
   <para><command>apt-extracttemplates</command> returns zero on normal operation, decimal 100 on error.</para>
 </refsect1>

 &manbugs;
 
</refentry>