diff avformat.h @ 2844:440267faee3c libavformat

Document structure change rules with relation to ABI/API.
author michael
date Thu, 20 Dec 2007 09:43:01 +0000
parents e043e56e6e6c
children 625c2c60f585
line wrap: on
line diff
--- 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 */