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 Note that for your config script to be called by dpkg, your postinst
32 needs to source debconf's confmodule. dh_installdebconf does not
33 install this statement into postinst automatically as it it too hard to
36 =head1 LOCALIZED TEMPLATE FILES
38 Debconf also supports localized template files, and this program has some
39 support to aid is working with them. It is best to keep the translations in
40 .po files under debian/po, and merge them only at build time. See
41 L<po2debconf(1)> and L<debconf-getlang(1)> for details.
43 This program will look to see if you have a debian/po directory and if so will
44 automatically call L<po2debconf(1)> to generate a merged templates file. Or
45 if you have debian/templates.ll files, it will use the older
46 L<debconf-mergetemplate(1)> program to merge those together.
48 Note that if your package has a debian/po directory it should build-depend on po-debconf.
50 For example, if you have a German translation,
51 strings from debian/po/de.po are merged with debian/package.templates.
57 =item B<-n>, B<--noscripts>
59 Do not modify postrm script.
63 Pass the params to po2debconf, if it is run or debconf-mergetemplate, if it
73 if (defined($dh{U_PARAMS})) {
74 @extraparams=@{$dh{U_PARAMS}};
77 foreach my $package (@{$dh{DOPACKAGES}}) {
78 my $tmp=tmpdir($package);
79 my $config=pkgfile($package,"config");
80 my $templates=pkgfile($package,"templates");
82 if (! -d "$tmp/DEBIAN") {
83 doit("install","-o",0,"-g",0,"-d","$tmp/DEBIAN");
86 if (! is_udeb($package) && $config ne '') {
87 doit("install", "-o", 0, "-g", 0, "-m", 755, "-p",
88 $config, "$tmp/DEBIAN/config");
91 if ($templates ne '') {
92 # Are there old-style translated templates?
93 my @trans=(glob("$templates.??"), glob("$templates.??_??"));
95 umask(0022); # since I do a redirect below
97 # Look for po directory.
100 warning "ignoring debian/templates.ll files in favour of debian/po directory";
102 complex_doit("po2debconf @extraparams $templates > $tmp/DEBIAN/templates");
105 complex_doit("debconf-mergetemplate --drop-old-templates @extraparams @trans $templates > $tmp/DEBIAN/templates");
106 chmod 0644, "$tmp/DEBIAN/templates";
107 chown 0, 0, "$tmp/DEBIAN/templates";
110 doit("install", "-o", 0, "-g", 0, "-m", 644, "-p",
111 $templates, "$tmp/DEBIAN/templates");
115 # I'm going with debconf 0.5 because it was the first
117 my $debconfdep="debconf (>= 0.5) | debconf-2.0";
118 if ($config ne '' || $templates ne '') {
119 addsubstvar($package, "misc:Depends", $debconfdep);
122 addsubstvar($package, "misc:Depends", $debconfdep, undef, 1); # remove
125 if (($config ne '' || $templates ne '') && ! $dh{NOSCRIPTS}) {
126 autoscript($package,"postrm","postrm-debconf");
134 This program is a part of debhelper.
138 Joey Hess <joeyh@debian.org>