X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_installpam;h=c7073863a7f3301dbe5a21051d264b6546376403;hb=764e525d1625fc2b68a4eb225a5e9b09fec3bbd9;hp=72f8d7ddd6f22877364e68b704579ec6e2ad67f3;hpb=67b74298f08a3e2b30e43cbcd7cdaccc2e1b1614;p=debhelper.git

diff --git a/dh_installpam b/dh_installpam
index 72f8d7d..c707386 100755
--- a/dh_installpam
+++ b/dh_installpam
@@ -1,20 +1,69 @@
 #!/usr/bin/perl -w
-#
-# Integration with debian pam system:
-#
-# If debian/pam file exists, save it to $TMP/etc/pam.d/$PACKAGE
 
+=head1 NAME
+
+dh_installpam - install pam support files
+
+=cut
+
+use strict;
 use Debian::Debhelper::Dh_Lib;
+
+=head1 SYNOPSIS
+
+B<dh_installpam> [S<I<debhelper options>>] [B<--name=>I<name>]
+
+=head1 DESCRIPTION
+
+B<dh_installpam> is a debhelper program that is responsible for installing
+files used by PAM into package build directories.
+
+=head1 FILES
+
+=over 4
+
+=item debian/I<package>.pam
+
+Installed into etc/pam.d/I<package> in the package build directory.
+
+=back
+
+=head1 OPTIONS
+
+=over 4
+
+=item B<--name=>I<name>
+
+Look for files named debian/I<package>.I<name>.pam and install them as
+etc/pam.d/I<name>, instead of using the usual files and installing them
+using the package name.
+
+=back
+
+=cut
+
 init();
 
-foreach $PACKAGE (@{$dh{DOPACKAGES}}) {
-	$TMP=tmpdir($PACKAGE);
-	$pam=pkgfile($PACKAGE,"pam");
+foreach my $package (@{$dh{DOPACKAGES}}) {
+	my $tmp=tmpdir($package);
+	my $pam=pkgfile($package,"pam");
 	
 	if ($pam ne '') {
-		if (! -d "$TMP/etc/pam.d") {
-			doit("install","-d","$TMP/etc/pam.d");
+		if (! -d "$tmp/etc/pam.d") {
+			doit("install","-d","$tmp/etc/pam.d");
 		}
-		doit("install","-p","-m644",$pam,"$TMP/etc/pam.d/$PACKAGE");
+		doit("install","-p","-m644",$pam,"$tmp/etc/pam.d/".pkgfilename($package));
 	}
 }
+
+=head1 SEE ALSO
+
+L<debhelper(7)>
+
+This program is a part of debhelper.
+
+=head1 AUTHOR
+
+Joey Hess <joeyh@debian.org>
+
+=cut