[SCM] libav/experimental: Document structure change rules with relation to ABI/API.

[siretart at users.alioth.debian.org]

The following commit has been merged in the experimental branch:
commit 252f17e292064da25a82c99bf1f752ed5fedd434
Author: Michael Niedermayer <michaelni at gmx.at>
Date:   Thu Dec 20 09:43:01 2007 +0000

    Document structure change rules with relation to ABI/API.
    
    Originally committed as revision 11281 to svn://svn.ffmpeg.org/ffmpeg/trunk

diff --git a/libavcodec/avcodec.h b/libavcodec/avcodec.h
index a32f961..98d1489 100644
--- a/libavcodec/avcodec.h
+++ b/libavcodec/avcodec.h
@@ -753,7 +753,11 @@ typedef struct AVFrame {
 #define DEFAULT_FRAME_RATE_BASE 1001000
 
 /**
- * main external API structure
+ * main external API structure.
+ * New fields can be added to the end with minor version bumps.
+ * Removial, reordering and changes to existing fields require a Major
+ * version bump.
+ * sizeof(AVCodecContext) must not be used outside libav*
  */
 typedef struct AVCodecContext {
     /**
diff --git a/libavformat/avformat.h b/libavformat/avformat.h
index c0ad4a6..bbe818f 100644
--- a/libavformat/avformat.h
+++ b/libavformat/avformat.h
@@ -358,7 +358,13 @@ typedef struct AVProgram {
 
 #define MAX_STREAMS 20
 
-/* format I/O context */
+/**
+ * format I/O context.
+ * New fields can be added to the end with minor version bumps.
+ * Removial, reordering and changes to existing fields require a Major
+ * version bump.
+ * sizeof(AVFormatContext) must not be used outside libav*
+ */
 typedef struct AVFormatContext {
     const AVClass *av_class; /**< set by av_alloc_format_context */
     /* can only be iformat or oformat, not both at the same time */

-- 
Libav/FFmpeg packaging