~ubuntu-branches/ubuntu/breezy/apt/breezy

« back to all changes in this revision

Viewing changes to doc/apt-extracttemplates.1

  • Committer: Bazaar Package Importer
  • Author(s): Matt Zimmerman
  • Date: 2005-03-07 20:08:33 UTC
  • Revision ID: james.westby@ubuntu.com-20050307200833-0lxdgg2cb4oculdv
Tags: 0.6.35
* Merge apt--mvo--0 (incorporates 0.6.34ubuntu1):
  - Implement MaxSize and MaxAge in apt.cron.daily, to prevent the cache
    from growing too large (Ubuntu #6761)
  - some comments about the pkgAcqMetaSig::Custom600Headers() added
  - use gpg --with-colons
  - commented the ftp no_proxy unseting in methods/ftp.cc
  - added support for "Acquire::gpgv::options" in methods/gpgv.cc
* Merge bubulle@debian.org--2005/apt--main--0
  - Make capitalization more consistent
  - Un-fuzzy translations resulting from capitalization changes
  - Italian translation update

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" This manpage has been automatically generated by docbook2man-spec
2
 
.\" from a DocBook document.  docbook2man-spec can be found at:
3
 
.\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> 
4
 
.\" Please send any bug reports, improvements, comments, patches, 
5
 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
6
 
.TH "APT-EXTRACTTEMPLATES" "1" "12 March 2001" "" ""
 
1
.\"Generated by db2man.xsl. Don't modify this, modify the source.
 
2
.de Sh \" Subsection
 
3
.br
 
4
.if t .Sp
 
5
.ne 5
 
6
.PP
 
7
\fB\\$1\fR
 
8
.PP
 
9
..
 
10
.de Sp \" Vertical space (when we can't use .PP)
 
11
.if t .sp .5v
 
12
.if n .sp
 
13
..
 
14
.de Ip \" List item
 
15
.br
 
16
.ie \\n(.$>=3 .ne \\$3
 
17
.el .ne 3
 
18
.IP "\\$1" \\$2
 
19
..
 
20
.TH "APT-EXTRACTTEMPLAT" 1 "29 February 2004" "Linux" ""
7
21
.SH NAME
8
22
apt-extracttemplates \- Utility to extract DebConf config and templates from Debian packages
9
 
.SH SYNOPSIS
10
 
.sp
11
 
\fBapt-extracttemplate\fR [ \fB-hv\fR ]  [ \fB-t=\fItemporary directory\fB\fR ]  \fB\fIfile\fB\fR\fI...\fR
 
23
.SH "SYNOPSIS"
 
24
.ad l
 
25
.hy 0
 
26
.HP 21
 
27
\fBapt\-extracttemplates\fR [\fB\-hv\fR] [\fB\-t=\fItemporary\ directory\fR\fR] \fIfile\fR...
 
28
.ad
 
29
.hy
 
30
 
12
31
.SH "DESCRIPTION"
13
 
.PP
14
 
\fBapt-extracttemplates\fR will take one or more Debian package files
15
 
as input and write out (to a temporary directory) all associated config
16
 
scripts and template files. For each passed in package that contains 
17
 
config scripts and templates, one line of output will be generated
18
 
in the format:
19
 
.PP
20
 
package version template-file config-script
21
 
.PP
22
 
template-file and config-script are written to the temporary directory
23
 
specified by the -t or --tempdir (APT::ExtractTemplates::TempDir>) 
24
 
directory, with filenames of the form \fItemplate.XXXX\fR and 
25
 
\fIconfig.XXXX\fR
 
32
 
 
33
.PP
 
34
\fBapt\-extracttemplates\fR 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:
 
35
 
 
36
.PP
 
37
package version template\-file config\-script
 
38
 
 
39
.PP
 
40
template\-file and config\-script are written to the temporary directory specified by the \-t or \-\-tempdir (APT::ExtractTemplates::TempDir) directory, with filenames of the form \fIpackage\&.template\&.XXXX\fR and \fIpackage\&.config\&.XXXX\fR
 
41
 
26
42
.SH "OPTIONS"
 
43
 
27
44
.PP
28
 
All command line options may be set using the configuration file, the
29
 
descriptions indicate the configuration option to set. For boolean
30
 
options you can override the config file by using something like 
31
 
\fB-f-\fR,\fB--no-f\fR, \fB-f=no\fR or several other variations.
32
 
.TP
33
 
\fB-t\fR
34
 
.TP
35
 
\fB--tempdir\fR
36
 
Temporary directory in which to write extracted debconf template files
37
 
and config scripts
38
 
Configuration Item: APT::ExtractTemplates::TempDir.
39
 
.TP
40
 
\fB-h\fR
41
 
.TP
42
 
\fB--help\fR
43
 
Show a short usage summary.
44
 
.TP
45
 
\fB-v\fR
46
 
.TP
47
 
\fB--version\fR
48
 
Show the program verison.
49
 
.TP
50
 
\fB-c\fR
51
 
.TP
52
 
\fB--config-file\fR
53
 
Configuration File; Specify a configuration file to use. 
54
 
The program will read the default configuration file and then this 
55
 
configuration file. See \fB\fIapt.conf\fB\fR(5) for syntax information. 
56
 
.TP
57
 
\fB-o\fR
58
 
.TP
59
 
\fB--option\fR
60
 
Set a Configuration Option; This will set an arbitary configuration 
61
 
option. The syntax is \fB-o Foo::Bar=bar\fR.
 
45
All command line options may be set using the configuration file, the descriptions indicate the configuration option to set\&. For boolean options you can override the config file by using something like \fB\-f\-\fR,\fB\-\-no\-f\fR, \fB\-f=no\fR or several other variations\&.
 
46
 
 
47
.TP
 
48
\fB\-t\fR, \fB\-\-tempdir\fR, 
 
49
Temporary directory in which to write extracted debconf template files and config scripts Configuration Item: APT::ExtractTemplates::TempDir
 
50
 
 
51
.TP
 
52
\fB\-h\fR, \fB\-\-help\fR, 
 
53
Show a short usage summary\&.
 
54
 
 
55
.TP
 
56
\fB\-v\fR, \fB\-\-version\fR, 
 
57
Show the program version\&.
 
58
 
 
59
.TP
 
60
\fB\-c\fR, \fB\-\-config\-file\fR, 
 
61
Configuration File; Specify a configuration file to use\&. The program will read the default configuration file and then this configuration file\&. See \fB\fIapt\&.conf\fR\fR(5) for syntax information\&.
 
62
 
 
63
.TP
 
64
\fB\-o\fR, \fB\-\-option\fR, 
 
65
Set a Configuration Option; This will set an arbitary configuration option\&. The syntax is \fB\-o Foo::Bar=bar\fR\&.
 
66
 
62
67
.SH "SEE ALSO"
 
68
 
63
69
.PP
64
 
\fB\fIapt.conf\fB\fR(5)
 
70
\fB\fIapt\&.conf\fR\fR(5)
 
71
 
65
72
.SH "DIAGNOSTICS"
 
73
 
66
74
.PP
67
 
\fBapt-extracttemplates\fR returns zero on normal operation, decimal 100 on error.
 
75
\fBapt\-extracttemplates\fR returns zero on normal operation, decimal 100 on error\&.
 
76
 
68
77
.SH "BUGS"
69
 
.PP
70
 
See the APT bug page <URL:http://bugs.debian.org/apt>. 
71
 
If you wish to report a bug in APT, please see 
72
 
\fI/usr/share/doc/debian/bug-reporting.txt\fR or the \fBbug\fR(1) command.
73
 
.SH "AUTHOR"
74
 
.PP
75
 
APT was written by the APT team <apt@packages.debian.org>.
 
78
 
 
79
.PP
 
80
APT bug page: \fIhttp://bugs.debian.org/src:apt\fR\&. If you wish to report a bug in APT, please see \fI/usr/share/doc/debian/bug\-reporting\&.txt\fR or the \fB\fBreportbug\fR\fR(1) command\&.
 
81
 
 
82
.SH AUTHORS
 
83
Jason Gunthorpe, APT team.