X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_testdir;h=67ab9ea4ca0dd69e595dc9d8b65352d80761d57f;hb=725a4d769be1573cca18ced3581a55ef906235ff;hp=394fa35904d75c7eb356a5ef15e13fa2e63afa99;hpb=c89efb0352c6c4af78bc8d5ebbe7cb3846ff89f3;p=debhelper.git

diff --git a/dh_testdir b/dh_testdir
index 394fa35..67ab9ea 100755
--- a/dh_testdir
+++ b/dh_testdir
@@ -1,14 +1,54 @@
 #!/usr/bin/perl -w
-#
-# Checks to make sure we are building the package in the right directory.
-# Tests for the existance of debian/control, and for the existance
-# of any other files you specify on the command line.
 
+=head1 NAME
+
+dh_testdir - test directory before building debian package
+
+=cut
+
+use strict;
 use Debian::Debhelper::Dh_Lib;
+
+=head1 SYNOPSIS
+
+B<dh_testdir> [S<I<debhelper options>>] [S<I<file ...>>]
+
+=head1 DESCRIPTION
+
+dh_testdir tries to make sure that you are in the correct directory when
+building a debian package. It makes sure that the file debian/control
+exists, as well as any other files you specify. If not,
+it exits with an error.
+
+=head1 OPTIONS
+
+=over 4
+
+=item I<file ...>
+
+Test for the existence of these files too.
+
+=back
+
+=cut
+
 init();
+inhibit_log();
 
-foreach $file ('debian/control', @ARGV) {
+foreach my $file ('debian/control', @ARGV) {
 	if (! -e $file) {
 		error("\"$file\" not found. Are you sure you are in the correct directory?");
 	}
 }
+
+=head1 SEE ALSO
+
+L<debhelper(7)>
+
+This program is a part of debhelper.
+
+=head1 AUTHOR
+
+Joey Hess <joeyh@debian.org>
+
+=cut