X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=dh_installdirs;h=b0572ca9910cf8ac6cfeaad60f5928dbeb1b37e1;hb=18a0da8092ea9f3dc48bca92b36f592af25a608d;hp=340c966e4e8fd69e69d914c19beb944992debdcc;hpb=053f6f8b4e7431d32511aef209188a084e8c7e79;p=debhelper.git

diff --git a/dh_installdirs b/dh_installdirs
index 340c966..b0572ca 100755
--- a/dh_installdirs
+++ b/dh_installdirs
@@ -1,9 +1,51 @@
 #!/usr/bin/perl -w
-#
-# Reads debian/dirs, creates the directories listed there
+
+=head1 NAME
+
+dh_installdirs - create subdirectories in package build directories
+
+=cut
 
 use strict;
 use Debian::Debhelper::Dh_Lib;
+
+=head1 SYNOPSIS
+
+B<dh_installdirs> [S<I<debhelper options>>] [B<-A>] [S<I<dir> ...>]
+
+=head1 DESCRIPTION
+
+B<dh_installdirs> is a debhelper program that is responsible for creating
+subdirectories in package build directories.
+
+=head1 FILES
+
+=over 4
+
+=item debian/I<package>.dirs
+
+Lists directories to be created in I<package>.
+
+=back
+
+=head1 OPTIONS
+
+=over 4
+
+=item B<-A>, B<--all>
+
+Create any directories specified by command line parameters in ALL packages
+acted on, not just the first.
+
+=item I<dir> ...
+
+Create these directories in the package build directory of the first
+package acted on. (Or in all packages if B<-A> is specified.)
+
+=back
+
+=cut
+
 init();
 
 foreach my $package (@{$dh{DOPACKAGES}}) {
@@ -40,3 +82,15 @@ foreach my $package (@{$dh{DOPACKAGES}}) {
 		doit("install","-d",@dirs);
 	}
 }
+
+=head1 SEE ALSO
+
+L<debhelper(7)>
+
+This program is a part of debhelper.
+
+=head1 AUTHOR
+
+Joey Hess <joeyh@debian.org>
+
+=cut