X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_testroot;h=c010dd507c9e6f46409326b3c74077df68e489a5;hb=e2a6d4cec4a7ee952cf6a7f250d80f1d75a38f95;hp=c62894c74cbe6b7e83ab1662f5a686ef5e4fdb69;hpb=23cee323324f4bb3fc0d0033ef5bd0e4af62dc85;p=debhelper.git

diff --git a/dh_testroot b/dh_testroot
index c62894c..c010dd5 100755
--- a/dh_testroot
+++ b/dh_testroot
@@ -1,10 +1,37 @@
 #!/usr/bin/perl -w
-#
-# Checks to make sure you are root.
 
-BEGIN { push @INC, "debian", "/usr/share/debhelper" }
-use Dh_Lib;
+=head1 NAME
+
+dh_testroot - ensure that a package is built as root
+
+=head1 SYNOPSIS
+
+B<dh_testroot> [S<I<debhelper options>>]
+
+=head1 DESCRIPTION
+
+B<dh_testroot> simply checks to see if you are root. If not, it exits with an
+error. Debian packages must be built as root, though you can use 
+L<fakeroot(1)>
+
+=cut
+
+use strict;
+use Debian::Debhelper::Dh_Lib;
+inhibit_log();
 
 if ($< != 0) {
-	error("You must run this as root.");
+	error("You must run this as root (or use fakeroot).");
 }
+
+=head1 SEE ALSO
+
+L<debhelper(7)>
+
+This program is a part of debhelper.
+
+=head1 AUTHOR
+
+Joey Hess <joeyh@debian.org>
+
+=cut