[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: dh_installdocs ignores package.README.Debian

On Tue, May 04, 2004 at 08:42:49AM +1000, Brian May wrote:
> >>>>> "Jeroen" == Jeroen van Wolffelaar <jeroen@wolffelaar.nl> writes:
>     Jeroen> Pure memory, and it failed. debian/[<pkg>.]NEWS (via
>     Jeroen> dh_installchangelogs) and debian/[<pkg>.]TODO (via
>     Jeroen> dh_installdocs) have this kind of behaviour, indeed as
>     Jeroen> others have said debian/[<pkg>.]README.Debian doesn't work
>     Jeroen> this way.
> Huh? Maybe I am getting confused, but according to the man page:

Argh, in an effort to try to clear things up, I made a stupid typo...

Please replace the above quoted part by (changes in last three lines):

> JeroenCorrected> Pure memory, and it failed. debian/[<pkg>.]NEWS (via
> JeroenCorrected> dh_installchangelogs) and debian/[<pkg>.]TODO (via
> JeroenCorrected> dh_installdocs) have this kind of behaviour, indeed as
> JeroenCorrected> others have said debian/[<pkg>.]README doesn't work
> JeroenCorrected> like NEWS and TODO, i.e., won't get installed and have
> JeroenCorrected> .Debian magically appended."

(snip manpage snippet)
> So it would appear that debian/<pkg>.TODO is supported, *and*
> debian/<pkg>.README.Debian is also supported.

> Or maybe you were concluding that debian/<pkg>.README isn't supported,
> but in that case you have agreed that the initial poster had done the
> correct thing[1].

Indeed, by stating "Pure memory, and it failed." I indeed agreed the
initial poster had done the correct thing w.r.t. filenames (and that I
was mistaken).

>     Jeroen> NEWS & TODO are also documented in the manpage as such.
>     Jeroen> I think it's really like someone else says, that your dh_*
>     Jeroen> invocation is broken.
> In what way is it broken? He said he named it
> debian/<pkg>.README.Debian, and that is the filename listed in the
> documentation.

Indeed. I said dh_* invocation, and I was referring to [2], incidentely
written by yourself.

> He didn't list README.Debian on the command line, but according to the
> documentation (and my reading of the code), it should get installed
> regardless.

> If I encountered this problem, I would look at the -v flag, it might
> give debugging information. Failing this, I might try strace, but that
> is an advanced technique that might overwhelm some people with loads
> of useless data.

Good advice, though most helpful in this case I think is trying to
really understand how dh_* interact with debian/control and -a and -i

> [1] Also debian/<pkg>.README.debian seems to be supported, although
> not documented, and probably should be avoided. From the code:

This is documented. From the manpage snippet you yourself quoted:
| "Also, debian/README.Debian (or debian/README.debian) and

Anyway, sorry for the unclearness in my previous mail, I seem to have
only confused this thread, rather than help it. Feel free to killfile
myself in this thread, as seems to be "in"[3] now.


[2] http://lists.debian.org/debian-devel/2004/debian-devel-200405/msg00121.html
[3] http://lists.debian.org/debian-devel/2004/debian-devel-200405/msg00167.html

Jeroen van Wolffelaar
Jeroen@wolffelaar.nl (also for Jabber & MSN; ICQ: 33944357)

Reply to: