[Debian-med-packaging] Bug#922861: samtools: Outdated and missing documentation files

[John Marshall]

Package: samtools
Version: 1.9-3

This package places the following in /usr/share/doc/samtools:

AUTHORS
NEWS.Debian.gz
README.Debian
changelog.Debian.gz
copyright
examples/
reference

AUTHORS comes from the upstream release.
NEWS.Debian.gz contains an ancient "samtools (1.3-1) unstable; urgency=medium" Debian changelog item.
README.Debian contains out-of-date Debian-specific information that is now incorrect.
changelog.Debian.gz is an up-to-date Debian changelog.
copyright is an up-to-date Debian summary of licensing.
examples/ comes from the upstream release.
reference is an up-to-date Debian addition.

NEWS.Debian.gz should be replaced by an up-to-date copy of the upstream release's NEWS file. (The related htslib packages do this via override_dh_installchangelogs.)

README.Debian should be updated or removed.

The package is missing the upstream release's README file. It would be good to install this file, even though it doesn't currently contain a great deal of salient information. (The upstream release's INSTALL file is also missing, but that is of course appropriate for a binary package.)

(The related htslib Debian packages are also missing their upstream release README file.)

    John