[Reproducible-commits] [debhelper] 42/56: dh_installdirs.1: Document that it can often be omitted

[Mattia Rizzolo]

This is an automated email from the git hooks/post-receive script.

mapreri-guest pushed a commit to branch master
in repository debhelper.

commit 0df8fdb046add9ddd72a7fbfd2d36fc949b1faa8
Author: Niels Thykier <niels at thykier.net>
Date:   Sun Sep 20 19:04:13 2015 +0200

    dh_installdirs.1: Document that it can often be omitted
    
    Signed-off-by: Niels Thykier <niels at thykier.net>
---
 debian/changelog | 2 ++
 dh_installdirs   | 8 ++++++++
 2 files changed, 10 insertions(+)

diff --git a/debian/changelog b/debian/changelog
index 0201d68..bdceb0e 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 6797458..dc4999e 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

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/reproducible/debhelper.git