=head1 SYNOPSIS
-B<dh_installdirs> [S<I<debhelper options>>] [B<-A>] [S<I<dir ...>>]
+B<dh_installdirs> [S<I<debhelper options>>] [B<-A>] [S<I<dir> ...>]
=head1 DESCRIPTION
-dh_installdirs is a debhelper program that is responsible for creating
+B<dh_installdirs> is a debhelper program that is responsible for creating
subdirectories in package build directories.
-Any directory names specified as parameters will be created in the package
-build directory of the first package dh_installdirs is told to act on. By
-default, this is the first binary package in debian/control, but if you use
--p, -i, or -a flags, it will be the first package specified by those flags.
+=head1 FILES
-A file named debian/package.dirs can list other directories to be created.
-Separate the directory names with whitespace.
+=over 4
+
+=item debian/I<package>.dirs
-Be sure to only use directory names relative to the package build
-directory. Ie, "/usr/bin" should not be used, use "usr/bin" instead.
+Lists directories to be created in I<package>.
+
+=back
=head1 OPTIONS
Create any directories specified by command line parameters in ALL packages
acted on, not just the first.
-=item I<dir ...>
+=item I<dir> ...
Create these directories in the package build directory of the first
-package acted on. (Or in all packages if -A is specified.)
+package acted on. (Or in all packages if B<-A> is specified.)
=back
=head1 SEE ALSO
-L<debhelper(1)>
+L<debhelper(7)>
This program is a part of debhelper.