diff --git a/libavcodec/a52dec.c b/libavcodec/a52dec.c
index c9f22a981d83c1333c07196aff853f542803a29f..fb169c7ee38d4177ec8d168a9f38c23f9480d0da 100644
--- a/libavcodec/a52dec.c
+++ b/libavcodec/a52dec.c
@@ -16,6 +16,12 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+
+/**
+ * @file a52dec.c
+ * A52 decoder.
+ */
+
 #include "avcodec.h"
 #include "liba52/a52.h"
 
diff --git a/libavcodec/ac3.h b/libavcodec/ac3.h
index 51583edfa99130da20550d24d8a696bd5e053316..1e8a5ba2db4c1fdf1beec2f43961a1099a8d6615 100644
--- a/libavcodec/ac3.h
+++ b/libavcodec/ac3.h
@@ -17,6 +17,11 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
 
+/**
+ * @file ac3.h
+ * Common code between AC3 encoder and decoder.
+ */
+
 #define AC3_MAX_CODED_FRAME_SIZE 3840 /* in bytes */
 #define AC3_MAX_CHANNELS 6 /* including LFE channel */
 
diff --git a/libavcodec/ac3dec.c b/libavcodec/ac3dec.c
index 62a7cdfaf38923d4115b90743e33825bb0bc1a69..53bfa56a854e9f065ad4ab5870d710909fba567f 100644
--- a/libavcodec/ac3dec.c
+++ b/libavcodec/ac3dec.c
@@ -16,6 +16,14 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+
+/**
+ * @file ac3dec.c
+ * AC3 decoder.
+ */
+
+//#define DEBUG
+
 #include "avcodec.h"
 #include "libac3/ac3.h"
 
diff --git a/libavcodec/ac3enc.c b/libavcodec/ac3enc.c
index bd29b2b46d484ef42758ff3c8053910a476a0ade..3e83fb1fcf3965d265af3d6ffb2a83a13a173023 100644
--- a/libavcodec/ac3enc.c
+++ b/libavcodec/ac3enc.c
@@ -16,6 +16,11 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+
+/**
+ * @file ac3enc.c
+ * The simplest AC3 encoder.
+ */
 //#define DEBUG
 //#define DEBUG_BITALLOC
 #include "avcodec.h"
diff --git a/libavcodec/ac3tab.h b/libavcodec/ac3tab.h
index 65345deb46eb65b531a21f337229827987195a22..5d404b539059f199b50408c937a69c82ce587c9b 100644
--- a/libavcodec/ac3tab.h
+++ b/libavcodec/ac3tab.h
@@ -1,4 +1,7 @@
-/* tables taken directly from AC3 spec */
+/**
+ * @file ac3tab.h
+ * tables taken directly from AC3 spec.
+ */
 
 /* possible frequencies */
 const uint16_t ac3_freqs[3] = { 48000, 44100, 32000 };
diff --git a/libavcodec/adpcm.c b/libavcodec/adpcm.c
index 8f6863cb017cae413ceb7dac63ce439708248462..e94d16b5136d6db9e8b3b89fdade754d3fc60a56 100644
--- a/libavcodec/adpcm.c
+++ b/libavcodec/adpcm.c
@@ -18,7 +18,9 @@
  */
 #include "avcodec.h"
 
