[SCM] libav/experimental: 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

[siretart at users.alioth.debian.org]

The following commit has been merged in the experimental branch:
commit 6d96a9b94dd395d2e23f50fcc30c4456aa5d2fa0
Author: Michael Niedermayer <michaelni at gmx.at>
Date:   Thu Aug 16 12:07:05 2007 +0000

    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
    
    Originally committed as revision 10122 to svn://svn.ffmpeg.org/ffmpeg/trunk

diff --git a/libavformat/avformat.h b/libavformat/avformat.h
index 4ef2836..4a4c240 100644
--- a/libavformat/avformat.h
+++ b/libavformat/avformat.h
@@ -308,7 +308,13 @@ typedef struct AVStream {
     /** 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;

-- 
Libav/FFmpeg packaging