[Pkg-icecast-devel] Bug#573928: manpage is incomplete and incorrect

[John Pearson]

Package: ezstream
Severity: important
Tags: patch


The existing Debian-provided manual page is incoreect and misleading;
it does not provide sufficient information to use ezstream, and refers
to upstream info documentation that simply does not exist.

Upstream source now includes a much more comprehensive manpage and there
does not appear ot be any reason not to package it.

The attached patch removes the poor Debian-specific manpage and installs the 
upstream manpage in its place; it also removes the rules for generating the
Debian manpage from sgml source and for building non-existent info files,
and removes the build dependency on docbook-to-man and dh-buildinfo.

The curerent manpage is so poor, and the upstream manpage so much better,
that I wish I could justify raising the severity to critical, but I cannot.
Do we have any wriggle-room this close to release to get it fixed?


John Pearson.

-- System Information:
Debian Release: 6.0
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.32-5-amd64 (SMP w/4 CPU cores)
Locale: LANG=en_AU.utf8, LC_CTYPE=en_AU.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
-------------- next part --------------
A non-text attachment was scrubbed...
Name: ezstream-0.5.6~dfsg-1-add-manpage.diff.gz
Type: application/x-gzip
Size: 919 bytes
Desc: not available
URL: <http://lists.alioth.debian.org/pipermail/pkg-icecast-devel/attachments/20110116/cf5e70ea/attachment.bin>