X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_installdeb;h=def76d16cbf1329952d3133c5cbe799c6490e51e;hb=18a0da8092ea9f3dc48bca92b36f592af25a608d;hp=a3cd68ff2595724cfb0768a893b0261950fcfa3d;hpb=d2cd503a555850a98ea54c050fd583cf6c49d004;p=debhelper.git

diff --git a/dh_installdeb b/dh_installdeb
index a3cd68f..def76d1 100755
--- a/dh_installdeb
+++ b/dh_installdeb
@@ -15,35 +15,67 @@ B<dh_installdeb> [S<I<debhelper options>>]
 
 =head1 DESCRIPTION
 
-dh_installdeb is a debhelper program that is responsible for installing
-files into the DEBIAN directories in package build directories with the
+B<dh_installdeb> is a debhelper program that is responsible for installing
+files into the F<DEBIAN> directories in package build directories with the
 correct permissions.
 
-dh_installdeb automatically installs the following files from debian/ into
-the DEBIAN directory:
-  package.postinst
-  package.preinst
-  package.postrm
-  package.prerm
-  package.shlibs
-  package.conffiles
-
-The postinst, preinst, postrm, and prerm are handled specially: If a
-corresponding file named debian/package.script.debhelper exists, the contents
-of that file are merged into the 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 files are created by other debhelper
-programs, such as L<dh_installmenu(1)>, and are shell script fragments.
-
-In V3 compatibility mode and higher, all files in the etc/ directory in a
+=head1 FILES
+
+=over 4
+
+=item I<package>.postinst
+
+=item I<package>.preinst
+
+=item I<package>.postrm
+
+=item I<package>.prerm
+
+These maintainer scripts are installed into the F<DEBIAN> directory.
+
+Inside the scripts, the token B<#DEBHELPER#> is replaced with
+shell script snippets generated by other debhelper commands.
+
+=item I<package>.triggers
+
+=item I<package>.shlibs
+
+These control files are installed into the F<DEBIAN> directory.
+
+=item I<package>.conffiles
+
+This control file will be installed into the F<DEBIAN> directory.
+
+In v3 compatibility mode and higher, all files in the F<etc/> directory in a
 package will automatically be flagged as conffiles by this program, so
-there is no need to list them manually in package.conffiles.
+there is no need to list them manually here.
+
+=item I<package>.maintscript
+
+Lines in this file correspond to L<dpkg-maintscript-helper(1)> commands and
+parameters.  Any shell metacharacters will be escaped, so arbitrary shell
+code cannot be inserted here.  For example, a line such as C<mv_conffile
+/etc/oldconffile /etc/newconffile> will insert maintainer script snippets
+into all maintainer scripts sufficient to move that conffile.
+
+A versioned Pre-Dependency on dpkg is needed to use
+L<dpkg-maintscript-helper(1)>. An appropriate Pre-Dependency is
+set in ${misc:Pre-Depends} ; you should make sure to put that token into
+an appropriate place in your debian/control file.
+
+=back
 
 =cut
 
 init();
 
+# dpkg-maintscript-helper commands with their associated dpkg pre-dependency
+# versions.
+my %maintscript_predeps = (
+	"rm_conffile" => "1.15.7.2",
+	"mv_conffile" => "1.15.7.2",
+);
+
 foreach my $package (@{$dh{DOPACKAGES}}) {
 	my $tmp=tmpdir($package);
 
@@ -53,14 +85,33 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
 
 	if (is_udeb($package)) {
 		# For udebs, only do the postinst, and no #DEBHELPER#.
-		my $f=pkgfile($package,"postinst");
-		if ($f) {
-			doit("install", "-o", 0, "-g", 0, "-m", 755, 
-			     $f, "$tmp/DEBIAN/postinst");
+		# Udebs also support menutest and isinstallable scripts.
+		foreach my $script (qw{postinst menutest isinstallable}) {
+			my $f=pkgfile($package,$script);
+			if ($f) {
+				doit("install", "-o", 0, "-g", 0, "-m", 755, 
+				     $f, "$tmp/DEBIAN/$script");
+			}
 		}
 		next;		
 	}
 	
+	my $maintscriptfile=pkgfile($package, "maintscript");
+	if ($maintscriptfile) {
+		foreach my $line (filedoublearray($maintscriptfile)) {
+			my $cmd=$line->[0];
+			error("unknown dpkg-maintscript-helper command: $cmd")
+				unless exists $maintscript_predeps{$cmd};
+			addsubstvar($package, "misc:Pre-Depends", "dpkg",
+				    ">= $maintscript_predeps{$cmd}");
+			my $params=escape_shell(@$line);
+			foreach my $script (qw{postinst preinst prerm postrm}) {
+				autoscript($package, $script, "maintscript-helper",
+					   "s!#PARAMS#!$params!g");
+			}
+		}
+	}
+
 	# Install debian scripts.
 	foreach my $script (qw{postinst preinst prerm postrm}) {
 		debhelper_script_subst($package, $script);
@@ -68,7 +119,7 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
 
 	if (! is_udeb($package)) {
 		# Install non-executable files
-		foreach my $file (qw{shlibs conffiles}) {
+		foreach my $file (qw{shlibs conffiles triggers}) {
 			my $f=pkgfile($package,$file);
 			if ($f) {
 				doit("install","-o",0,"-g",0,"-m",644,"-p",$f,"$tmp/DEBIAN/$file");