X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_testroot;h=c010dd507c9e6f46409326b3c74077df68e489a5;hb=18a0da8092ea9f3dc48bca92b36f592af25a608d;hp=b76a1e595678268e6914c0bc389be4b0d6e6d83c;hpb=67b74298f08a3e2b30e43cbcd7cdaccc2e1b1614;p=debhelper.git

diff --git a/dh_testroot b/dh_testroot
index b76a1e5..c010dd5 100755
--- a/dh_testroot
+++ b/dh_testroot
@@ -1,9 +1,37 @@
 #!/usr/bin/perl -w
-#
-# Checks to make sure you are root.
 
+=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