[xiph-commits] r15597 - trunk/vorbis-tools

[ivo at svn.xiph.org]

Author: ivo
Date: 2008-12-30 17:39:49 -0800 (Tue, 30 Dec 2008)
New Revision: 15597

Modified:
   trunk/vorbis-tools/README
Log:
Add a note on bug #1321, why it won't be fixed and what to do about it.

Modified: trunk/vorbis-tools/README
===================================================================
--- trunk/vorbis-tools/README	2008-12-31 01:37:11 UTC (rev 15596)
+++ trunk/vorbis-tools/README	2008-12-31 01:39:49 UTC (rev 15597)
@@ -4,6 +4,7 @@
 The audio codec libraries for use with Ogg bitstreams are contained in
 other modules: vorbis, speex and flac.
 
+
 DIRECTORIES:
 
 debian/		debian packaging stuff
@@ -12,7 +13,7 @@
 ogg123/		an ogg vorbis command line audio player
 oggenc/		the ogg vorbis encoder
 oggdec/		a simple, portable command line decoder (to wav and raw)
-ogginfo/	provides information (tags, bitrate, length, etc.) about 
+ogginfo/	provides information (tags, bitrate, length, etc.) about
 		an ogg vorbis file
 po/		translations for non-English languages
 share/		code shared between the tools
@@ -20,6 +21,7 @@
 vorbiscomment/	edits the comments in an ogg vorbis file
 win32/		Win32 build stuff
 
+
 DEPENDENCIES:
 
 All of the tools require libogg and libvorbis to be installed (along
@@ -43,6 +45,7 @@
 libkate is available at:
   http://libkate.googlecode.com/
 
+
 CONTACT:
 
 The Ogg Vorbis homepage is located at 'http://www.vorbis.com'. Up to
@@ -52,6 +55,7 @@
 Developer information is available from http://www.xiph.org/. Check
 there for bug reporting information, mailing lists and other resources.
 
+
 BUILDING FROM SUBVERSION (see the file HACKING for details):
 
 ./autogen.sh
@@ -64,6 +68,7 @@
 This will install the tools into /usr/local/bin and manpages into
 /usr/local/man.
 
+
 BUILDING FROM TARBALL DISTRIBUTIONS:
 
 ./configure
@@ -81,3 +86,17 @@
 
 make dist
 rpm -ta vorbis-tools-<version>.tar.gz
+
+
+KNOWN BUGS:
+
+#1321
+  First noticed in non-English versions of the application, ogg123 has a major
+  bug when it comes to status messages in the shell: any output bigger than
+  the console's width will break and start spamming that message infinitely
+  until the console is resized.
+
+  Different attempts to fix this bug have ended up causing bigger problems,
+  leading to the conclusion that it simply can't be fixed without a large
+  re-write of the application, which will not happen any time soon.  If you
+  come across this issue, please augment your terminal window size.
\ No newline at end of file