[SCM] libav/experimental: More detailed documentation patch by Nicolas George: [nicolas george normalesup org]

[siretart at users.alioth.debian.org]

The following commit has been merged in the experimental branch:
commit 6b0cdb6e04b3ec1efe7a290b2d6ba805a3e804aa
Author: Nicolas George <nicola.george at normalesup.org>
Date:   Thu Jun 14 07:28:16 2007 +0000

    More detailed documentation
    patch by Nicolas George: [nicolas george normalesup org]
    
    Originally committed as revision 9305 to svn://svn.ffmpeg.org/ffmpeg/trunk

diff --git a/libavcodec/avcodec.h b/libavcodec/avcodec.h
index 19dc0ed..acb7445 100644
--- a/libavcodec/avcodec.h
+++ b/libavcodec/avcodec.h
@@ -44,6 +44,12 @@
 #define AV_TIME_BASE_Q          (AVRational){1, AV_TIME_BASE}
 
 /**
+ * Identifies the syntax and semantics of the bitstream.
+ * The principle is roughly:
+ * Two decoders with the same ID can decode the same streams.
+ * Two encoders with the same ID can encode compatible streams.
+ * There may be slight deviations from the principle due to implementation
+ * details.
  *
  * If you add a codec ID to this list, add it so that
  * 1. no value of a existing codec ID changes (that would break ABI),
@@ -2119,6 +2125,12 @@ typedef struct AVCodecContext {
  * AVCodec.
  */
 typedef struct AVCodec {
+    /**
+     * Name of the codec implementation.
+     * The name is globally unique among encoders and among decoders (but an
+     * encoder and a decoder can share the same name).
+     * This is the primary way to find a codec from the user perspective.
+     */
     const char *name;
     enum CodecType type;
     enum CodecID id;

-- 
Libav/FFmpeg packaging