Debian Bug report logs - #573928
ezstream manpage is incomplete and incorrect

Display info messages

Message #5 received at submit@bugs.debian.org (full text, mbox, reply):

From: Philip Muskovac <yofel@gmx.net>

To: Debian Bug Tracking System <submit@bugs.debian.org>

Subject: ezstream manpage is incomplete and incorrect

Date: Mon, 15 Mar 2010 03:12:08 +0100

Package: ezstream
Version: 0.5.6~dfsg-1
Severity: normal

Forwarded from https://bugs.launchpad.net/ubuntu/+source/ezstream/+bug/538589

Man page says:
"ezstream [-h] [-c CONFIGFILE]"

This indicates only two possible flags, and also indicates that -c is optional.

Running "ezstream" produces this:

"You must supply a config file with the -c argument.
usage: ezstream [-hnqVv] -c configfile"
       ezstream -s [playlist]

Here we see that -c is required, and also the existence of 5 other undocumented flags.


-- System Information:
Debian Release: squeeze/sid
  APT prefers lucid-updates
  APT policy: (600, 'lucid-updates'), (600, 'lucid-security'), (600, 'lucid-proposed'), (600, 'lucid-backports'), (600, 'lucid'), (50, 'karmic-updates'), (50, 'karmic-security'), (50, 'karmic-proposed'), (50, 'karmic-backports'), (50, 'karmic')
Architecture: i386 (i686)

Kernel: Linux 2.6.32-16-generic (SMP w/2 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8) (ignored: LC_ALL set to en_US.UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages ezstream depends on:
ii  libc6                2.11.1-0ubuntu4     Embedded GNU C Library: Shared lib
ii  libogg0              1.1.4~dfsg-2        Ogg bitstream library
ii  libshout3            2.2.2-5ubuntu1      MP3/Ogg Vorbis broadcast streaming
ii  libvorbis0a          1.2.3-3ubuntu1      The Vorbis General Audio Compressi
ii  libvorbisfile3       1.2.3-3ubuntu1      The Vorbis General Audio Compressi
ii  libxml2              2.7.6.dfsg-1ubuntu1 GNOME XML library

Versions of packages ezstream recommends:
ii  vorbis-tools               1.2.0-6build1 several Ogg Vorbis tools

Versions of packages ezstream suggests:
pn  ffmpeg2theora                 <none>     (no description available)
pn  flac                          <none>     (no description available)
pn  icecast2                      <none>     (no description available)
pn  madplay                       <none>     (no description available)

-- no debconf information

Message #10 received at 573928@bugs.debian.org (full text, mbox, reply):

From: John Pearson <huiac@internode.on.net>

To: Debian Bug Tracking System <573928@bugs.debian.org>

Subject: Re: manpage is incomplete and incorrect

Date: Sun, 16 Jan 2011 10:18:05 +1030

[Message part 1 (text/plain, inline)]

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

[ezstream-0.5.6~dfsg-1-add-manpage.diff.gz (application/x-gzip, attachment)]

Message #15 received at 573928@bugs.debian.org (full text, mbox, reply):

From: Jonas Smedegaard <dr@jones.dk>

To: John Pearson <huiac@internode.on.net>, 573928@bugs.debian.org

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

Date: Sun, 16 Jan 2011 13:51:40 +0100

[Message part 1 (text/plain, inline)]

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

[signature.asc (application/pgp-signature, inline)]

Message #20 received at 573928@bugs.debian.org (full text, mbox, reply):

From: Harald Dunkel <harri@afaics.de>

To: 573928@bugs.debian.org

Subject: Re: ezstream manpage is incomplete and incorrect

Date: Sun, 10 Jul 2011 20:00:23 +0200

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Squeeze is out of the door now. Any news about shipping
upstream's manpages for ezstream and ezstream-file?
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)

iEYEARECAAYFAk4Z6LEACgkQUTlbRTxpHjdm2wCdHr6S/873QRWyLtxkbSHX5BbE
PqgAnArUWbN39Uck42SrIo0OlcF966Dl
=Fp/j
-----END PGP SIGNATURE-----

Message #25 received at 573928@bugs.debian.org (full text, mbox, reply):

From: Antoine Beaupré <anarcat@debian.org>

To: Debian Bug Tracking System <573928@bugs.debian.org>

Subject: Re: ezstream manpage is incomplete and incorrect

Date: Thu, 14 Apr 2016 18:15:08 -0400

Package: ezstream
Version: 0.5.6~dfsg-1
Followup-For: Bug #573928

Ping? It's been 5 years? Can I NMU this?

-- System Information:
Debian Release: 8.4
  APT prefers stable-updates
  APT policy: (500, 'stable-updates'), (500, 'proposed-updates'), (500, 'stable'), (1, 'testing')
Architecture: amd64 (x86_64)

Kernel: Linux 4.2.0-0.bpo.1-amd64 (SMP w/2 CPU cores)
Locale: LANG=fr_CA.UTF-8, LC_CTYPE=fr_CA.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

Versions of packages ezstream depends on:
ii  libc6           2.19-18+deb8u4
ii  libogg0         1.3.2-1
ii  libshout3       2.3.1-3
ii  libvorbis0a     1.3.4-2
ii  libvorbisfile3  1.3.4-2
ii  libxml2         2.9.1+dfsg1-5+deb8u1

Versions of packages ezstream recommends:
ii  vorbis-tools  1.4.0-6

Versions of packages ezstream suggests:
pn  ffmpeg2theora  <none>
pn  flac           <none>
ii  icecast2       2.4.0-1.1+deb8u1
pn  madplay        <none>

-- no debconf information

Message #30 received at 573928@bugs.debian.org (full text, mbox, reply):

From: Jonas Smedegaard <dr@jones.dk>

To: Antoine Beaupré <anarcat@debian.org>, 573928@bugs.debian.org

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

Date: Fri, 15 Apr 2016 09:15:12 +0200

[Message part 1 (text/plain, inline)]

Quoting Antoine Beaupré (2016-04-15 00:15:08)
> Ping? It's been 5 years? Can I NMU this?

Sure, you can always NMU.  Thanks!

 - Jonas

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

 [x] quote me freely  [ ] ask before reusing  [ ] keep private

[signature.asc (application/pgp-signature, inline)]

Message #35 received at 573928@bugs.debian.org (full text, mbox, reply):

From: Antoine Beaupré <anarcat@debian.org>

To: Jonas Smedegaard <dr@jones.dk>, 573928@bugs.debian.org

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

Date: Fri, 15 Apr 2016 18:43:51 -0400

[Message part 1 (text/plain, inline)]

On 2016-04-15 03:15:12, Jonas Smedegaard wrote:
> Quoting Antoine Beaupré (2016-04-15 00:15:08)
>> Ping? It's been 5 years? Can I NMU this?
>
> Sure, you can always NMU.  Thanks!

Done, in DELAYED/10. Here's the debdiff:

[ezstream-nmu.diff (text/x-diff, inline)]

diff -u ezstream-0.5.6~dfsg/debian/control ezstream-0.5.6~dfsg/debian/control
--- ezstream-0.5.6~dfsg/debian/control
+++ ezstream-0.5.6~dfsg/debian/control
@@ -3,7 +3,7 @@
 Priority: optional
 Maintainer: Debian Icecast team <pkg-icecast-devel@lists.alioth.debian.org>
 Uploaders: Guillaume Pellerin <yomguy@altern.org>, Romain Beauxis <toots@rastageeks.org>, Jonas Smedegaard <dr@jones.dk>
-Build-Depends: cdbs (>= 0.4.39), devscripts (>= 2.10.7), dh-buildinfo, cdbs (>= 0.4.53), debhelper (>= 7.0.1), libogg-dev (>> 1.1.0), libshout3-dev (>= 2.0-9), libvorbis-dev (>> 1.0.1), libxml2-dev (>= 2.6.11), docbook-to-man, autotools-dev
+Build-Depends: cdbs (>= 0.4.39), devscripts (>= 2.10.7), cdbs (>= 0.4.53), debhelper (>= 7.0.1), libogg-dev (>> 1.1.0), libshout3-dev (>= 2.0-9), libvorbis-dev (>> 1.0.1), libxml2-dev (>= 2.6.11), autotools-dev
 Standards-Version: 3.8.3
 Homepage: http://www.icecast.org/ezstream.php
 Vcs-Svn: svn://svn.debian.org/svn/pkg-icecast/ezstream/trunk
diff -u ezstream-0.5.6~dfsg/debian/rules ezstream-0.5.6~dfsg/debian/rules
--- ezstream-0.5.6~dfsg/debian/rules
+++ ezstream-0.5.6~dfsg/debian/rules
@@ -13,7 +13,6 @@
 include debian/cdbs/1/rules/upstream-tarball.mk
 include debian/cdbs/1/rules/copyright-check.mk
 include /usr/share/cdbs/1/class/autotools.mk
-include debian/cdbs/1/rules/buildinfo.mk
 include /usr/share/cdbs/1/rules/debhelper.mk
 
 DEB_UPSTREAM_URL = http://downloads.us.xiph.org/releases/ezstream
@@ -22,12 +21,6 @@
 # Set examples dir:
 DEB_CONFIGURE_EXTRA_FLAGS := --enable-examplesdir="\$${prefix}/share/doc/ezstream/examples"
 
-build/ezstream::
-	docbook-to-man debian/ezstream.sgml > debian/ezstream.1
-
-cleanbuilddir/ezstream::
-	rm -f debian/ezstream.1
-
 install/ezstream::
 	find debian/ezstream -depth \( -name "COPYING" \) -exec rm -rf {} \;
 	# Remove language-specific extension
reverted:
--- ezstream-0.5.6~dfsg/debian/manpages
+++ ezstream-0.5.6~dfsg.orig/debian/manpages
@@ -1 +0,0 @@
-debian/ezstream.1

[Message part 3 (text/plain, inline)]

a.

-- 
For every complex problem, there is an answer that is clear, simple -
and wrong.
                        - H.L. Mencken

Message #40 received at 573928-close@bugs.debian.org (full text, mbox, reply):

From: Antoine Beaupré <anarcat@debian.org>

