X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_installdebconf;h=5a20ed79c402c76cfe44a0fd539c2785772fd39d;hb=e2a6d4cec4a7ee952cf6a7f250d80f1d75a38f95;hp=b11ca7d8b8988929c320492b4b7606fc7e263539;hpb=c0d066ddce232280756df9c5b218c3c6145001bb;p=debhelper.git diff --git a/dh_installdebconf b/dh_installdebconf index b11ca7d..5a20ed7 100755 --- a/dh_installdebconf +++ b/dh_installdebconf @@ -15,40 +15,48 @@ 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. +B is a debhelper program that is responsible for installing +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 F commands needed to interface +with debconf. The commands are added to the maintainer scripts by +B. 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 B<${misc:Depends}> by this program). + +Note that for your config script to be called by B, your F +needs to source debconf's confmodule. B does not +install this statement into the F automatically as it is too +hard to do it right. + +=head1 FILES + +=over 4 + +=item debian/I.config -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. +This is the debconf F script, and is installed into the F +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 F file, and is installed into the F +directory in the package build directory. -Note that if your package has a debian/po directory it should build-depend on po-debconf. +=item F -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 F. + +=back =head1 OPTIONS @@ -56,12 +64,11 @@ strings from debian/po/de.po are merged with debian/package.templates. =item B<-n>, B<--noscripts> -Do not modify postrm script. +Do not modify F script. =item B<--> I -Pass the params to po2debconf, if it is run or debconf-mergetemplate, if it -is run. +Pass the params to B. =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.