[xiph-commits] r13627 - trunk/ezstream/doc

[moritz at svn.xiph.org]

Author: moritz
Date: 2007-08-25 08:07:38 -0700 (Sat, 25 Aug 2007)
New Revision: 13627

Modified:
   trunk/ezstream/doc/ezstream.1.in
Log:
Expand the "Metadata Caveats" subsection wrt codesets and actual abilities of
ezstream and Icecast.


Modified: trunk/ezstream/doc/ezstream.1.in
===================================================================
--- trunk/ezstream/doc/ezstream.1.in	2007-08-25 14:37:42 UTC (rev 13626)
+++ trunk/ezstream/doc/ezstream.1.in	2007-08-25 15:07:38 UTC (rev 13627)
@@ -557,6 +557,26 @@
 feature will continue to end up entirely in the
 .Qq Em Title
 field of a stream.
+.Pp
+Of all possible Ogg-based streams, only Ogg Vorbis can have its metadata
+manipulated by Icecast.
+Any attempt of
+.Nm
+to update other Ogg metadata is actually a no-op.
+.Pp
+While
+.Nm
+tries to do its best with relaying metadata accurately to Icecast, and
+subsequently the listeners, different codesets and locales can pose a problem.
+Especially when streaming MP3 files, it may help to explicitly set a codeset
+to work with via the
+.Ev LC_CTYPE
+environment variable.
+Note that non-Ogg streams are restricted to the ISO-8859-1 character set.
+Ogg-based streams use UTF-8.
+.Pp
+External encoders may put additional, and possibly artificial, restrictions on
+valid characters in metadata.
 .Sh FILES
 .Bl -tag -width "!!EXAMPLES_DIR!!" -compact
 .It Pa !!EXAMPLES_DIR!!