r576: * Rename debhelper.1 to debhelper.7.

[debhelper.git] / dh_installcron

diff --git a/dh_installcron b/dh_installcron
index 149c3d91bbe8f020f4f35deb79437286c00833f5..d28277c57e52565e47f87aab97d2af2500b3aaa2 100755 (executable)
--- a/dh_installcron
+++ b/dh_installcron
@@ -1,27 +1,58 @@
 #!/usr/bin/perl -w
-#
-# Install cron scripts into the appropriate places.
 
+=head1 NAME
+
+dh_installcron - install cron scripts into etc/cron.*
+
+=cut
+
+use strict;
 use Debian::Debhelper::Dh_Lib;
+
+=head1 SYNOPSIS
+
+B<dh_installcron> [S<B<debhelper options>>]
+
+=head1 DESCRIPTION
+
+dh_installcron is a debhelper program that is responsible for installing
+cron scripts into etc/cron.*/ in package build directories. The files
+debian/package.cron.daily, debian/package.cron.weekly,
+debian/package.cron.monthly, and debian/package.cron.d are installed.
+
+=cut
+
 init();
 
-foreach $PACKAGE (@{$dh{DOPACKAGES}}) {
-       $TMP=tmpdir($PACKAGE);
-       foreach $type (qw{daily weekly monthly}) {
-               $cron=pkgfile($PACKAGE,"cron.$type");
+foreach my $package (@{$dh{DOPACKAGES}}) {
+       my $tmp=tmpdir($package);
+       foreach my $type (qw{daily weekly monthly}) {
+               my $cron=pkgfile($package,"cron.$type");
                if ($cron) {
-                       if (! -d "$TMP/etc/cron.$type") {
-                               doit("install","-o","root","-g","root","-d","$TMP/etc/cron.$type");
+                       if (! -d "$tmp/etc/cron.$type") {
+                               doit("install","-o",0,"-g",0,"-d","$tmp/etc/cron.$type");
                        }
-                       doit("install",$cron,"$TMP/etc/cron.$type/$PACKAGE");
+                       doit("install",$cron,"$tmp/etc/cron.$type/$package");
                }
        }
        # Seperate because this needs to be mode 644.
-       $cron=pkgfile($PACKAGE,"cron.d");
+       my $cron=pkgfile($package,"cron.d");
        if ($cron) {
-               if (! -d "$TMP/etc/cron.d") {
-                       doit("install","-o","root","-g","root","-d","$TMP/etc/cron.d");
+               if (! -d "$tmp/etc/cron.d") {
+                       doit("install","-o",0,"-g",0,"-d","$tmp/etc/cron.d");
                }       
-               doit("install","-m",644,$cron,"$TMP/etc/cron.d/$PACKAGE");
+               doit("install","-m",644,$cron,"$tmp/etc/cron.d/$package");
        }
 }
+
+=head1 SEE ALSO
+
+L<debhelper(7)>
+
+This program is a part of debhelper.
+
+=head1 AUTHOR
+
+Joey Hess <joeyh@debian.org>
+
+=cut