-/*
+/**
+ * @file adpcm.c
+ * ADPCM codecs.
  * First version by Francois Revol revol@free.fr
  *
  * Features and limitations:
@@ -47,7 +49,8 @@ static const int index_table[16] = {
     -1, -1, -1, -1, 2, 4, 6, 8,
 };
 
-/* This is the step table. Note that many programs use slight deviations from
+/** 
+ * This is the step table. Note that many programs use slight deviations from
  * this table, but such deviations are negligible:
  */
 static const int step_table[89] = {
diff --git a/libavcodec/allcodecs.c b/libavcodec/allcodecs.c
index bc8bedcca6d569d7f067416a9f3f8e43ff4adf4e..51c340222926fdb1d3e4ee5190ec524356e65f04 100644
--- a/libavcodec/allcodecs.c
+++ b/libavcodec/allcodecs.c
@@ -16,6 +16,12 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+
+/**
+ * @file allcodecs.c
+ * Utils for libavcodec.
+ */
+
 #include "avcodec.h"
 
 /* If you do not call this function, then you can select exactly which
diff --git a/libavcodec/apiexample.c b/libavcodec/apiexample.c
index 303082cdbdfeea00ac425ffbedb36a9533a0f61a..530ae74cd1c28e7bde7d2ac5ba58ab5fe72fd6c1 100644
--- a/libavcodec/apiexample.c
+++ b/libavcodec/apiexample.c
@@ -1,9 +1,12 @@
-/* avcodec API use example.
+/**
+ * @file apiexample.c
+ * avcodec API use example.
  *
  * Note that this library only handles codecs (mpeg, mpeg4, etc...),
  * not file formats (avi, vob, etc...). See library 'libav' for the
  * format handling 
  */
+
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/libavcodec/avcodec.c b/libavcodec/avcodec.c
index b1fb5c88a84db75bdffbfb6559c786929354d53a..4f4114cda96d5fa1750e044d5eaae3aed3f8efb1 100644
--- a/libavcodec/avcodec.c
+++ b/libavcodec/avcodec.c
@@ -1,3 +1,8 @@
+/**
+ * @file avcodec.c
+ * avcodec.
+ */
+
 #include "errno.h"
 #include "avcodec.h"
 
diff --git a/libavcodec/bswap.h b/libavcodec/bswap.h
index bdc8212aeee1f1c4fb1e76742eac32f0a7554f52..035216dddde3fcbc17bc42a8deeb66ab102157da 100644
--- a/libavcodec/bswap.h
+++ b/libavcodec/bswap.h
@@ -1,3 +1,8 @@
+/**
+ * @file bswap.h
+ * byte swap.
+ */
+
 #ifndef __BSWAP_H__
 #define __BSWAP_H__
 
diff --git a/libavcodec/common.c b/libavcodec/common.c
index 58d79a9a0a5e40e7305cb463f1ce47d52dd854ee..96d0afcbe59b37bbeb6110e2b2d4e5e45c29f6fc 100644
--- a/libavcodec/common.c
+++ b/libavcodec/common.c
@@ -18,6 +18,12 @@
  *
  * alternative bitstream reader & writer by Michael Niedermayer <michaelni@gmx.at>
  */
+
+/**
+ * @file common.c
+ * common internal api.
+ */
+
 #include "avcodec.h"
 
 const uint8_t ff_sqrt_tab[128]={
diff --git a/libavcodec/common.h b/libavcodec/common.h
index 175eb741ffde0b2f25c1b02f391e255729cacaaa..b65e8bd991bfd869545fa3157465e3ee0b75e445 100644
--- a/libavcodec/common.h
+++ b/libavcodec/common.h
@@ -1,3 +1,8 @@
+/**
+ * @file common.h
+ * common internal api header.
+ */
+
 #ifndef COMMON_H
 #define COMMON_H
 
diff --git a/libavcodec/cyuv.c b/libavcodec/cyuv.c
index 5edd3aa9c0ca1ee1c1958670eb8da7b82b6aae48..1bf676a434df1b1cb12ee9515432ab848c49d3ee 100644
--- a/libavcodec/cyuv.c
+++ b/libavcodec/cyuv.c
@@ -23,6 +23,11 @@
  *
  */
 
+/**
+ * @file cyuv.c 
+ * Creative YUV (CYUV) Video Decoder.
+ */
+ 
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
diff --git a/libavcodec/dct-test.c b/libavcodec/dct-test.c
index 29410ca5af72a8a27235e930c5a0bb8212ce452d..5f8473accc48f20dfbc19f81c685cb3b1e2023eb 100644
--- a/libavcodec/dct-test.c
+++ b/libavcodec/dct-test.c
@@ -1,6 +1,9 @@
-/* DCT test. (c) 2001 Fabrice Bellard. 
-   Started from sample code by Juan J. Sierralta P.
-*/
+/**
+ * @file dct-test.c
+ * DCT test. (c) 2001 Fabrice Bellard. 
+ * Started from sample code by Juan J. Sierralta P.
+ */
+
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/libavcodec/dsputil.c b/libavcodec/dsputil.c
index 7fdf0decd54760b44224c921467dd586e8c6efc1..5f4190f755624b311b94b761a5b706e353fabc1c 100644
--- a/libavcodec/dsputil.c
+++ b/libavcodec/dsputil.c
@@ -18,6 +18,12 @@
  *
  * gmc & q-pel & 32/64 bit based MC by Michael Niedermayer <michaelni@gmx.at>
  */
+ 
+/**
+ * @file dsputil.c
+ * DSP utils
+ */
+ 
 #include "avcodec.h"
 #include "dsputil.h"
 #include "mpegvideo.h"
diff --git a/libavcodec/dsputil.h b/libavcodec/dsputil.h
index c16d56335468d4f6c498cc26c6a11346ec8dceb2..0a06b4a545a1c4277bd4a999bb6ab6f3642ea02d 100644
--- a/libavcodec/dsputil.h
+++ b/libavcodec/dsputil.h
@@ -19,8 +19,7 @@
 
 /**
  * @file dsputil.h
- * @brief DSP utils
- *
+ * DSP utils.
  */
 
 #ifndef DSPUTIL_H
diff --git a/libavcodec/dv.c b/libavcodec/dv.c
index c9a1f4796bb345d57c74cf49b34d9b5a1d29b938..9e89b3ac15a666871b2bcef7c061371864b8accc 100644
--- a/libavcodec/dv.c
+++ b/libavcodec/dv.c
@@ -16,6 +16,11 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+
+/**
+ * @file dv.c
+ * DV decoder.
+ */
 #include "avcodec.h"
 #include "dsputil.h"
 #include "mpegvideo.h"
diff --git a/libavcodec/dvdata.h b/libavcodec/dvdata.h
index 83dd955d3c05788c17925b7136ba9508de71b64a..29aea40224d1f9594b43fd9d92e4256b0b80959a 100644
--- a/libavcodec/dvdata.h
+++ b/libavcodec/dvdata.h
@@ -17,6 +17,11 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
 
+/**
+ * @file dvdata.h
+ * Constants for DV codec.
+ */
+ 
 #define NB_DV_VLC 409
 #define AAUX_OFFSET (80*6 + 80*16*3 + 3)
 
diff --git a/libavcodec/error_resilience.c b/libavcodec/error_resilience.c
index 195f31fce6611556ba02f3c72852b65367519733..d58cfb03044a2a7603ae2925b924999f4b29cf00 100644
--- a/libavcodec/error_resilience.c
+++ b/libavcodec/error_resilience.c
@@ -17,6 +17,11 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+ 
+/**
+ * @file error_resilience.c
+ * Error resilience / concealment.
+ */
 
 #include "avcodec.h"
 #include "dsputil.h"
diff --git a/libavcodec/eval.c b/libavcodec/eval.c
index 1a9cce6add0a58a8c5a367fa289e85c3fa87e5e3..28a492cd4b4694843ad980d4b52225cfb3253ca7 100644
--- a/libavcodec/eval.c
+++ b/libavcodec/eval.c
@@ -19,7 +19,10 @@
  *
  */
 
- /*
+/**
+ * @file eval.c
+ * simple arithmetic expression evaluator.
+ *
  * see http://joe.hotchkiss.com/programming/eval/eval.html
  */
 
diff --git a/libavcodec/fdctref.c b/libavcodec/fdctref.c
index ae376f7941da799db7ea947a5cce83a4ff2a6807..d728727ce64707c16078604ee2c8200ffa9a6ba0 100644
--- a/libavcodec/fdctref.c
+++ b/libavcodec/fdctref.c
@@ -1,4 +1,7 @@
-/* fdctref.c, forward discrete cosine transform, double precision           */
+/**
+ * @file fdctref.c
+ * forward discrete cosine transform, double precision.
+ */
 
 /* Copyright (C) 1996, MPEG Software Simulation Group. All Rights Reserved. */
 
diff --git a/libavcodec/fft-test.c b/libavcodec/fft-test.c
index 09f45c70960fb2190c0c6632e921b1f993391d97..4a3ac9f54025b00b2045e660595d58aa35eba18c 100644
--- a/libavcodec/fft-test.c
+++ b/libavcodec/fft-test.c
@@ -1,4 +1,8 @@
-/* FFT and MDCT tests */
+/**
+ * @file fft-test.c
+ * FFT and MDCT tests.
+ */
+
 #include "dsputil.h"
 #include <math.h>
 #include <unistd.h>
diff --git a/libavcodec/fft.c b/libavcodec/fft.c
index 65eb575f36c64b0f443586b29b8b0474ae0561e8..3b5244a077134ac2a312dfeb61f4b819d3cfbb6d 100644
--- a/libavcodec/fft.c
+++ b/libavcodec/fft.c
@@ -16,6 +16,12 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+
+/**
+ * @file fft.c
+ * FFT/IFFT transforms.
+ */
+
 #include "dsputil.h"
 
 /**
diff --git a/libavcodec/h263.c b/libavcodec/h263.c
index 9781a1ba843b21e6dd52301ec295f66cd4bd204f..05f4baf2861cf7d0840469fc75ba09ab33b67e13 100644
--- a/libavcodec/h263.c
+++ b/libavcodec/h263.c
@@ -25,8 +25,7 @@
 
 /**
  * @file h263.c
- * @brief h263/mpeg4 codec
- *
+ * h263/mpeg4 codec.
  */
  
 //#define DEBUG
diff --git a/libavcodec/h263data.h b/libavcodec/h263data.h
index 840d64aa12550f9b509f3c4fc30dbe74def0df81..132ed98a9b8ba7ef268d4c9846d9f1c1ed917517 100644
--- a/libavcodec/h263data.h
+++ b/libavcodec/h263data.h
@@ -1,3 +1,8 @@
+/**
+ * @file h263data.h
+ * H.263 tables.
+ */
+
 
 /* intra MCBPC, mb_type = (intra), then (intraq) */
 const uint8_t intra_MCBPC_code[8] = { 1, 1, 2, 3, 1, 1, 2, 3 };
diff --git a/libavcodec/h263dec.c b/libavcodec/h263dec.c
index e1ee79a166f8ae2cd30a35ac6f62b4cbc57857bc..9d797f5e9722e138d076f162f14525b8630e8ff5 100644
--- a/libavcodec/h263dec.c
+++ b/libavcodec/h263dec.c
@@ -1,5 +1,5 @@
 /*
- * H263 decoder
+ * H.263 decoder
  * Copyright (c) 2001 Fabrice Bellard.
  *
  * This library is free software; you can redistribute it and/or
@@ -16,6 +16,12 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+ 
+/**
+ * @file h263dec.c
+ * H.263 decoder.
+ */
+ 
 #include "avcodec.h"
 #include "dsputil.h"
 #include "mpegvideo.h"
diff --git a/libavcodec/huffyuv.c b/libavcodec/huffyuv.c
index 909c2a153718e2fbae9577250c1415b5ac7bbbfa..7823f0bf1cbaa4981ab17e9dff264eba14bf65fe 100644
--- a/libavcodec/huffyuv.c
+++ b/libavcodec/huffyuv.c
@@ -20,6 +20,11 @@
  * see http://www.pcisys.net/~melanson/codecs/huffyuv.txt for a description of
  * the algorithm used 
  */
+ 
+/**
+ * @file huffyuv.c
+ * huffyuv codec for libavcodec.
+ */
 
 #include "common.h"
 #include "avcodec.h"
diff --git a/libavcodec/imgconvert.c b/libavcodec/imgconvert.c
index cfebe2477c4bae60a37c300ee0d8e233babba589..9d833ccc51bc7a840cc5906d04af84aa0ef7d562 100644
--- a/libavcodec/imgconvert.c
+++ b/libavcodec/imgconvert.c
@@ -16,6 +16,13 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+
+/**
+ * @imgconvert.c
+ * Misc image convertion routines.
+ */
+
+
 #include "avcodec.h"
 #include "dsputil.h"
 
diff --git a/libavcodec/imgresample.c b/libavcodec/imgresample.c
index 2e67fecb3d093133d43bf39b1f123e3ca8add4ec..140894d3654e4348133ac35ca539facfbb6ea8c0 100644
--- a/libavcodec/imgresample.c
+++ b/libavcodec/imgresample.c
@@ -16,6 +16,12 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+ 
+/**
+ * @file imgresample.c
+ * High quality image resampling with polyphase filters .
+ */
+ 
 #include "avcodec.h"
 #include "dsputil.h"
 
diff --git a/libavcodec/jfdctfst.c b/libavcodec/jfdctfst.c
index dd496b816e4437a98fe5c88f6652ba4fc3ebb1f1..899768d361f163a40965ae18be6b7090882e6821 100644
--- a/libavcodec/jfdctfst.c
+++ b/libavcodec/jfdctfst.c
@@ -30,6 +30,11 @@
  * quality-setting files than with low-quality ones.
  */
 
+/**
+ * @file jfdctfst.c
+ * Independent JPEG Group's fast AAN dct.
+ */
+ 
 #include <stdlib.h>
 #include <stdio.h>
 #include "common.h"
diff --git a/libavcodec/jfdctint.c b/libavcodec/jfdctint.c
index 97de639bb7f98f759f22ad63653ab3e125782d42..702d0a9476e19967edbdfd49d9ad65a833efe05f 100644
--- a/libavcodec/jfdctint.c
+++ b/libavcodec/jfdctint.c
@@ -23,6 +23,11 @@
  * scaled fixed-point arithmetic, with a minimal number of shifts.
  */
 
+/**
+ * @file jfdctint.c
+ * Independent JPEG Group's slow & accurate dct.
+ */
+ 
 #include <stdlib.h>
 #include <stdio.h>
 #include "common.h"
diff --git a/libavcodec/jrevdct.c b/libavcodec/jrevdct.c
index 07d8ce81604329a4b420349abb85f0808a21ce5e..3bd78c1925115995148ec203d8d373c08258f162 100644
--- a/libavcodec/jrevdct.c
+++ b/libavcodec/jrevdct.c
@@ -25,6 +25,12 @@
  * A better way to do this would be to pass in the DCT block as a sparse
  * matrix, perhaps with the difference cases encoded.
  */
+ 
+/**
+ * @file jrevdct.c
+ * Independent JPEG Group's LLM idct.
+ */
+ 
 #include "common.h"
 #include "dsputil.h"
 
diff --git a/libavcodec/mace.c b/libavcodec/mace.c
index d8438e8d9cfe07841fecd05e4302918a7ea58c96..91a37452b9c159cb1baa1b59851597bde2b66eb6 100644
--- a/libavcodec/mace.c
+++ b/libavcodec/mace.c
@@ -16,6 +16,12 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+
+/**
+ * @file mace.c
+ * MACE decoder.
+ */
+ 
 #include "avcodec.h"
 
 /*
diff --git a/libavcodec/mdct.c b/libavcodec/mdct.c
index 91a927cb097502df867408703c178452c40475b2..a0f5671771b3446df1d76deedf5f73780a41f942 100644
--- a/libavcodec/mdct.c
+++ b/libavcodec/mdct.c
@@ -18,8 +18,13 @@
  */
 #include "dsputil.h"
 
-/*
- * init MDCT or IMDCT computation
+/**
+ * @file mdct.c
+ * MDCT/IMDCT transforms.
+ */
+
+/**
+ * init MDCT or IMDCT computation.
  */
 int ff_mdct_init(MDCTContext *s, int nbits, int inverse)
 {
diff --git a/libavcodec/mem.c b/libavcodec/mem.c
index a36952fd749f232ff9d4f0df0c36c577082ad0fa..c5ca166d337d4ae324557c7e407a7d5470d13554 100644
--- a/libavcodec/mem.c
+++ b/libavcodec/mem.c
@@ -16,6 +16,12 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+ 
+/**
+ * @file mem.c
+ * default memory allocator for libavcodec.
+ */
+ 
 #include "avcodec.h"
 
 /* here we can use OS dependant allocation functions */
diff --git a/libavcodec/mjpeg.c b/libavcodec/mjpeg.c
index 4160ff48099fa5cc22f3104e98ff873d76069b25..efc9108b6947cbc3c280b2fcbd7a48ecc6b39793 100644
--- a/libavcodec/mjpeg.c
+++ b/libavcodec/mjpeg.c
@@ -20,6 +20,12 @@
  * aspecting, new decode_frame mechanism and apple mjpeg-b support
  *                                  by Alex Beregszaszi <alex@naxine.org>
  */
+
+/**
+ * @file mjpeg.c
+ * MJPEG encoder and decoder.
+ */
+ 
 //#define DEBUG
 #include "avcodec.h"
 #include "dsputil.h"
diff --git a/libavcodec/motion_est.c b/libavcodec/motion_est.c
index 36226d203d8f4ea3fec3ca7f886a3f5b3331edc9..5bc37fa03517e4fad9289d14ab5736d09a040ab8 100644
--- a/libavcodec/motion_est.c
+++ b/libavcodec/motion_est.c
@@ -20,6 +20,12 @@
  *
  * new Motion Estimation (X1/EPZS) by Michael Niedermayer <michaelni@gmx.at>
  */
+ 
+/**
+ * @file motion_est.c
+ * Motion estimation.
+ */
+ 
 #include <stdlib.h>
 #include <stdio.h>
 #include "avcodec.h"
diff --git a/libavcodec/motion_est_template.c b/libavcodec/motion_est_template.c
index 4725ed994c128b22504b2019f766e63a0d4f4929..f393fd88a96976e86944acec0ddf1c7b7d6269b4 100644
--- a/libavcodec/motion_est_template.c
+++ b/libavcodec/motion_est_template.c
@@ -17,6 +17,11 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  *
  */
+ 
+/**
+ * @file motion_est_template.c
+ * Motion estimation template.
+ */
 
 //lets hope gcc will remove the unused vars ...(gcc 3.2.2 seems to do it ...)
 //Note, the last line is there to kill these ugly unused var warnings
diff --git a/libavcodec/motion_test.c b/libavcodec/motion_test.c
index 63d0a087572c47f322415b06196947182c633b1e..477d10879618cf6e8f44bc45c4722eb2207cd913 100644
--- a/libavcodec/motion_test.c
+++ b/libavcodec/motion_test.c
@@ -1,4 +1,10 @@
 /* motion test. (c) 2001 Fabrice Bellard. */
+
+/**
+ * @file motion_test.c
+ * motion test.
+ */
+
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
diff --git a/libavcodec/mp3lameaudio.c b/libavcodec/mp3lameaudio.c
index 18f36e1a39066fb1daf84ebd22cda36ff1162ef7..4e1660d4ebd585878f82d2ed0da1fbbcc1e8cef5 100644
--- a/libavcodec/mp3lameaudio.c
+++ b/libavcodec/mp3lameaudio.c
@@ -16,6 +16,11 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+ 
+/**
+ * @file mp3lameaudio.c
+ * Interface to libmp3lame for mp3 encoding.
+ */
 
 #include "avcodec.h"
 #include "mpegaudio.h"
diff --git a/libavcodec/mpeg12.c b/libavcodec/mpeg12.c
index bee03d2876b8b94ce942fa19a24114d23e4f4a84..6eb16c9dfc28ba528bd55fe23214a53ed131efd5 100644
--- a/libavcodec/mpeg12.c
+++ b/libavcodec/mpeg12.c
@@ -1,5 +1,5 @@
 /*
- * MPEG1 encoder / MPEG2 decoder
+ * MPEG1 codec / MPEG2 decoder
  * Copyright (c) 2000,2001 Fabrice Bellard.
  *
  * This library is free software; you can redistribute it and/or
@@ -16,6 +16,12 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+ 
+/**
+ * @file mpeg12.c
+ * MPEG1 codec / MPEG2 decoder.
+ */
+ 
 //#define DEBUG
 #include "avcodec.h"
 #include "dsputil.h"
diff --git a/libavcodec/mpeg12data.h b/libavcodec/mpeg12data.h
index 4a90bbdb72c42e004f7ebcf3db518bceb4486a39..d18640d074f75a1f2daf5e47a7098fa7ae86e235 100644
--- a/libavcodec/mpeg12data.h
+++ b/libavcodec/mpeg12data.h
@@ -1,5 +1,6 @@
-/*
- * MPEG1/2 tables
+/**
+ * @file mpeg12data.h
+ * MPEG1/2 tables.
  */
 
 const int16_t ff_mpeg1_default_intra_matrix[64] = {
diff --git a/libavcodec/mpeg4data.h b/libavcodec/mpeg4data.h
index 92814908b4751472ea33ae2d87d5b1fd66b05617..219e329934739f1dc06aa52e9a90c860a5e1768e 100644
--- a/libavcodec/mpeg4data.h
+++ b/libavcodec/mpeg4data.h
@@ -1,3 +1,8 @@
+/**
+ * @file mpeg4data.h
+ * mpeg4 tables.
+ */
+
 // shapes
 #define RECT_SHAPE       0
 #define BIN_SHAPE        1
diff --git a/libavcodec/mpegaudio.c b/libavcodec/mpegaudio.c
index e8bf6f1d216b0307d02301a1ba8037c0c29645c4..f5b92230494cab0557dfc286e5e556687e0b27e0 100644
--- a/libavcodec/mpegaudio.c
+++ b/libavcodec/mpegaudio.c
@@ -16,6 +16,12 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+ 
+/**
+ * @file mpegaudio.c
+ * The simplest mpeg audio layer 2 encoder.
+ */
+ 
 #include "avcodec.h"
 #include "mpegaudio.h"
 
diff --git a/libavcodec/mpegaudio.h b/libavcodec/mpegaudio.h
index 338d3c1e0806f83d4015d145109b6a339d17450c..7aba13200b6a99d9e8ef5ab49633940a404305b6 100644
--- a/libavcodec/mpegaudio.h
+++ b/libavcodec/mpegaudio.h
@@ -1,4 +1,7 @@
-/* mpeg audio declarations for both encoder and decoder */
+/**
+ * @file mpegaudio.h
+ * mpeg audio declarations for both encoder and decoder.
+ */
 
 /* max frame size, in samples */
 #define MPA_FRAME_SIZE 1152 
diff --git a/libavcodec/mpegaudiodec.c b/libavcodec/mpegaudiodec.c
index a0234e47f4aa45dd86fd7f4301573c0521c7aa03..a93c280abc14ad8f0348b15630f336e7b9991e80 100644
--- a/libavcodec/mpegaudiodec.c
+++ b/libavcodec/mpegaudiodec.c
@@ -16,6 +16,12 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+
+/**
+ * @file mpegaudiodec.c
+ * MPEG Audio decoder.
+ */ 
+
 //#define DEBUG
 #include "avcodec.h"
 #include "mpegaudio.h"
diff --git a/libavcodec/mpegaudiodectab.h b/libavcodec/mpegaudiodectab.h
index ce9f1a8de0ed95b25aa5b5fbf8a4945f11cbd1d5..8a13127ad9188816adffed7f6dc386ed0a0f7326 100644
--- a/libavcodec/mpegaudiodectab.h
+++ b/libavcodec/mpegaudiodectab.h
@@ -1,3 +1,7 @@
+/**
+ * @file mpegaudiodectab.h
+ * mpeg audio layer decoder tables. 
+ */
 
 const uint16_t mpa_bitrate_tab[2][3][15] = {
     { {0, 32, 64, 96, 128, 160, 192, 224, 256, 288, 320, 352, 384, 416, 448 },
diff --git a/libavcodec/mpegaudiotab.h b/libavcodec/mpegaudiotab.h
index 6521202bbb363320bc67c2870af2573a465b3a47..59bf868932d8aab19c3b21d935b4cd99ac1925e7 100644
--- a/libavcodec/mpegaudiotab.h
+++ b/libavcodec/mpegaudiotab.h
@@ -8,6 +8,12 @@
  * same archive 
  */
 
+/**
+ * @file mpegaudiotab.h
+ * mpeg audio layer 2 tables. 
+ * Most of them come from the mpeg audio specification.
+ */
+ 
 #define SQRT2 1.41421356237309514547
 
 static const int costab32[30] = {
diff --git a/libavcodec/mpegvideo.c b/libavcodec/mpegvideo.c
index f487c51f7d11c1759ef4dc5142d6784da83f2b73..fbea1f94db5691e8c671cf2e1491694fa1eef936 100644
--- a/libavcodec/mpegvideo.c
+++ b/libavcodec/mpegvideo.c
@@ -19,6 +19,11 @@
  * 4MV & hq & b-frame encoding stuff by Michael Niedermayer <michaelni@gmx.at>
  */
  
+/**
+ * @file mpegvideo.c
+ * The simplest mpeg encoder (well, it was the simplest!).
+ */ 
+ 
 #include <ctype.h>
 #include <limits.h>
 #include "avcodec.h"
diff --git a/libavcodec/mpegvideo.h b/libavcodec/mpegvideo.h
index 899956a5b52341403327749cd9364d6cc0ab39ca..0c8bd5e32f564b84d9a36c64ec2f15dbbb61d528 100644
--- a/libavcodec/mpegvideo.h
+++ b/libavcodec/mpegvideo.h
@@ -17,6 +17,11 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
 
+/**
+ * @file mpegvideo.h
+ * mpegvideo header.
+ */
+ 
 #ifndef AVCODEC_MPEGVIDEO_H
 #define AVCODEC_MPEGVIDEO_H
 
diff --git a/libavcodec/msmpeg4.c b/libavcodec/msmpeg4.c
index 2183b9d3a0748dd57cb9b60cbf0f93d5c3646ac0..acf52d8136f6a1a7b156cf495ca075ac8015dd08 100644
--- a/libavcodec/msmpeg4.c
+++ b/libavcodec/msmpeg4.c
@@ -18,6 +18,12 @@
  *
  * msmpeg4v1 & v2 stuff by Michael Niedermayer <michaelni@gmx.at>
  */
+
+/**
+ * @file msmpeg4.c
+ * MSMPEG4 backend for ffmpeg encoder and decoder.
+ */
+
 #include "avcodec.h"
 #include "dsputil.h"
 #include "mpegvideo.h"
diff --git a/libavcodec/msmpeg4data.h b/libavcodec/msmpeg4data.h
index 2c3a28f0e22a8862f81aca3f7afbc7432051efd0..69568cbf63cc11ef5e2650c6bafc9fc2584138c6 100644
--- a/libavcodec/msmpeg4data.h
+++ b/libavcodec/msmpeg4data.h
@@ -1,4 +1,5 @@
-/*
+/**
+ * @file msmpeg4data.h
  * MSMPEG4 data tables. 
  */
 
diff --git a/libavcodec/oggvorbis.c b/libavcodec/oggvorbis.c
index af5b1eb7bf758b2667d961e212f40de519653dea..7e525a5593e8d9a1695cfd43f0481f3d8ebbf35a 100644
--- a/libavcodec/oggvorbis.c
+++ b/libavcodec/oggvorbis.c
@@ -1,6 +1,7 @@
-/*
- * Ogg Vorbis codec support via libvorbisenc
- * Mark Hills <mark@pogo.org.uk>
+/**
+ * @file oggvorbis.c
+ * Ogg Vorbis codec support via libvorbisenc.
+ * @author Mark Hills <mark@pogo.org.uk>
  */
 
 #include <time.h>
diff --git a/libavcodec/oggvorbis.h b/libavcodec/oggvorbis.h
index 0b206a17371b26ec91d36ccde48c4d1a4612777d..fd431dc64ca9019dac423b5ed858be5f8adc20d3 100644
--- a/libavcodec/oggvorbis.h
+++ b/libavcodec/oggvorbis.h
@@ -1,3 +1,8 @@
+/**
+ * @file oggvorbis.h
+ * oggvorbis.
+ */
+
 #ifndef AVCODEC_OGGVORBIS_H
 #define AVCODEC_OGGVORBIS_H
 
diff --git a/libavcodec/opts.c b/libavcodec/opts.c
index cf5cf0eef72a0e1d5320f89710064875c0f1789f..908f27875a2817d5e8926668a4d9efcc9664c606 100644
--- a/libavcodec/opts.c
+++ b/libavcodec/opts.c
@@ -2,7 +2,9 @@
  * LGPL
  */
 
-/*
+/**
+ * @file opts.c
+ * options parser.
  * typical parsed command line:
  * msmpeg4:bitrate=720000:qmax=16
  *
diff --git a/libavcodec/ratecontrol.c b/libavcodec/ratecontrol.c
index ffb9237ac73435dc168920e60cec127526826674..d7fe11100c1bfa85d4409ca323ae15a4592069d2 100644
--- a/libavcodec/ratecontrol.c
+++ b/libavcodec/ratecontrol.c
@@ -17,6 +17,12 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+
+/**
+ * @file ratecontrol.c
+ * Rate control for video encoders.
+ */ 
+
 #include "avcodec.h"
 #include "dsputil.h"
 #include "mpegvideo.h"
diff --git a/libavcodec/resample.c b/libavcodec/resample.c
index 36b039c06b5ae651f49f8a1148d5af0315f6bdfc..209a00808de0a9a9131c1db7e68d5def6bae31c6 100644
--- a/libavcodec/resample.c
+++ b/libavcodec/resample.c
@@ -16,6 +16,12 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+
+/**
+ * @file resample.c
+ * Sample rate convertion for both audio and video.
+ */
+
 #include "avcodec.h"
 
 typedef struct {
diff --git a/libavcodec/rv10.c b/libavcodec/rv10.c
index 6ed93b2abdc51c767bcbd6e381085217e16c7fa4..8244cb5dcf94cca7a22cf2be2a0aa6c0c96a46ba 100644
--- a/libavcodec/rv10.c
+++ b/libavcodec/rv10.c
@@ -16,6 +16,12 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+
+/**
+ * @file rv10.c
+ * RV10 codec.
+ */
+ 
 #include "avcodec.h"
 #include "dsputil.h"
 #include "mpegvideo.h"
diff --git a/libavcodec/simple_idct.c b/libavcodec/simple_idct.c
index d8fc32a105167bed428595dd0da8d6512ada403e..4b488197a8274494a697f5a4a2368a17d9be4a62 100644
--- a/libavcodec/simple_idct.c
+++ b/libavcodec/simple_idct.c
@@ -17,6 +17,12 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+ 
+/**
+ * @file simple_idct.c
+ * simpleidct in C.
+ */
+ 
 /*
   based upon some outcommented c code from mpeg2dec (idct_mmx.c
   written by Aaron Holtzman <aholtzma@ess.engr.uvic.ca>) 
diff --git a/libavcodec/simple_idct.h b/libavcodec/simple_idct.h
index f8d2148a18e367541cde5c0888a03d0b72a0a07a..2da822771b5491bb86113ab37515cb70ac1ff848 100644
--- a/libavcodec/simple_idct.h
+++ b/libavcodec/simple_idct.h
@@ -18,6 +18,11 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
 
+/**
+ * @file simple_idct.h
+ * simple idct header.
+ */
+ 
 void simple_idct_put(uint8_t *dest, int line_size, DCTELEM *block);
 void simple_idct_add(uint8_t *dest, int line_size, DCTELEM *block);
 void ff_simple_idct_mmx(int16_t *block);
diff --git a/libavcodec/svq1.c b/libavcodec/svq1.c
index 6046f200340e3b4977836c7fffcdab241cc2d20f..ab2f8e855fe3952f800ed6e9382c9eb9c8f6928d 100644
--- a/libavcodec/svq1.c
+++ b/libavcodec/svq1.c
@@ -21,6 +21,12 @@
  * Ported to libavcodec by Nick Kurshev <nickols_k@mail.ru>
  *
  */
+
+/**
+ * @file svq1.c
+ * svq1 decoder.
+ */
+
 //#define DEBUG_SVQ1
 #include <stdio.h>
 #include <stdlib.h>
diff --git a/libavcodec/svq1_cb.h b/libavcodec/svq1_cb.h
index fa1eb3b1f1b77f564ecd0e026e33ea329f381474..14372a2550cf83193cd57bfff605880956b518fa 100644
--- a/libavcodec/svq1_cb.h
+++ b/libavcodec/svq1_cb.h
@@ -22,6 +22,11 @@
  *
  */
 
+/**
+ * @file svq1_cb.h
+ * svq1 code books.
+ */
+ 
 /* 6x16-entry codebook for inter-coded 4x2 vectors */
 static const int8_t svq1_inter_codebook_4x2[768] = {
     7,  2, -6, -7,  7,  3, -3, -4, -7, -2,  7,  8, -8, -4,  3,  4,
diff --git a/libavcodec/utils.c b/libavcodec/utils.c
index d8d750dffae547f1b57dd1ae1b30bbc5e82abbe5..70de6ca13d565d8fc00ae383159f556f17a371b3 100644
--- a/libavcodec/utils.c
+++ b/libavcodec/utils.c
@@ -16,6 +16,12 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+ 
+/**
+ * @file utils.c
+ * utils.
+ */
+ 
 #include "avcodec.h"
 #include "dsputil.h"
 #include "mpegvideo.h"
diff --git a/libavcodec/wmadata.h b/libavcodec/wmadata.h
index 12050b2f36baf2ac9e637d761a11d820de26a451..ee17207102b8032c388b0cfd2089ccdc24be48fd 100644
--- a/libavcodec/wmadata.h
+++ b/libavcodec/wmadata.h
@@ -1,4 +1,7 @@
-/* Various WMA tables */
+/**
+ * @file wmadata.h
+ * Various WMA tables.
+ */
 
 static const uint16_t wma_critical_freqs[25] = {
     100,   200,  300, 400,   510,  630,  770,    920,
diff --git a/libavcodec/wmadec.c b/libavcodec/wmadec.c
index d3aff0a67fabc890fa82e8d74af188d78a0dd1ca..ab02feb7284c3ac48f839435b1f1a132e8076bfc 100644
--- a/libavcodec/wmadec.c
+++ b/libavcodec/wmadec.c
@@ -16,6 +16,12 @@
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
+
+/**
+ * @file wmadec.c
+ * WMA compatible decoder.
+ */
+
 #include "avcodec.h"
 #include "dsputil.h"
 
diff --git a/libavcodec/wmv2.c b/libavcodec/wmv2.c
index 5050ef4ac5a2bfe69ff1dc1a4a171d9221287073..be8c71364ffec34c5c3ce4fd5b1671d8ce206579 100644
--- a/libavcodec/wmv2.c
+++ b/libavcodec/wmv2.c
@@ -17,6 +17,11 @@
  *
  */
 
+/**
+ * @file wmv2.c
+ * wmv2 codec.
+ */
+ 
 #include "simple_idct.h"
  
 #define SKIP_TYPE_NONE 0