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

[Jonas Smedegaard]

Hi John,

On Sun, Jan 16, 2011 at 10:18:05AM +1030, John Pearson wrote:
>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.

Ah.  Thanks for pointing that out.  Fixed now in our Git.


>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.

Whoops - I think you misunderstood a tool there: dh-buildinfo does not 
handle info files, but includes buildinfo with binary packages.


>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?

Too late now for Squeeze.  Have been frozen for 6 months - we shouldn't 
delay it any further for a minor issue like this.


 - Jonas

-- 
  * Jonas Smedegaard - idealist & Internet-arkitekt
  * Tlf.: +45 40843136  Website: http://dr.jones.dk/

  [x] quote me freely  [ ] ask before reusing  [ ] keep private
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 836 bytes
Desc: Digital signature
URL: <http://lists.alioth.debian.org/pipermail/pkg-icecast-devel/attachments/20110116/b43121aa/attachment.pgp>