summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNiels Thykier <niels@thykier.net>2015-09-20 19:04:13 +0200
committerNiels Thykier <niels@thykier.net>2015-09-20 19:04:23 +0200
commit0df8fdb046add9ddd72a7fbfd2d36fc949b1faa8 (patch)
tree3a23470e355d75d071537fc37c8e0d1741feb4e9
parent10aa93aa5dfae31fc09371f397fc6d4bd7937cf2 (diff)
downloaddebhelper-0df8fdb046add9ddd72a7fbfd2d36fc949b1faa8.tar.gz
dh_installdirs.1: Document that it can often be omitted
Signed-off-by: Niels Thykier <niels@thykier.net>
-rw-r--r--debian/changelog2
-rwxr-xr-xdh_installdirs8
2 files changed, 10 insertions, 0 deletions
diff --git a/debian/changelog b/debian/changelog
index 0201d680..bdceb0e2 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -60,6 +60,8 @@ debhelper (9.20150811+unreleased) UNRELEASED; urgency=medium
--max-parallel=1 but may be more intuative to some people.
* dh_makeshlibs: Use a noawait trigger to invoke ldconfig
rather maintscripts.
+ * dh_installdirs.1: Add a note that many packages will work
+ fine without calling dh_installdirs. (Closes: #748993)
[ Paul Tagliamonte ]
* dh_gencontrol: Put debug debs back in the "debug" section.
diff --git a/dh_installdirs b/dh_installdirs
index 6797458f..dc4999e5 100755
--- a/dh_installdirs
+++ b/dh_installdirs
@@ -19,6 +19,10 @@ B<dh_installdirs> [S<I<debhelper options>>] [B<-A>] [S<I<dir> ...>]
B<dh_installdirs> is a debhelper program that is responsible for creating
subdirectories in package build directories.
+Many packages can get away with omitting the call to B<dh_installdirs>
+completely. Notably, other B<dh_*> commands are expected to create
+directories as needed.
+
=head1 FILES
=over 4
@@ -27,6 +31,10 @@ subdirectories in package build directories.
Lists directories to be created in I<package>.
+Generally, there is not need to list directories created by the
+upstream build system or directories needed by other B<debhelper>
+commands.
+
=back
=head1 OPTIONS