Package: kmod
Version: 20-1

The file
http://http.debian.net/debian/pool/main/k/kmod/kmod_20.orig.tar.xz
is not actually the original source code, and the kmod API
documentation is missing from the packages built from it.

File                                                               sha256sum
http://http.debian.net/debian/pool/main/k/kmod/kmod_20.orig.tar.xz 
591d729557cf2fcaa434534f7f55f096592f459cfb33501791424076d077295e
https://www.kernel.org/pub/linux/utils/kernel/kmod/kmod-20.tar.xz  
89c1a1a2193c31f9ebe582640bfa2bd401341dc24119f5a7f702588116fadaa0

Several files in the kernel.org version are missing from the Debian
version, including kmod-20/libkmod/docs/gtk-doc.make and
kmod-20/libkmod/docs/Makefile.in. 

The package as originally written is supposed to contain API
documentation in HTML format. When built from the Debian source this
documentation is missing. 

If, however, before executing dpkg-source -x, the genuine
kmod-20.tar.xz from kernel.org is copied as kmod_20.orig.tar.xz and
the hashes in kmod_20-1.dsc adjusted accordingly, the resulting
kmod_20-1_amd64.deb *does* contain the API documentation; it is under
/usr/share/gtk-doc/html/libkmod-3.

Surely the Debian version of the tarball should be identical to the
kernel.org original, and any Debianising patching performed through
the agency of kmod_20-1.debian.tar.xz. It should not be necessary to
refer back to kernel.org to get the complete package including all
files needed to build the API documentation.

Further, and obviously, the documentation being missing from the
Debian package is a thorough pain to anyone wanting to write code
using the API.

-- 
Pigeon

Be kind to pigeons        - -        Pigeon's Nest: http://pigeonsnest.co.uk/
GPG key: http://pgp.mit.edu:11371/pks/lookup?op=get&search=0x21C61F7F

Attachment: signature.asc
Description: Digital signature

Reply via email to