X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_installpam;h=c7073863a7f3301dbe5a21051d264b6546376403;hb=e2a6d4cec4a7ee952cf6a7f250d80f1d75a38f95;hp=2262d810fe67251af704a47f8cca2c5b03c6e166;hpb=430dd853a0827cf0419d2531cf163d4c1e19c4f9;p=debhelper.git

diff --git a/dh_installpam b/dh_installpam
index 2262d81..c707386 100755
--- a/dh_installpam
+++ b/dh_installpam
@@ -1,21 +1,69 @@
 #!/usr/bin/perl -w
-#
-# Integration with debian pam system:
-#
-# If debian/pam file exists, save it to $TMP/etc/pam.d/$PACKAGE
 
-BEGIN { push @INC, "debian", "/usr/lib/debhelper" }
-use Dh_Lib;
+=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