tag 203410 patch thanks I have written a manpage for this program, by adding POD documentation in the script itself and using pod2man. Patch is attached.
-- Rodrigo Gallardo GPG-Fingerprint: 7C81 E60C 442E 8FBC D975 2F49 0199 8318 ADC9 BC28 Zenophobia: the irrational fear of convergent sequences.
diff -ur dh-buildinfo-0.9/debian/rules dh-buildinfo-0.9-0.1/debian/rules --- dh-buildinfo-0.9/debian/rules 2006-02-14 15:15:04.000000000 -0600 +++ dh-buildinfo-0.9-0.1/debian/rules 2007-03-07 22:32:56.000000000 -0600 @@ -24,6 +24,7 @@ $(PERL) Makefile.PL INSTALLDIRS=vendor $(MAKE) OPTIMIZE="-O2 -g -Wall" + pod2man --center debian dh_buildinfo > dh_buildinfo.1 touch build-stamp @@ -34,7 +35,7 @@ -$(MAKE) realclean - dh_clean + dh_clean dh_buildinfo.1 install: dh_testdir @@ -56,7 +57,7 @@ dh_installdocs buildinfo.html ./dh_buildinfo dh_installcron -# dh_installman + dh_installman dh_buildinfo.1 dh_installchangelogs dh_compress dh_fixperms diff -ur dh-buildinfo-0.9/dh_buildinfo dh-buildinfo-0.9-0.1/dh_buildinfo --- dh-buildinfo-0.9/dh_buildinfo 2004-01-08 07:22:37.000000000 -0600 +++ dh-buildinfo-0.9-0.1/dh_buildinfo 2007-03-07 22:28:46.000000000 -0600 @@ -1,5 +1,11 @@ #!/usr/bin/perl -w +=head1 NAME + +dh_buildinfo - register the versions of build-dependencies used to build a package + +=cut + # TODO: # - use cleaner APIs # - list "also used by" packages after "pulled by" ? @@ -14,6 +20,47 @@ use Debian::Debhelper::Dh_Lib; use BuildDeps; +=head1 SYNOPSIS + +B<dh_buildinfo> [S<I<debhelper options>>] [S<I<generate>>] [S<I<cat>>] [S<I<install>>] + +=head1 DESCRIPTION + +dh_buildinfo is a debhelper program that registers in a file the list +of packages declared as build-time dependencies, as well as +build-essential packages, together with their versions, as installed +in the build machine. + +This will hopefully help to track packages (auto-)built with package +versions which are known to be buggy, and, more generally, to find out +whether a package needs to be rebuilt because of a significant change +in a package it has a build-time dependency on. + +You will usually just run this in your package's binary rule. If you +need extra control over the operation, you can specify the actions to +be taken. The default actions are I<generate> I<install>. + +=head1 OPTIONS + +=over 4 + +=item I<generate> + +Generate the list of versions of the build dependencies in use. + +=item I<cat> + +Output the list of versions to I<stdout>. + +=item I<install> + +Installs the compressed list of versions to the package's build directory, in +/usr/share/doc/package/buildinfo.gz + +=back + +=cut + # This part could be replaced. Silly little status file parser. # thanks to Matt Zimmerman. Returns two hash references that # are exactly what the other functions need...
signature.asc
Description: Digital signature