X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_installdebconf;h=3e51f8eec537c419aa07e9db981f1efafcd0d7b4;hb=b18201805c64970a9a439637beee52b981160d8e;hp=b11ca7d8b8988929c320492b4b7606fc7e263539;hpb=c0d066ddce232280756df9c5b218c3c6145001bb;p=debhelper.git diff --git a/dh_installdebconf b/dh_installdebconf index b11ca7d..3e51f8e 100755 --- a/dh_installdebconf +++ b/dh_installdebconf @@ -16,39 +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). 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 postinst automatically as it it too hard to -do it right. +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 is working with them. It is best to keep the translations in -.po files under debian/po, and merge them only at build time. See -L and L for details. +=item debian/I.templates -This program will look to see if you have a debian/po directory and if so will -automatically call L to generate a merged templates file. Or -if you have debian/templates.ll files, it will use the older -L program to merge those together. +This is the debconf templates file, and is installed into the DEBIAN +directory in the package build directory. -Note that if your package has a debian/po directory it should build-depend on po-debconf. +=item debian/po/ -For example, if you have a German translation, -strings from debian/po/de.po are merged with debian/package.templates. +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 @@ -60,8 +68,7 @@ Do not modify postrm script. =item B<--> I -Pass the params to po2debconf, if it is run or debconf-mergetemplate, if it -is run. +Pass the params to po2debconf. =back @@ -83,28 +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 old-style translated templates? - my @trans=(glob("$templates.??"), glob("$templates.??_??")); + if (glob("$templates.??"), glob("$templates.??_??")) { + warning "Ignoring debian/templates.ll files. Switch to po-debconf!"; + } - # Look for po directory. + umask(0022); # since I do a redirect below + if (-d "debian/po") { - if (@trans) { - warning "ignoring debian/templates.ll files in favour of debian/po directory"; - } - else { - complex_doit("po2debconf @extraparams $templates > $tmp/DEBIAN/templates"); - } - } - elsif (@trans) { - complex_doit("debconf-mergetemplate --drop-old-templates @extraparams @trans $templates > $tmp/DEBIAN/templates"); - chmod 0644, "$tmp/DEBIAN/templates"; - chown 0, 0, "$tmp/DEBIAN/templates"; + complex_doit("po2debconf @extraparams $templates > $tmp/DEBIAN/templates"); } else { doit("install", "-o", 0, "-g", 0, "-m", 644, "-p", @@ -112,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}) { @@ -128,7 +125,7 @@ foreach my $package (@{$dh{DOPACKAGES}}) { =head1 SEE ALSO -L +L This program is a part of debhelper.