From 7e56cd927b5842fa74ec8b5fddf6ac2b6a40145c Mon Sep 17 00:00:00 2001
From: Mike Melanson <mike@multimedia.cx>
Date: Sat, 24 Apr 2004 19:30:49 +0000
Subject: [PATCH] add the minimal documentation to make this decoder useful

Originally committed as revision 3059 to svn://svn.ffmpeg.org/ffmpeg/trunk
---
 libavcodec/wmadec.c | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/libavcodec/wmadec.c b/libavcodec/wmadec.c
index 25498c4d28c..cf2db149462 100644
--- a/libavcodec/wmadec.c
+++ b/libavcodec/wmadec.c
@@ -20,6 +20,15 @@
 /**
  * @file wmadec.c
  * WMA compatible decoder.
+ * This decoder handles Microsoft Windows Media Audio data, versions 1 & 2.
+ * WMA v1 is identified by audio format 0x160 in Microsoft media files 
+ * (ASF/AVI/WAV). WMA v2 is identified by audio format 0x161.
+ *
+ * To use this decoder, a calling application must supply the extra data
+ * bytes provided with the WMA data. These are the extra, codec-specific
+ * bytes at the end of a WAVEFORMATEX data structure. Transmit these bytes 
+ * to the decoder using the extradata[_size] fields in AVCodecContext. There 
+ * should be 4 extra bytes for v1 data and 6 extra bytes for v2 data.
  */
 
 #include "avcodec.h"
-- 
GitLab