X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_gencontrol;h=ae8605a6c7d30160db647717191546381d228c3a;hb=23e53946b769999c40d402cc444b7013d3bfa880;hp=df53a753e3d86d9a810f741d8c68da61d8b53cd5;hpb=67b74298f08a3e2b30e43cbcd7cdaccc2e1b1614;p=debhelper.git

diff --git a/dh_gencontrol b/dh_gencontrol
index df53a75..ae8605a 100755
--- a/dh_gencontrol
+++ b/dh_gencontrol
@@ -1,30 +1,76 @@
 #!/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;
+
+=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)>, which calls
+it once for each package being acted on, and passes in some additional
+useful flags including "-isp". 
+
+=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 $PACKAGE (@{$dh{DOPACKAGES}}) {
-	$TMP=tmpdir($PACKAGE);
-	$EXT=pkgext($PACKAGE);
+foreach my $package (@{$dh{DOPACKAGES}}) {
+	my $tmp=tmpdir($package);
+	my $ext=pkgext($package);
 	
-	$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");
 	}
 
 	# Generate and install control file.
-	doit("dpkg-gencontrol","-l$changelog","-isp","-p$PACKAGE",
-		"-Tdebian/$EXT\substvars","-P$TMP",@{$dh{U_PARAMS}});
+	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");
+	# 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(1)>
+
+This program is a part of debhelper.
+
+=head1 AUTHOR
+
+Joey Hess <joeyh@debian.org>
+
+=cut