r433: this is getting *so* boring.

1 files changed, 51 insertions, 3 deletions

diff --git a/dh_md5sums b/dh_md5sums
index ad3ae712..51bd54c8 100755
--- a/dh_md5sums
+++ b/dh_md5sums
@@ -1,11 +1,47 @@
 #!/usr/bin/perl -w
-#
-# Generate a DEBIAN/md5sums file, that lists the md5sums of all files in the
-# package.
+
+=head1 NAME
+
+dh_md5sums - generate DEBIAN/md5sums file
+
+=cut
 
 use strict;
 use Cwd;
 use Debian::Debhelper::Dh_Lib;
+
+=head1 SYNOPSIS
+
+  dh_md5sums [debhelper options] [-x] [-Xitem] [--include-conffiles]
+
+=head1 DESCRIPTION
+
+dh_md5sums is a debhelper program that is responsible for generating
+a DEBIAN/md5sums file, which lists the md5sums of each file in the package.
+
+All files in DEBIAN/ are omitted from the md5sums file, as are all
+conffiles (unless you use the --include-conffiles switch).
+
+The md5sums file is installed with proper permissions and ownerships.
+
+=head1 OPTIONS
+
+=over 4
+
+=item B<-x>, B<--include-conffiles>
+
+Include conffiles in the md5sums list. Note that this information is
+redundant since it is included elsewhere in debian packages.
+
+=item B<-X>I<item>, B<--exclude=>I<item>
+
+Exclude files that contain "item" anywhere in their filename from
+being listed in the md5sums file.
+
+=back
+
+=cut
+
 init();
 
 foreach my $package (@{$dh{DOPACKAGES}}) {
@@ -44,3 +80,15 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
 		doit("chown","0.0","$tmp/DEBIAN/md5sums");
 	}
 }
+
+=head1 SEE ALSO
+
+L<debhelper(1)>
+
+This program is a part of debhelper.
+
+=head1 AUTHOR
+
+Joey Hess <joeyh@debian.org>
+
+=cut