summaryrefslogtreecommitdiff
path: root/dh_installdebconf.1
blob: 18ccf57bbeff13b1b4557eae5fe5b15a7f93b764 (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
.TH DH_INSTALLDEBCONF 1 "" "Debhelper Commands" "Debhelper Commands"
.SH NAME
dh_installdebconf \- install debconf files into package build directories
.SH SYNOPSIS
.B dh_installdebconf
.I "[debhelper options] [-n]"
.SH "DESCRIPTION"
dh_installdebconf is a debhelper program that is responsible for installing
files used by the debconf package into package build directories.
.P
It also automatically generates the postrm commands needed to
interface with debconf. See
.BR dh_installdeb (1)
for an explanation of how this works.
.P
Files named debian/package.config and debian/package.templates are installed
into the DEBIAN directory in the package build directory.
.P
Note that if you use debconf, your package probably needs to depend on it.
.SH "LOCALIZED TEMPLATE FILES"
Debconf also supports localized template files, and this program has some
support to aid working with them. You may find it easiest to keep the
translations in separate files, and merge them only at build time. See
.BR debconf-mergetemplate (1)
for details.
.P
This program will automatically call
.BR debconf-mergetemplate (1)
and merge templates on the fly if it finds your template files are accompnied
by translated files that have the same name as the template file, with a
dot and two letters prepended.
.P
For example, if you have a German translation,
debian/package.templates.de is merged with debian/package.templates.
.P
If you use this feature, your package should build-depend on debconf-utils.
.SH OPTIONS
.TP
.B debhelper options
See
.BR debhelper (1)
for a list of options common to all debhelper commands.
.TP
.B \-n, \--noscripts
Do not modify postrm script.
.SH ENVIRONMENT
See
.BR debhelper (1)
for a list of environment variables that affect all debhelper commands.
.SH NOTES
Note that this command is not idempotent. "dh_clean -k" should be called
between invocations of this command. Otherwise, it may cause multiple
instances of the same text to be added to maintainer scripts.
.SH "SEE ALSO"
.TP
.BR debhelper (1)
.SH AUTHOR
Joey Hess <joeyh@debian.org>