Bug#369268: [Build-common-hackers] Bug#369268: debhelper.mk: installs common docs instead of docs listed in package.docs

[Peter Eisentraut]

Micha Lenk wrote:
> cdbs is unable to do this using per-package *.docs files because it
> supplies the $(CURDIR)/README in $DEB_INSTALL_DOCS_ALL always, even
> if another README should be installed when looking at package.docs. 
> This causes dh_installdocs to first install the README file mentioned
> in package.docs and afterwards installing the README file from
> $(CURDIR) mentioned in $DEB_INSTALL_DOCS_ALL overwriting the first
> README.
>
> This bug is somewhat related to #207775 (if #207775 were fixed this
> new bug wouldn't occur at all).

Right, this is just another effect of that issue.  I don't see how we 
can fix it without breaking compatiblity.