X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_installdebconf;h=0d83eea0be70e15734b8b0fbcab8b3fe0cf7ad36;hb=96050cc65968bb2e0a2112247a618443483f73b2;hp=82d69d017d49de67a7cf34ceb7d2a335eafb8c8e;hpb=3ee57edb39dd43b944d74fc1a17e526080e3518a;p=debhelper.git

diff --git a/dh_installdebconf b/dh_installdebconf
index 82d69d0..0d83eea 100755
--- a/dh_installdebconf
+++ b/dh_installdebconf
@@ -1,39 +1,121 @@
 #!/usr/bin/perl -w
-#
-# Integration with debconf.
 
+=head1 NAME
+
+dh_installdebconf - install files used by debconf in package build directories
+
+=cut
+
+use strict;
 use Debian::Debhelper::Dh_Lib;
+
+=head1 SYNOPSIS
+
+B<dh_installdebconf> [S<I<debhelper options>>] [B<-n>] [S<B<--> I<params>>]
+
+=head1 DESCRIPTION
+
+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.
+
+Files named debian/package.config and debian/package.templates are
+installed into the DEBIAN directory in the package build directory.
+
+Note that if you use debconf, your package probably needs to depend on it
+(it will be added to ${misc:Depends by this program).
+
+=head1 LOCALIZED TEMPLATE FILES
+
+Debconf also supports localized template files, and this program has some
+support to aid working with them. It is best to keep the translations in
+separate files, and merge them only at build time. See 
+L<debconf-mergetemplate(1)> and L<debconf-getlang(1)> for details.
+
+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 prepended.
+
+For example, if you have a German translation,
+debian/package.templates.de is merged with debian/package.templates.
+
+=head1 OPTIONS
+
+=over 4
+
+=item B<-n>, B<--noscripts>
+
+Do not modify postrm script.
+
+=item B<--> I<params>
+
+Pass the params to debconf-mergetemplate.
+
+=back
+
+=cut
+
 init();
 
-foreach $PACKAGE (@{$dh{DOPACKAGES}}) {
-	$TMP=tmpdir($PACKAGE);
-	$config=pkgfile($PACKAGE,"config");
-	$templates=pkgfile($PACKAGE,"templates");
+my @extraparams;
+if (defined($dh{U_PARAMS})) {
+	@extraparams=@{$dh{U_PARAMS}};
+}
+
+foreach my $package (@{$dh{DOPACKAGES}}) {
+	my $tmp=tmpdir($package);
+	my $config=pkgfile($package,"config");
+	my $templates=pkgfile($package,"templates");
 
-	if (! -d "$TMP/DEBIAN") {
-		doit("install","-o","root","-g","root","-d","$TMP/DEBIAN");
+	if (! -d "$tmp/DEBIAN") {
+		doit("install","-o",0,"-g",0,"-d","$tmp/DEBIAN");
 	}
 
 	if ($config ne '') {
-		doit("install", "-o", "root", "-g", "root", "-m", 755, "-p",
-		     $config, "$TMP/DEBIAN/config");
+		doit("install", "-o", 0, "-g", 0, "-m", 755, "-p",
+		     $config, "$tmp/DEBIAN/config");
 	}
 	
 	if ($templates ne '') {
 		# Are there translated templates too?
-		my @trans=glob("$templates.??");
+		my @trans=(glob("$templates.??"), glob("$templates.??_??"));
 		if (@trans) {
-			complex_doit("debconf-mergetemplate @trans $templates > $TMP/DEBIAN/templates");
-			chmod 0644, "$TMP/DEBIAN/templates";
-			chown 0, 0, "$TMP/DEBIAN/templates";
+			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", "root", "-g", "root", "-m", 644, "-p",
-			     $templates, "$TMP/DEBIAN/templates");
+			doit("install", "-o", 0, "-g", 0, "-m", 644, "-p",
+			     $templates, "$tmp/DEBIAN/templates");
 		}
 	}
 
-	if (($config ne ''|| $templates ne '') && ! $dh{NOSCRIPTS}) {
-		autoscript($PACKAGE,"postrm","postrm-debconf");
+	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
+	}
+	
+	if (($config ne '' || $templates ne '') && ! $dh{NOSCRIPTS}) {
+		autoscript($package,"postrm","postrm-debconf");
 	}
 }
+
+=head1 SEE ALSO
+
+L<debhelper(1)>
+
+This program is a part of debhelper.
+
+=head1 AUTHOR
+
+Joey Hess <joeyh@debian.org>
+
+=cut