Bug#739099: vorbis-tools: ogg123 manpage inadequately documents -d option

[Paul LeoNerd Evans]

Package: vorbis-tools
Version: 1.4.0-1
Severity: minor
Tags: upstream

The manpage briefly mentions the -d option, and says it takes such
choices as 'alsa'. It further mentions that the 'alsa' option has some
sub-parameters.

However, the manpage doesn't include a sufficiently-clear example or
explanation on how to build the actual value for the -d option to
contain these options. Are they comma-separated? Colons? Use name=value
or name:value, or what..?

-- System Information:
Debian Release: jessie/sid
  APT prefers testing
  APT policy: (990, 'testing'), (500, 'unstable')
Architecture: amd64 (x86_64)

Kernel: Linux 3.2.0-4-amd64 (SMP w/4 CPU cores)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages vorbis-tools depends on:
ii  libao4           1.1.0-2
ii  libc6            2.17-97
ii  libcurl3-gnutls  7.34.0-1
ii  libflac8         1.3.0-2
ii  libogg0          1.3.1-1
ii  libspeex1        1.2~rc1.1-1
ii  libvorbis0a      1.3.2-1.3
ii  libvorbisenc2    1.3.2-1.3
ii  libvorbisfile3   1.3.2-1.3

vorbis-tools recommends no packages.

vorbis-tools suggests no packages.

-- no debconf information