clarify

[debhelper.git] / dh_installdebconf

diff --git a/dh_installdebconf b/dh_installdebconf
index 8577214495fdc4bcd169c66cd5f09851045645ac..f12c7dad9d4e351e6d6515c7d037d69caf198846 100755 (executable)
--- a/dh_installdebconf
+++ b/dh_installdebconf
@@ -18,17 +18,18 @@ B<dh_installdebconf> [S<I<debhelper options>>] [B<-n>] [S<B<--> I<params>>]
 dh_installdebconf is a debhelper program that is responsible for installing
 files used by the debconf package into package build directories.
 
-It also automatically generates the postrm commands needed to
-interface with debconf. See L<dh_installdeb(1)> for an explanation of how
-that works.
+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<dh_installdeb(1)> 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.
-If a file named debian/package.script.debhelper exists, the contents
+If a file named debian/package.config.debhelper exists, the contents
 of that file are merged into the config script as follows: If the script 
 exists, then anywhere in it that "#DEBHELPER#" appears, the text of the 
 .debhelper file is inserted. If the script does not exist, then a script 
-is generated from the .debhelper file. The .debhelper filesmay be created 
+is generated from the .debhelper file. The .debhelper files may be created 
 by other debhelper programs, and are shell script fragments.
 
 Note that if you use debconf, your package probably needs to depend on it
@@ -41,20 +42,10 @@ do it right.
 
 =head1 LOCALIZED TEMPLATE FILES
 
-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<po2debconf(1)> and L<debconf-getlang(1)> for details.
-
-This program will look to see if you have a debian/po directory and if so will
-automatically call L<po2debconf(1)> to generate a merged templates file. Or 
-if you have debian/templates.ll files, it will use the older 
-L<debconf-mergetemplate(1)> program to merge those together.
-
-Note that if your package has a debian/po directory it should build-depend on po-debconf.
-
-For example, if you have a German translation,
-strings from debian/po/de.po are merged with debian/package.templates.
+This program will look to see if you have a debian/po directory and if so
+will automatically call L<po2debconf(1)> to generate a merged templates
+file containing the translations. For this to work, your package should
+build-depend on po-debconf.
 
 =head1 OPTIONS
 
@@ -66,8 +57,7 @@ Do not modify postrm script.
 
 =item B<--> I<params>
 
-Pass the params to po2debconf, if it is run or debconf-mergetemplate, if it
-is run.
+Pass the params to po2debconf.
 
 =back
 
@@ -95,22 +85,15 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
        
        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!";
+               }
 
                umask(0022); # since I do a redirect below
                
-               # Look for po directory.
                if (-d "debian/po") {
-                       if (@trans) {
-                               warning "ignoring debian/templates.ll files in favour of debian/po directory";
-                       }
                        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";
-               }
                else {
                        doit("install", "-o", 0, "-g", 0, "-m", 644, "-p",
                             $templates, "$tmp/DEBIAN/templates");
@@ -118,8 +101,8 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
        }
 
        # I'm going with debconf 0.5 because it was the first
-       # "modern" one.
-       my $debconfdep="debconf (>= 0.5) | debconf-2.0";
+       # "modern" one. udebs just need cdebconf.
+       my $debconfdep=is_udeb($package) ? "cdebconf-udeb" : "debconf (>= 0.5) | debconf-2.0";
        if ($config ne '' || $templates ne '') {
                addsubstvar($package, "misc:Depends", $debconfdep);
        }