dh_installdocs: Clarify that debian/README.Debian and debian/TODO are only installed...

diff --git a/debian/changelog b/debian/changelog
index eab1fb32734e9b442c98a7a619d86cd4cc4223de..2eae968f253a305f1e61802af4577a60832f470a 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -27,6 +27,9 @@ debhelper (8.1.0) UNRELEASED; urgency=low
     (Thanks, Roger Leigh)
   * dh_listpackages: Do not display warnings if options cause no packages
     to be listed.
+  * dh_installdocs: Clarify that debian/README.Debian and debian/TODO are
+    only installed into the first package listed in debian/control.
+    Closes: #606036
   
   [ Valery Perrin ]
   * update french translation.

diff --git a/dh_installdocs b/dh_installdocs
index 581d6353950a08edb61286be0be575e6e24e3af4..104b796ea460a44701639cad9cf696a4d2255633 100755 (executable)
--- a/dh_installdocs
+++ b/dh_installdocs
@@ -28,9 +28,8 @@ List documentation files to be installed into I<package>.
 
 =item F<debian/copyright>
 
-=item F<debian/README.Debian>
-
-=item F<debian/TODO>
+The copyright file is installed into all packages, unless a more
+specific copyright file is available.
 
 =item debian/I<package>.copyright
 
@@ -38,11 +37,18 @@ List documentation files to be installed into I<package>.
 
 =item debian/I<package>.TODO
 
-Each of these files is automatically installed if present. Use the package
-specific name if I<package> needs a different version of the file.
+Each of these files is automatically installed if present for a
+I<package>.
+
+=item F<debian/README.Debian>
+
+=item F<debian/TODO>
+
+These files are installed into the first binary package listed in
+debian/control.
 
-Note that F<debian/README.debian> is also installed as F<README.Debian>,
-and F<debian/TODO> will be installed as F<TODO.Debian> in non-native packages.
+Note that F<README.debian> files are also installed as F<README.Debian>,
+and F<TODO> files will be installed as F<TODO.Debian> in non-native packages.
 
 =item debian/I<package>.doc-base