Re: create docs in binary indep
On Sun, Jan 29, 2006 at 09:12:26PM -0800, Jon Saints wrote:
> I am new to packaging and just received this feedback
> on a package I helped to create:
>
> "I just noticed that gdal packaging needs one more
> revision because it
> create a -doc package in the binary-arch section.
libgdal-doc is [correctly] and Architecture: all package.
There are 2 [related] policy violations, in that the binary-indep
target doesn't exist [0], and that the Arch: all package is built in
the binary-arch target.
[0] http://www.us.debian.org/doc/debian-policy/ch-source.html#s-debianrules
By the way, why doese debian/libgdal-doc.files exist? Shouldn't it be
cleaned, by the clean target, and never exist in the source package?
FYI you will want to look at how other, template debhelper rules files
do this, wrt exporting DH_OPTIONS:
/usr/share/debhelper/dh_make/debianm/rules
> Should I simply move dh_installdocs to a new binary-indep section in
> order to solve the policy violation?
Something like that. You want to ensure, of course, that whatever
mechanism you use, complies with the documented policy, and also
- doesn't include the documentation in the main package
(otherwise you should not have a separate -doc package); and
- includes the documentation in the -doc package
(otherwise it will be empty and useless).
You can test what gets built where by calling something like
fakeroot ./debian/rules binary-arch
And ensuring that only the arch-dep packages are built into ../*.deb,
and then
fakeroot ./debian/rules binary-indep
And ensuring that only the arch-indep packages are built into ../*.deb,
And then you can test the contents of the packages with dpkg-deb -c.
--
Clear skies,
Justin
Reply to: