Bug#353186: 'man oggenc' typos: four missing "-o" switches in examples

[A. Costa]

Package: vorbis-tools
Version: 1.1.1-3
Severity: important
Tags: patch


Found some bad examples in '/usr/share/man/man1/oggenc.1.gz', see attached '.diff'.

Details:

    % man oggenc | grep -n " -b 256 out.ogg"
    270:              oggenc infile.wav -b 256 out.ogg

    # now run that code
    % oggenc infile.wav -b 256 out.ogg
    Opening with wav module: WAV file reader
    Encoding "infile.wav" to
             "infile.ogg"
    {etc...}
    Done encoding file "infile.ogg"
    {etc...}
    ERROR: Cannot open input file "out.ogg": No such file or directory

...here the output is "infile.ogg", and the intended output file is
mistaken for nonexistant input.

This bug caused, (using one of those examples caused), a copy
of an .ogg file I wanted to keep to be overwritten with a downsampled
version.  That is, users can lose data, hence the 'important'
severity.  (Not me though, I had a backup.)


Hope this helps...

-- System Information:
Debian Release: testing/unstable
  APT prefers unstable
  APT policy: (500, 'unstable'), (1, 'experimental')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.15-1-686
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968) (ignored: LC_ALL set to C)

Versions of packages vorbis-tools depends on:
ii  libao2                        0.8.6-3    Cross Platform Audio Output Librar
ii  libc6                         2.3.6-1    GNU C Library: Shared libraries an
ii  libcurl3-gnutls               7.15.1-1   Multi-protocol file transfer libra
ii  libflac7                      1.1.2-3+b1 Free Lossless Audio Codec - runtim
ii  libogg0                       1.1.3-2    Ogg Bitstream Library
ii  liboggflac3                   1.1.2-3+b1 Free Lossless Audio Codec - runtim
ii  libspeex1                     1.1.11.1-1 The Speex Speech Codec
ii  libvorbis0a                   1.1.2-1    The Vorbis General Audio Compressi
ii  libvorbisenc2                 1.1.2-1    The Vorbis General Audio Compressi
ii  libvorbisfile3                1.1.2-1    The Vorbis General Audio Compressi

vorbis-tools recommends no packages.

-- no debconf information


-------------- next part --------------
--- oggenc.1	2006-01-16 17:32:56.000000000 -0500
+++ /tmp/oggenc.1	2006-02-16 13:22:30.000000000 -0500
@@ -293,25 +293,25 @@
 
 Specifying a high-quality encoding averaging 256 kbps (but still VBR).
 .RS
-oggenc infile.wav -b 256 out.ogg
+oggenc infile.wav -b 256 -o out.ogg
 .RE
 .PP
 
 Specifying a maximum and average bitrate, and enforcing these.
 .RS
-oggenc infile.wav --managed -b 128 -M 160 out.ogg
+oggenc infile.wav --managed -b 128 -M 160 -o out.ogg
 .RE
 .PP
 
 Specifying quality rather than bitrate (to a very high quality mode)
 .RS
-oggenc infile.wav -q 6 out.ogg
+oggenc infile.wav -q 6 -o out.ogg
 .RE
 .PP
 
 Downsampling and downmixing to 11 kHz mono before encoding.
 .RS
-oggenc --resample 11025 --downmix infile.wav -q 1 out.ogg
+oggenc --resample 11025 --downmix infile.wav -q 1 -o out.ogg
 .RE
 .PP