X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_installdebconf;h=3e51f8eec537c419aa07e9db981f1efafcd0d7b4;hb=5cee909d876bacad4f3d0e092d69fe0bfee6e083;hp=2b6bdc70a4050e02275e96249fb30ab7c7a103f6;hpb=fae5806aeb1a5e7b40a9c149a739f645395e5139;p=debhelper.git diff --git a/dh_installdebconf b/dh_installdebconf index 2b6bdc7..3e51f8e 100755 --- a/dh_installdebconf +++ b/dh_installdebconf @@ -16,32 +16,47 @@ B [S>] [B<-n>] [S I>] =head1 DESCRIPTION dh_installdebconf is a debhelper program that is responsible for installing -files used by the debconf package into package build directories. +files used by debconf into package build directories. -It also automatically generates the postrm commands needed to -interface with debconf. See L for an explanation of how -that works. - -Files named debian/package.config and debian/package.templates are -installed into the DEBIAN directory in the package build directory. +It also automatically generates the postrm commands needed to interface +with debconf. The commands are added to the maintainer scripts by +dh_installdeb. See L for an explanation of how that +works. Note that if you use debconf, your package probably needs to depend on it -(it will be added to ${misc:Depends by this program). +(it will be added to ${misc:Depends} by this program). + +Note that for your config script to be called by dpkg, your postinst +needs to source debconf's confmodule. dh_installdebconf does not +install this statement into the postinst automatically as it it too +hard to do it right. + +=head1 FILES + +=over 4 + +=item debian/I.config + +This is the debconf config script, and is installed into the DEBIAN +directory in the package build directory. -=head1 LOCALIZED TEMPLATE FILES +Inside the script, the token B<#DEBHELPER#> is replaced with +shell script snippets generated by other debhelper commands. -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 -L and L for details. +=item debian/I.templates -This program will automatically call debconf-mergetemplate and merge -templates on the fly if it finds your template files are accompanied -by translated files that have the same name as the template file, with a -dot and a locale name repended. +This is the debconf templates file, and is installed into the DEBIAN +directory in the package build directory. -For example, if you have a German translation, -debian/package.templates.de is merged with debian/package.templates. +=item debian/po/ + +If this directory is present, this program will automatically use +L to generate merged templates +files that include the translations from there. + +For this to work, your package should build-depend on po-debconf. + +=back =head1 OPTIONS @@ -53,7 +68,7 @@ Do not modify postrm script. =item B<--> I -Pass the params to debconf-mergetemplate. +Pass the params to po2debconf. =back @@ -75,18 +90,20 @@ foreach my $package (@{$dh{DOPACKAGES}}) { doit("install","-o",0,"-g",0,"-d","$tmp/DEBIAN"); } - if ($config ne '') { - doit("install", "-o", 0, "-g", 0, "-m", 755, "-p", - $config, "$tmp/DEBIAN/config"); + if (! is_udeb($package)) { + debhelper_script_subst($package, "config"); } if ($templates ne '') { - # Are there translated templates too? - my @trans=(glob("$templates.??"), glob("$templates.??_??")); - if (@trans) { - complex_doit("debconf-mergetemplate @extraparams @trans $templates > $tmp/DEBIAN/templates"); - chmod 0644, "$tmp/DEBIAN/templates"; - chown 0, 0, "$tmp/DEBIAN/templates"; + # Are there old-style translated templates? + if (glob("$templates.??"), glob("$templates.??_??")) { + warning "Ignoring debian/templates.ll files. Switch to po-debconf!"; + } + + umask(0022); # since I do a redirect below + + if (-d "debian/po") { + complex_doit("po2debconf @extraparams $templates > $tmp/DEBIAN/templates"); } else { doit("install", "-o", 0, "-g", 0, "-m", 644, "-p", @@ -94,13 +111,11 @@ foreach my $package (@{$dh{DOPACKAGES}}) { } } + # I'm going with debconf 0.5 because it was the first + # "modern" one. udebs just need cdebconf. + my $debconfdep=is_udeb($package) ? "cdebconf-udeb" : "debconf (>= 0.5) | debconf-2.0"; if ($config ne '' || $templates ne '') { - # I'm going with debconf 0.5 because it was the first - # "modern" one. - addsubstvar($package, "misc:Depends", "debconf", ">= 0.5"); - } - else { - addsubstvar($package, "misc:Depends", "debconf", ">= 0.5", 1); # remove + addsubstvar($package, "misc:Depends", $debconfdep); } if (($config ne '' || $templates ne '') && ! $dh{NOSCRIPTS}) { @@ -110,7 +125,7 @@ foreach my $package (@{$dh{DOPACKAGES}}) { =head1 SEE ALSO -L +L This program is a part of debhelper.