5 dh_installdebconf - install files used by debconf in package build directories
10 use Debian::Debhelper::Dh_Lib;
14 B<dh_installdebconf> [S<I<debhelper options>>] [B<-n>] [S<B<--> I<params>>]
18 dh_installdebconf is a debhelper program that is responsible for installing
19 files used by the debconf package into package build directories.
21 It also automatically generates the postrm commands needed to
22 interface with debconf. See L<dh_installdeb(1)> for an explanation of how
25 Files named debian/package.config and debian/package.templates are
26 installed into the DEBIAN directory in the package build directory.
28 Note that if you use debconf, your package probably needs to depend on it
29 (it will be added to ${misc:Depends} by this program).
31 =head1 LOCALIZED TEMPLATE FILES
33 Debconf also supports localized template files, and this program has some
34 support to aid working with them. It is best to keep the translations in
35 separate files, and merge them only at build time. See
36 L<debconf-mergetemplate(1)> and L<debconf-getlang(1)> for details.
38 This program will automatically call debconf-mergetemplate and merge
39 templates on the fly if it finds your template files are accompanied
40 by translated files that have the same name as the template file, with a
41 dot and a locale name prepended.
43 For example, if you have a German translation,
44 debian/package.templates.de is merged with debian/package.templates.
50 =item B<-n>, B<--noscripts>
52 Do not modify postrm script.
56 Pass the params to debconf-mergetemplate.
65 if (defined($dh{U_PARAMS})) {
66 @extraparams=@{$dh{U_PARAMS}};
69 foreach my $package (@{$dh{DOPACKAGES}}) {
70 my $tmp=tmpdir($package);
71 my $config=pkgfile($package,"config");
72 my $templates=pkgfile($package,"templates");
74 if (! -d "$tmp/DEBIAN") {
75 doit("install","-o",0,"-g",0,"-d","$tmp/DEBIAN");
79 doit("install", "-o", 0, "-g", 0, "-m", 755, "-p",
80 $config, "$tmp/DEBIAN/config");
83 if ($templates ne '') {
84 # Are there translated templates too?
85 my @trans=(glob("$templates.??"), glob("$templates.??_??"));
87 complex_doit("debconf-mergetemplate --drop-old-templates @extraparams @trans $templates > $tmp/DEBIAN/templates");
88 chmod 0644, "$tmp/DEBIAN/templates";
89 chown 0, 0, "$tmp/DEBIAN/templates";
92 doit("install", "-o", 0, "-g", 0, "-m", 644, "-p",
93 $templates, "$tmp/DEBIAN/templates");
97 if ($config ne '' || $templates ne '') {
98 # I'm going with debconf 0.5 because it was the first
100 addsubstvar($package, "misc:Depends", "debconf", ">= 0.5");
103 addsubstvar($package, "misc:Depends", "debconf", ">= 0.5", 1); # remove
106 if (($config ne '' || $templates ne '') && ! $dh{NOSCRIPTS}) {
107 autoscript($package,"postrm","postrm-debconf");
115 This program is a part of debhelper.
119 Joey Hess <joeyh@debian.org>