[vorbis-tools] 01/02: Make it clear in documentation that -f needs a previous -d.

[Martin Steghöfer]

This is an automated email from the git hooks/post-receive script.

martin.steghoefer-guest pushed a commit to branch master
in repository vorbis-tools.

commit db2783567426b24140243a2b5d33153920e16e96
Author: Martin Steghöfer <martin at steghoefer.eu>
Date:   Wed Oct 29 20:07:35 2014 +0100

    Make it clear in documentation that -f needs a previous -d.
    
    Closes: #359948
---
 ...ar-in-documentation-that-f-needs-a-previo.patch | 40 ++++++++++++++++++++++
 debian/patches/series                              |  1 +
 2 files changed, 41 insertions(+)

diff --git a/debian/patches/0008-Make-it-clear-in-documentation-that-f-needs-a-previo.patch b/debian/patches/0008-Make-it-clear-in-documentation-that-f-needs-a-previo.patch
new file mode 100644
index 0000000..d2b2ff7
--- /dev/null
+++ b/debian/patches/0008-Make-it-clear-in-documentation-that-f-needs-a-previo.patch
@@ -0,0 +1,40 @@
+From: =?utf-8?q?Martin_Stegh=C3=B6fer?= <martin at steghoefer.eu>
+Date: Wed, 29 Oct 2014 20:06:34 +0100
+Subject: Make it clear in documentation that -f needs a previous -d.
+
+Bug-Debian: https://bugs.debian.org/359948
+Forwarded: https://trac.xiph.org/ticket/1679
+
+The -f option to specify an output file name works only if a file device has previously been specified using the -d option. Some parts of the documentation don't make it very explicit that -f needs -d and that the -d option has to precede the -f option.
+---
+ ogg123/cmdline_options.c | 2 +-
+ ogg123/ogg123.1          | 3 ++-
+ 2 files changed, 3 insertions(+), 2 deletions(-)
+
+diff --git a/ogg123/cmdline_options.c b/ogg123/cmdline_options.c
+index d663cc6..619b4f5 100644
+--- a/ogg123/cmdline_options.c
++++ b/ogg123/cmdline_options.c
+@@ -140,7 +140,7 @@ int parse_cmdline_options (int argc, char **argv,
+ 	    exit(1);
+ 	  }
+ 	} else {
+-	  status_error(_("=== Cannot specify output file without specifying a driver.\n"));
++	  status_error(_("=== Cannot specify output file without previously specifying a driver.\n"));
+ 	  exit (1);
+ 	}
+ 	break;
+diff --git a/ogg123/ogg123.1 b/ogg123/ogg123.1
+index 160a876..7b434c6 100644
+--- a/ogg123/ogg123.1
++++ b/ogg123/ogg123.1
+@@ -69,7 +69,8 @@ Specify output device.  See
+ .B DEVICES
+ section for a list of devices.  Any number of devices may be specified.
+ .IP "-f filename, --file filename"
+-Specify output file for file devices.  The filename "-" writes to standard
++Specify output file for a file device previously specified with
++--device.  The filename "-" writes to standard
+ out.  If the file already exists,
+ .B ogg123
+ will overwrite it.
diff --git a/debian/patches/series b/debian/patches/series
index 0f0e6dd..bafe760 100644
--- a/debian/patches/series
+++ b/debian/patches/series
@@ -5,3 +5,4 @@
 0005-Fix-URL-in-manpage.patch
 0006-Add-sampling-rate-sanity-check-to-avoid-crash.patch
 0007-Fix-ogg123-freeze-when-interrupting-at-End-Of-Stream.patch
+0008-Make-it-clear-in-documentation-that-f-needs-a-previo.patch

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-xiph/vorbis-tools.git