[FFmpeg-cvslog] r22028 - trunk/libavformat/avformat.h

[rbultje]

Author: rbultje
Date: Wed Feb 24 19:01:44 2010
New Revision: 22028

Log:
Mention that metadata tags are (unvalidated) UTF-8.

Patch by Anton Khirnov <wyskas gmail com>.

Modified:
   trunk/libavformat/avformat.h

Modified: trunk/libavformat/avformat.h
==============================================================================
--- trunk/libavformat/avformat.h	Wed Feb 24 17:16:08 2010	(r22027)
+++ trunk/libavformat/avformat.h	Wed Feb 24 19:01:44 2010	(r22028)
@@ -63,7 +63,9 @@ struct AVFormatContext;
 /*
  * Public Metadata API.
  * The metadata API allows libavformat to export metadata tags to a client
- * application using a sequence of key/value pairs.
+ * application using a sequence of key/value pairs. Like all strings in FFmpeg,
+ * metadata must be stored as UTF-8 encoded Unicode. Note that metadata
+ * exported by demuxers isn't checked to be valid UTF-8 in most cases.
  * Important concepts to keep in mind:
  * 1. Keys are unique; there can never be 2 tags with the same key. This is
  *    also meant semantically, i.e., a demuxer should not knowingly produce