[debhelper-devel] [debhelper] 16/17: dh_installdocs: Recommend dh_install for upstream docs in some cases

[Niels Thykier]

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

nthykier pushed a commit to branch master
in repository debhelper.

commit 73d00eed00d8c7d40692fa4b0590e5377e6a393b
Author: Niels Thykier <niels at thykier.net>
Date:   Sat Apr 8 08:48:16 2017 +0000

    dh_installdocs: Recommend dh_install for upstream docs in some cases
    
    Signed-off-by: Niels Thykier <niels at thykier.net>
---
 dh_installdocs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/dh_installdocs b/dh_installdocs
index 9c82b5b..98f5418 100755
--- a/dh_installdocs
+++ b/dh_installdocs
@@ -19,6 +19,11 @@ B<dh_installdocs> [S<I<debhelper options>>] [B<-A>] [B<-X>I<item>] [S<I<file> ..
 B<dh_installdocs> is a debhelper program that is responsible for installing
 documentation into F<usr/share/doc/package> in package build directories.
 
+When upstream's own build system installs all the desired documentation
+correctly, then B<dh_install> may be a better tool for handling the upstream
+documentation.  In this case, B<dh_installdocs> is still useful for installing
+packaging related documentation (e.g. the F<debian/copyright> file).
+
 =head1 FILES
 
 =over 4

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