# HG changeset patch
# User michael
# Date 1198143781 0
# Node ID 440267faee3cfa7a867d9c8763bb0f93615345a7
# Parent  7a6b7595f933f52c98cf14005078eecf504b9596
Document structure change rules with relation to ABI/API.

diff -r 7a6b7595f933 -r 440267faee3c avformat.h
--- a/avformat.h	Thu Dec 20 00:26:53 2007 +0000
+++ b/avformat.h	Thu Dec 20 09:43:01 2007 +0000
@@ -358,7 +358,13 @@
 
 #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 */