dh_installdocs: Support --sourcedir and fallback to d/tmp [c11]

1 files changed, 10 insertions, 3 deletions

diff --git a/dh_installdocs b/dh_installdocs
index e8ecc44f..8e09022e 100755
--- a/dh_installdocs
+++ b/dh_installdocs
@@ -19,11 +19,16 @@ 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
+In compat 10 and earlier, L<dh_install(1)> may be a better tool for handling
+the upstream documentation, when upstream's own build system installs all the desired documentation
+correctly.  In this case, B<dh_installdocs> is still useful for installing
 packaging related documentation (e.g. the F<debian/copyright> file).
 
+In compat 11 and later, B<dh_installdocs> offers many of the features that
+L<dh_install(1)> also have.  Futhermore, B<dh_installdocs> also supports
+the B<nodoc> build profile to exclude documentation (regardless of compat
+level).
+
 =head1 FILES
 
 =over 4
@@ -178,12 +183,14 @@ sub ensure_docdir {
 
 init(options => {
 	"link-doc=s" => \$dh{LINK_DOC},
+	"sourcedir=s" => \$dh{SOURCEDIR},
 });
 
 my $called_getpackages = 0;
 my @search_dirs = ('.');
 my $error_handler = compat(10) ? \&glob_expand_error_handler_warn_and_discard : \&glob_expand_error_handler_reject;
 my $nodocs = is_build_profile_active('nodoc') ? 1 : 0;
+@search_dirs = ($dh{SOURCEDIR} // '.', 'debian/tmp') if not compat(10);
 
 foreach my $package (getpackages()) {
 	next if is_udeb($package);