r423: podized man page

diff --git a/dh_builddeb b/dh_builddeb
index 795d9a0adc518080f437636348166d5cee6624c1..bfebe2821a249c79ea365089ae372bc0d0c631ab 100755 (executable)
--- a/dh_builddeb
+++ b/dh_builddeb
@@ -1,9 +1,48 @@
 #!/usr/bin/perl -w
-#
-# Build the .deb package, assuming all the files are set up.
+
+=head1 NAME
+
+dh_builddeb - build debian packages
+
+=cut
 
 use strict;
 use Debian::Debhelper::Dh_Lib;
+
+=head1 SYNOPSIS
+
+  dh_builddeb [debhelper options] [--destdir=directory] 
+              [--name=filename] [-uparams] [-- params]
+
+=head1 DESCRIPTION
+
+dh_builddeb simply calls L<dpkg(8)|dpkg> to build a debian package or
+packages.
+
+=head1 OPTIONS
+
+=over 4
+
+=item B<--destdir=>I<directory>
+
+Use this if you want the generated .deb files to be put in a directory
+other than the default of ".."
+
+=item B<--name=>I<filename>
+
+Use this if you want to force the generated .deb file to have a particular
+file name. Does not work well if more than one .deb is generated!
+
+=item B<-u>I<params>
+=item B<--> I<params>
+
+Pass I<params> to L<dpkg(1)|dpkg> when it is used to build the
+package.
+
+=back
+
+=cut
+
 init();
 
 # Set the default destination directory.
@@ -22,3 +61,15 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
        my $tmp=tmpdir($package);
        doit("dpkg","--build",$tmp,"$dh{DESTDIR}$dh{FILENAME}",@{$dh{U_PARAMS}});
 }
+
+=head1 SEE ALSO
+
+L<debhelper(1)|debhelper>
+
+This program is a part of debhelper.
+
+=head1 AUTHOR
+
+Joey Hess <joeyh@debian.org>
+
+=cut

diff --git a/dh_builddeb.1 b/dh_builddeb.1
index cefcd64891e504c01cf96030584431a57dad1007..3a5851bec0a7b75be52d370fe275ca6ffa80da61 100644 (file)
--- a/dh_builddeb.1
+++ b/dh_builddeb.1
@@ -10,11 +10,6 @@ dh_builddeb simply calls
 to build a .deb package or packages.
 .SH OPTIONS
 .TP
-.B debhelper options
-See
-.BR debhelper (1)
-for a list of options common to all debhelper commands.
-.TP
 .B --destdir=directory
 Use this if you want the generated .deb files to be put in a directory other
 than the default of ".."