To: 573928-close@bugs.debian.org

Subject: Bug#573928: fixed in ezstream 0.5.6~dfsg-1.1

Date: Mon, 25 Apr 2016 23:19:21 +0000

Source: ezstream
Source-Version: 0.5.6~dfsg-1.1

We believe that the bug you reported is fixed in the latest version of
ezstream, which is due to be installed in the Debian FTP archive.

A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 573928@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Antoine Beaupré <anarcat@debian.org> (supplier of updated ezstream package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@ftp-master.debian.org)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

Format: 1.8
Date: Fri, 15 Apr 2016 18:31:02 -0400
Source: ezstream
Binary: ezstream
Architecture: source amd64
Version: 0.5.6~dfsg-1.1
Distribution: unstable
Urgency: medium
Maintainer: Debian Icecast team <pkg-icecast-devel@lists.alioth.debian.org>
Changed-By: Antoine Beaupré <anarcat@debian.org>
Description:
 ezstream   - easy media streaming client over icecast servers
Closes: 573928
Changes:
 ezstream (0.5.6~dfsg-1.1) unstable; urgency=medium
 .
   * Non-maintainer upload.
   * Bug fix: "ezstream manpage is incomplete and incorrect", thanks to
     Philip Muskovac (Closes: #573928).
Checksums-Sha1:
 ea6fe67ce0bfa7cc6c0d1202c383e761078deb63 2154 ezstream_0.5.6~dfsg-1.1.dsc
 3d5ad5d17e29312ae8e95d00f82b1106a48602a7 10860 ezstream_0.5.6~dfsg-1.1.diff.gz
 afa758e0b2ce0d59795c8ae8687abf6e132fb11e 62654 ezstream-dbgsym_0.5.6~dfsg-1.1_amd64.deb
 51244b82dcac9c4be6b149e9faa2e692d99d9b10 66542 ezstream_0.5.6~dfsg-1.1_amd64.deb
Checksums-Sha256:
 fdcd01bbef021c7c6ee9ca7fc9c57f2cc48bdd59859911bc74d1cc24ab425a96 2154 ezstream_0.5.6~dfsg-1.1.dsc
 15387824231113f0174290ce5c48f3633f90d95b12ed9808388c8dcdc141c769 10860 ezstream_0.5.6~dfsg-1.1.diff.gz
 1948b04959b3dc03b5433007951d5a58e7e35360d980e9439f61d5d9c49c0ab5 62654 ezstream-dbgsym_0.5.6~dfsg-1.1_amd64.deb
 faac62a7e08b67cd58989b0ffa6b485ec329d28c0ef8224bdba25974766bd8be 66542 ezstream_0.5.6~dfsg-1.1_amd64.deb
Files:
 908fbe3c114110fde1df7bcb1e492140 2154 sound optional ezstream_0.5.6~dfsg-1.1.dsc
 5f06722d30ad14a3f167a10fe07fc77c 10860 sound optional ezstream_0.5.6~dfsg-1.1.diff.gz
 300c3ba13d136f280c706d22982dd175 62654 debug extra ezstream-dbgsym_0.5.6~dfsg-1.1_amd64.deb
 ada0ac0032583292c7737f5dd525da81 66542 sound optional ezstream_0.5.6~dfsg-1.1_amd64.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1

iQIcBAEBCAAGBQJXEW4aAAoJEHkhUlJ7dZIeoNoQAI2ZhWMu+3fW/qsziztwSpYS
rdAuhahC1ol1v4WWlfpn9vGzLTfqVO6+f2VT1tHdQrUXCp6EdK8f/JsKQWXr7ylk
mNixfj54gm0RWsVmWjMfZaiKsPrxrjIA0U2ADFjkjMwxBgaZHQcATdJ5ToX5GNRa
rE5MKdLWCPWQC8YgOq+fLOjnW4yyeq8xEt0kCTB0SJ1wiTNJwPfbbKU/oo7CH49V
sBAjnYILCoJXhYukxUYLPAkUf5BvkVyBFCak41s9y/ZjSivaX1Q6FL9eTAi+irgv
1pzsimLxuqQhYphCsRn8K12j0d/Amhb7xqJ4ParGv8IGaoAv1H1S4e6x6S+OTTPk
oggg6+1V20ABFEqhn+YtSp8kvBXYkx1PsxgOJAxYKUoGxty+rJQEEaCJy66v0vif
P1XqlYAplUIoWL27R+Ba7aICexO2sbb7swqZbh+0SKANluxAQJrOl9cIPyflrDlZ
Rdxeh+GMTOiXPeQHvFI2lWA49SJiEEFaOi5QVigeZT0ZUW2XU41gU7y46Y3WNJv7
x0Uioa/b+cWQINzdpHQdQFzFeB5Fyqt8z7OliIZ5x7vERz18mUVHl53lYyJDzsWp
jXu2LscHcTnudqH9kBvcs3zD8jAacoyrNWJmbaIklnfrlGtVYagUnoI/vIUEWqhq
2maXwGk4wQdeLrd43Mck
=xhNP
-----END PGP SIGNATURE-----

Send a report that this bug log contains spam.