[Build-common-hackers] Re: Bug#220748: debhelper: dh_installdocs doesn't handle paths with more than one component

[Robert Millan]

On Tue, Nov 18, 2003 at 12:28:38PM -0500, Joey Hess wrote:
> > 
> > Is that the expected behaviour in dh_installdocs? If it is, then I'd like to
> > find a way (maybe an extra option) to override this for CDBS to work properly.
> 
> Yes, debhelper programs will read from both files and the command line
> if both are present, although this is probably rarely used. To change
> this I would have to add an option or wait for v5 and change the
> behavior there. Before looking at either of those I hope you can see if
> there is some other way for cdbs to use debhelper than this.

I can think of two solutions:
 #1 using a non-standard name (e.g debian/docs.cdbs) in CDBS-based packages
    and getting CDBS to parse it.
 #2 implementing template generation (from debian/*.in) in CDBS and getting
    the debian/docs files to use dynamicaly generated relative paths.
    (e.g: @DEB_SRCDIR@/README)

#1 is really dirty and I recommend against it. #2 is still impractical for
maintainers of CDBS-based packages.

I leave this up to the CDBS maintainers if they want to fix this somehow or
just wait for you to change dh_installdocs.

-- 
Robert Millan

"[..] but the delight and pride of Aule is in the deed of making, and in the
thing made, and neither in possession nor in his own mastery; wherefore he
gives and hoards not, and is free from care, passing ever on to some new work."

 -- J.R.R.T, Ainulindale (Silmarillion)