r427: converting to pod is getting old..

[debhelper.git] / dh_gencontrol

diff --git a/dh_gencontrol b/dh_gencontrol
index e2a4e701b223cb689d050ba8ae7605a38794d636..0c8c88a29180379861222eb3ca4eca21eaffbeaa 100755 (executable)
--- a/dh_gencontrol
+++ b/dh_gencontrol
@@ -1,19 +1,72 @@
-#!/bin/sh -e
-#
-# Generate and install the control file. Simple dpkg-gencontrol wrapper.
+#!/usr/bin/perl -w
 
-PATH=debian:$PATH:/usr/lib/debhelper
-. dh_lib
+=head1 NAME
 
-for PACKAGE in $DH_DOPACKAGES; do
-       TMP=`tmpdir $PACKAGE`
-       EXT=`pkgext $PACKAGE`
+dh_gencontrol - generate and install control file
 
-       if [ ! -d $TMP/DEBIAN ]; then
-               doit "install -o root -g root -d $TMP/DEBIAN"
-       fi
+=cut
+
+use strict;
+use Debian::Debhelper::Dh_Lib;
+
+=head1 SYNOPSIS
+
+  dh_gencontrol [debhelper options] [-uparams] [-- params]
+
+=head1 DESCRIPTION
+
+dh_gencontrol is a debhelper program that is responsible for generating
+control files, and installing them into the DEBIAN directory with the
+proper permissions.
+
+This program is merely a wrapper around L<dpkg-gencontrol(1)>.
+
+=head1 OPTIONS
+
+=over 4
+
+=item B<-u>I<params>, B<--dpkg-gencontrol-params>I<params>
+=item B<--> I<params>
+
+Pass "params" to L<dpkg-gencontrol(1)>.
+
+=back
+
+=cut
+
+init();
+
+foreach my $package (@{$dh{DOPACKAGES}}) {
+       my $tmp=tmpdir($package);
+       my $ext=pkgext($package);
+       
+       my $changelog=pkgfile($package,'changelog');
+       if (! $changelog) {
+               $changelog='debian/changelog';
+       }
+
+       if ( ! -d "$tmp/DEBIAN" ) {
+               doit("install","-o",0,"-g",0,"-d","$tmp/DEBIAN");
+       }
 
        # Generate and install control file.
-       doit "dpkg-gencontrol -p$PACKAGE -Tdebian/${EXT}substvars -P$TMP $DH_U_PARAMS"
-       doit "chown root.root $TMP/DEBIAN/control"
-done
+       doit("dpkg-gencontrol","-l$changelog","-isp","-p$package",
+               "-Tdebian/${ext}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");
+       
+       doit("chown","0.0","$tmp/DEBIAN/control");
+}
+
+=head1 SEE ALSO
+
+L<debhelper(1)>
+
+This program is a part of debhelper.
+
+=head1 AUTHOR
+
+Joey Hess <joeyh@debian.org>
+
+=cut