]> git.donarmstrong.com Git - debhelper.git/blobdiff - dh_installdeb
Updated French man page translation. Closes: #685560
[debhelper.git] / dh_installdeb
index fa45cd6f450118affd98b376f8d4687578370235..def76d16cbf1329952d3133c5cbe799c6490e51e 100755 (executable)
 #!/usr/bin/perl -w
-#
-# Install files from debian/ into the package's DEBIAN directory.
 
-BEGIN { push @INC, "debian", "/usr/share/debhelper" }
-use Dh_Lib;
+=head1 NAME
+
+dh_installdeb - install files into the DEBIAN directory
+
+=cut
+
+use strict;
+use Debian::Debhelper::Dh_Lib;
+
+=head1 SYNOPSIS
+
+B<dh_installdeb> [S<I<debhelper options>>]
+
+=head1 DESCRIPTION
+
+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.
+
+=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 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();
 
-foreach $PACKAGE (@{$dh{DOPACKAGES}}) {
-       $TMP=tmpdir($PACKAGE);
-       $EXT=pkgext($PACKAGE);
+# 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);
 
-       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");
        }
 
-       # Install debian install scripts.
-       # If any .debhelper files exist, add them into the scripts.
-       foreach $file (qw{postinst preinst prerm postrm config}) {
-               $f=pkgfile($PACKAGE,$file);
-               if ($f) {
-                       if (-f "debian/$EXT$file.debhelper") {
-                               # Add this into the script, where it has
-                               # #DEBHELPER#
-                               # TODO: do internally, no perl fork?
-                               complex_doit("perl -pe 's~#DEBHELPER#~qx{cat debian/$EXT$file.debhelper}~eg' < $f > $TMP/DEBIAN/$file");
-                       }
-                       else {
-                               # Just get rid of any #DEBHELPER# in the 
-                               # script.
-                               complex_doit("sed s/#DEBHELPER#// < $f > $TMP/DEBIAN/$file");
+       if (is_udeb($package)) {
+               # For udebs, only do the postinst, and no #DEBHELPER#.
+               # 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");
                        }
-                       doit("chown","root.root","$TMP/DEBIAN/$file");
-                       doit("chmod",755,"$TMP/DEBIAN/$file");
                }
-               else {
-                       # Auto-generate script header and add .debhelper
-                       # content to it.
-                       if (-f "debian/$EXT$file.debhelper") {
-                               complex_doit("echo '#!/bin/sh -e' > $TMP/DEBIAN/$file");
-                               complex_doit("cat debian/$EXT$file.debhelper >> $TMP/DEBIAN/$file");
-                               doit("chown","root.root","$TMP/DEBIAN/$file");
-                               doit("chmod",755,"$TMP/DEBIAN/$file");
+               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);
+       }
+
+       if (! is_udeb($package)) {
+               # Install non-executable files
+               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");
                        }
                }
        }
 
-       # Install non-executable files
-       foreach $file (qw{shlibs conffiles templates}) {
-               $f=pkgfile($PACKAGE,$file);
-               if ($f) {
-                       doit("install","-o","root","-g","root","-m",644,"-p",$f,"$TMP/DEBIAN/$file");
+       # Automatic conffiles registration: If it is in /etc, it is a
+       # conffile.
+       if (! compat(2) && -d "$tmp/etc" && ! is_udeb($package)) {
+               complex_doit("find $tmp/etc -type f -printf '/etc/%P\n' >> $tmp/DEBIAN/conffiles");
+               # Anything found?
+               if (-z "$tmp/DEBIAN/conffiles") {
+                       doit("rm", "-f", "$tmp/DEBIAN/conffiles");
+               }
+               else {
+                       doit("chmod", 644, "$tmp/DEBIAN/conffiles");
                }
        }
 }
+
+=head1 SEE ALSO
+
+L<debhelper(7)>
+
+This program is a part of debhelper.
+
+=head1 AUTHOR
+
+Joey Hess <joeyh@debian.org>
+
+=cut