Add a note on bug #1321, why it won't be fixed and what to do about it.

svn path=/trunk/vorbis-tools/; revision=15597

README

@@ -4,6 +4,7 @@ This source distribution includes the vorbis-tools and nothing else.
 The audio codec libraries for use with Ogg bitstreams are contained in
 other modules: vorbis, speex and flac.
 
+
 DIRECTORIES:
 
 debian/		debian packaging stuff
@@ -12,14 +13,15 @@ intl/		GNU gettext library from gettext-0.10.40 (for i18n support)
 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
 vcut/		cuts an ogg vorbis file into two parts at a particular point
 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 @@ Speex is available at:
 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 @@ pre-built utilities may be found there.
 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 @@ make install
 This will install the tools into /usr/local/bin and manpages into
 /usr/local/man.
 
+
 BUILDING FROM TARBALL DISTRIBUTIONS:
 
 ./configure
@@ -81,3 +86,17 @@ after autogen.sh or configure
 
 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.