X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_installdebconf;h=5a20ed79c402c76cfe44a0fd539c2785772fd39d;hb=fb8f18f4a98669c3b85e1bd7920fbabfc00b886e;hp=2b6bdc70a4050e02275e96249fb30ab7c7a103f6;hpb=fae5806aeb1a5e7b40a9c149a739f645395e5139;p=debhelper.git

diff --git a/dh_installdebconf b/dh_installdebconf
index 2b6bdc7..5a20ed7 100755
--- a/dh_installdebconf
+++ b/dh_installdebconf
@@ -15,33 +15,48 @@ 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.
+B<dh_installdebconf> 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<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.
+It also automatically generates the F<postrm> commands needed to interface
+with debconf. The commands are added to the maintainer scripts by
+B<dh_installdeb>. See L<dh_installdeb(1)> 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<dpkg>, your F<postinst>
+needs to source debconf's confmodule. B<dh_installdebconf> does not
+install this statement into the F<postinst> automatically as it is too
+hard to do it right.
+
+=head1 FILES
+
+=over 4
+
+=item debian/I<package>.config
+
+This is the debconf F<config> script, and is installed into the F<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<debconf-mergetemplate(1)> and L<debconf-getlang(1)> for details.
+=item debian/I<package>.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 F<templates> file, and is installed into the F<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 F<debian/po/>
+
+If this directory is present, this program will automatically use
+L<po2debconf(1)> to generate merged templates
+files that include the translations from there.
+
+For this to work, your package should build-depend on F<po-debconf>.
+
+=back
 
 =head1 OPTIONS
 
@@ -49,11 +64,11 @@ debian/package.templates.de is merged with debian/package.templates.
 
 =item B<-n>, B<--noscripts>
 
-Do not modify postrm script.
+Do not modify F<postrm> script.
 
 =item B<--> I<params>
 
-Pass the params to debconf-mergetemplate.
+Pass the params to B<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<debhelper(1)>
+L<debhelper(7)>
 
 This program is a part of debhelper.