# HG changeset patch
# User michael
# Date 1187266025 0
# Node ID 2beaa59babad35aadc0bb88c854ab8b4708e33d9
# Parent  8a7b2fac0a9837809107e0ad71726f895afcf678
elaborate a little on AVStream.start_time, it seems the comment is not clear
enough, not that the clearer NEVER comment in AVFormatContext.start_time stoped
people from posting stupid patches

diff -r 8a7b2fac0a98 -r 2beaa59babad avformat.h
--- a/avformat.h	Tue Aug 14 15:51:30 2007 +0000
+++ b/avformat.h	Thu Aug 16 12:07:05 2007 +0000
@@ -308,7 +308,13 @@
     /** quality, as it has been removed from AVCodecContext and put in AVVideoFrame
      * MN: dunno if that is the right place for it */
     float quality;
-    /** decoding: pts of the first frame of the stream, in stream time base. */
+    /**
+     * decoding: pts of the first frame of the stream, in stream time base.
+     * only set this if you are absolutely 100% sure that the value you set
+     * it to really is the pts of the first frame
+     * @note the ASF header does NOT contain a correct start_time the ASF
+     * demuxer must NOT set this
+     */
     int64_t start_time;
     /** decoding: duration of the stream, in stream time base. */
     int64_t duration;