Updated French man page translation. Closes: #685560

[debhelper.git] / dh_gencontrol

diff --git a/dh_gencontrol b/dh_gencontrol
index df53a753e3d86d9a810f741d8c68da61d8b53cd5..32b85637f5f066d10d8d2b735a7fde841dca701b 100755 (executable)
--- a/dh_gencontrol
+++ b/dh_gencontrol
@@ -1,30 +1,92 @@
 #!/usr/bin/perl -w
-#
-# Generate and install the control file. Simple dpkg-gencontrol wrapper.
 
+=head1 NAME
+
+dh_gencontrol - generate and install control file
+
+=cut
+
+use strict;
 use Debian::Debhelper::Dh_Lib;
-init();
 
-foreach $PACKAGE (@{$dh{DOPACKAGES}}) {
-       $TMP=tmpdir($PACKAGE);
-       $EXT=pkgext($PACKAGE);
+=head1 SYNOPSIS
+
+B<dh_gencontrol> [S<I<debhelper options>>] [S<B<--> I<params>>]
+
+=head1 DESCRIPTION
+
+B<dh_gencontrol> is a debhelper program that is responsible for generating
+control files, and installing them into the I<DEBIAN> directory with the
+proper permissions.
+
+This program is merely a wrapper around L<dpkg-gencontrol(1)>, which calls
+it once for each package being acted on, and passes in some additional
+useful flags.
+
+=head1 OPTIONS
+
+=over 4
+
+=item B<--> I<params>
+
+Pass I<params> to L<dpkg-gencontrol(1)>.
+
+=item B<-u>I<params>, B<--dpkg-gencontrol-params=>I<params>
+
+This is another way to pass I<params> to L<dpkg-gencontrol(1)>.
+It is deprecated; use B<--> instead.
+
+=back
+
+=cut
+
+init(options => {
+       "dpkg-gencontrol-params=s", => \$dh{U_PARAMS},
+});
+
+foreach my $package (@{$dh{DOPACKAGES}}) {
+       my $tmp=tmpdir($package);
+       my $ext=pkgext($package);
+
+       my $substvars="debian/${ext}substvars";
        
-       $changelog=pkgfile($PACKAGE,'changelog');
+       my $changelog=pkgfile($package,'changelog');
        if (! $changelog) {
                $changelog='debian/changelog';
        }
 
-       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");
        }
 
+       # avoid gratuitous warning
+       if (! -e $substvars || system("grep -q '^misc:Depends=' $substvars") != 0) {
+               complex_doit("echo misc:Depends= >> $substvars");
+       }
+       
        # Generate and install control file.
-       doit("dpkg-gencontrol","-l$changelog","-isp","-p$PACKAGE",
-               "-Tdebian/$EXT\substvars","-P$TMP",@{$dh{U_PARAMS}});
+       my @command="dpkg-gencontrol";
+       if (getpackages() > 1) {
+               push @command, "-p$package";
+       }
+       doit(@command, "-l$changelog", "-T$substvars", 
+               "-P$tmp",@{$dh{U_PARAMS}});
 
-       # This chmod is only necessary if the user sets the umask to something odd.
-       doit("chmod","644","$TMP/DEBIAN/control");
+       # This chmod is only necessary if the user sets the umask to
+       # something odd.
+       doit("chmod","644","$tmp/DEBIAN/control");
        
-       doit("chown","root.root","$TMP/DEBIAN/control");
+       doit("chown","0:0","$tmp/DEBIAN/control");
 }
 
+=head1 SEE ALSO
+
+L<debhelper(7)>
+
+This program is a part of debhelper.
+
+=head1 AUTHOR
+
+Joey Hess <joeyh@debian.org>
+
+=cut