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.
Correct.
> 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.
Correct.
> 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
flags.
> [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.
--Jeroen
[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)
http://Jeroen.A-Eskwadraat.nl
Reply to: