summaryrefslogtreecommitdiff
path: root/doc/apt-extracttemplates.1.sgml
blob: df2bd0b930d17d6d0898af5f65ef3d5aa7d43637 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
<!-- -*- mode: sgml; mode: fold -*- -->
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [

<!ENTITY % aptent SYSTEM "apt.ent">
%aptent;

]>

<refentry>
 &apt-docinfo;
 
 <refmeta>
   <refentrytitle>apt-extracttemplates</>
   <manvolnum>1</>
 </refmeta>
 
 <!-- Man page title -->
 <refnamediv>
    <refname>apt-extracttemplates</>
    <refpurpose>Utility to extract DebConf config and templates from Debian packages</>
 </refnamediv>

 <!-- Arguments -->
 <refsynopsisdiv>
   <cmdsynopsis>
      <command>apt-extracttemplate</>
      <arg><option>-hv</></arg>
      <arg><option>-t=<replaceable/temporary directory/</></arg>
      <arg choice="plain" rep="repeat"><replaceable>file</replaceable></arg>
   </cmdsynopsis>
 </refsynopsisdiv>
 
 <RefSect1><Title>Description</>
   <para>   
   <command/apt-extracttemplates/ 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>
   package version template-file config-script
   <para>
   template-file and config-script are written to the temporary directory
   specified by the -t or --tempdir (<literal/APT::ExtractTemplates::TempDir/>) 
   directory, with filenames of the form <filename>package.template.XXXX</> and 
   <filename>package.config.XXXX</>
 </RefSect1>
 
 <RefSect1><Title>Options</>
   &apt-cmdblurb;

   <VariableList>
     <VarListEntry><term><option/-t/</><term><option/--tempdir/</>
     <ListItem><Para>
     Temporary directory in which to write extracted debconf template files
     and config scripts
     Configuration Item: <literal/APT::ExtractTemplates::TempDir/.
     </VarListEntry>

     &apt-commonoptions;
     
   </VariableList>
     
   
 </RefSect1>

 <RefSect1><Title>See Also</>
   <para>
   &apt-conf;
 </RefSect1>

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

 &manbugs;
 &manauthor;
 
</refentry>