# HG changeset patch
# User michaelni
# Date 1046950324 0
# Node ID 1e39f273ecd676f5d18b8ae5874dcc337d028826
# Parent  b773f9d23236ef4cc110e13bfa04f99ca22123b6
per file doxy

diff -r b773f9d23236 -r 1e39f273ecd6 a52dec.c
--- a/a52dec.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/a52dec.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 ac3.h
--- a/ac3.h	Thu Mar 06 11:25:55 2003 +0000
+++ b/ac3.h	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 ac3dec.c
--- a/ac3dec.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/ac3dec.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 ac3enc.c
--- a/ac3enc.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/ac3enc.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 ac3tab.h
--- a/ac3tab.h	Thu Mar 06 11:25:55 2003 +0000
+++ b/ac3tab.h	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 adpcm.c
--- a/adpcm.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/adpcm.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 @@
     -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 -r b773f9d23236 -r 1e39f273ecd6 allcodecs.c
--- a/allcodecs.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/allcodecs.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 apiexample.c
--- a/apiexample.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/apiexample.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 avcodec.c
--- a/avcodec.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/avcodec.c	Thu Mar 06 11:32:04 2003 +0000
@@ -1,3 +1,8 @@
+/**
+ * @file avcodec.c
+ * avcodec.
+ */
+
 #include "errno.h"
 #include "avcodec.h"
 
diff -r b773f9d23236 -r 1e39f273ecd6 bswap.h
--- a/bswap.h	Thu Mar 06 11:25:55 2003 +0000
+++ b/bswap.h	Thu Mar 06 11:32:04 2003 +0000
@@ -1,3 +1,8 @@
+/**
+ * @file bswap.h
+ * byte swap.
+ */
+
 #ifndef __BSWAP_H__
 #define __BSWAP_H__
 
diff -r b773f9d23236 -r 1e39f273ecd6 common.c
--- a/common.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/common.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 common.h
--- a/common.h	Thu Mar 06 11:25:55 2003 +0000
+++ b/common.h	Thu Mar 06 11:32:04 2003 +0000
@@ -1,3 +1,8 @@
+/**
+ * @file common.h
+ * common internal api header.
+ */
+
 #ifndef COMMON_H
 #define COMMON_H
 
diff -r b773f9d23236 -r 1e39f273ecd6 cyuv.c
--- a/cyuv.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/cyuv.c	Thu Mar 06 11:32:04 2003 +0000
@@ -23,6 +23,11 @@
  *
  */
 
+/**
+ * @file cyuv.c 
+ * Creative YUV (CYUV) Video Decoder.
+ */
+ 
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
diff -r b773f9d23236 -r 1e39f273ecd6 dct-test.c
--- a/dct-test.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/dct-test.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 dsputil.c
--- a/dsputil.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/dsputil.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 dsputil.h
--- a/dsputil.h	Thu Mar 06 11:25:55 2003 +0000
+++ b/dsputil.h	Thu Mar 06 11:32:04 2003 +0000
@@ -19,8 +19,7 @@
 
 /**
  * @file dsputil.h
- * @brief DSP utils
- *
+ * DSP utils.
  */
 
 #ifndef DSPUTIL_H
diff -r b773f9d23236 -r 1e39f273ecd6 dv.c
--- a/dv.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/dv.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 dvdata.h
--- a/dvdata.h	Thu Mar 06 11:25:55 2003 +0000
+++ b/dvdata.h	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 error_resilience.c
--- a/error_resilience.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/error_resilience.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 eval.c
--- a/eval.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/eval.c	Thu Mar 06 11:32:04 2003 +0000
@@ -19,7 +19,10 @@
  *
  */
 
- /*
+/**
+ * @file eval.c
+ * simple arithmetic expression evaluator.
+ *
  * see http://joe.hotchkiss.com/programming/eval/eval.html
  */
 
diff -r b773f9d23236 -r 1e39f273ecd6 fdctref.c
--- a/fdctref.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/fdctref.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 fft-test.c
--- a/fft-test.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/fft-test.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 fft.c
--- a/fft.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/fft.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 h263.c
--- a/h263.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/h263.c	Thu Mar 06 11:32:04 2003 +0000
@@ -25,8 +25,7 @@
 
 /**
  * @file h263.c
- * @brief h263/mpeg4 codec
- *
+ * h263/mpeg4 codec.
  */
  
 //#define DEBUG
diff -r b773f9d23236 -r 1e39f273ecd6 h263data.h
--- a/h263data.h	Thu Mar 06 11:25:55 2003 +0000
+++ b/h263data.h	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 h263dec.c
--- a/h263dec.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/h263dec.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 huffyuv.c
--- a/huffyuv.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/huffyuv.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 imgconvert.c
--- a/imgconvert.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/imgconvert.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 imgresample.c
--- a/imgresample.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/imgresample.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 jfdctfst.c
--- a/jfdctfst.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/jfdctfst.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 jfdctint.c
--- a/jfdctint.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/jfdctint.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 jrevdct.c
--- a/jrevdct.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/jrevdct.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 mace.c
--- a/mace.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/mace.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 mdct.c
--- a/mdct.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/mdct.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 mem.c
--- a/mem.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/mem.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 mjpeg.c
--- a/mjpeg.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/mjpeg.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 motion_est.c
--- a/motion_est.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/motion_est.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 motion_est_template.c
--- a/motion_est_template.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/motion_est_template.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 motion_test.c
--- a/motion_test.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/motion_test.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 mp3lameaudio.c
--- a/mp3lameaudio.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/mp3lameaudio.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 mpeg12.c
--- a/mpeg12.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/mpeg12.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 mpeg12data.h
--- a/mpeg12data.h	Thu Mar 06 11:25:55 2003 +0000
+++ b/mpeg12data.h	Thu Mar 06 11:32:04 2003 +0000
@@ -1,5 +1,6 @@
-/*
- * MPEG1/2 tables
+/**
+ * @file mpeg12data.h
+ * MPEG1/2 tables.
  */
 
 const int16_t ff_mpeg1_default_intra_matrix[64] = {
diff -r b773f9d23236 -r 1e39f273ecd6 mpeg4data.h
--- a/mpeg4data.h	Thu Mar 06 11:25:55 2003 +0000
+++ b/mpeg4data.h	Thu Mar 06 11:32:04 2003 +0000
@@ -1,3 +1,8 @@
+/**
+ * @file mpeg4data.h
+ * mpeg4 tables.
+ */
+
 // shapes
 #define RECT_SHAPE       0
 #define BIN_SHAPE        1
diff -r b773f9d23236 -r 1e39f273ecd6 mpegaudio.c
--- a/mpegaudio.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/mpegaudio.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 mpegaudio.h
--- a/mpegaudio.h	Thu Mar 06 11:25:55 2003 +0000
+++ b/mpegaudio.h	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 mpegaudiodec.c
--- a/mpegaudiodec.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/mpegaudiodec.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 mpegaudiodectab.h
--- a/mpegaudiodectab.h	Thu Mar 06 11:25:55 2003 +0000
+++ b/mpegaudiodectab.h	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 mpegaudiotab.h
--- a/mpegaudiotab.h	Thu Mar 06 11:25:55 2003 +0000
+++ b/mpegaudiotab.h	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 mpegvideo.c
--- a/mpegvideo.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/mpegvideo.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 mpegvideo.h
--- a/mpegvideo.h	Thu Mar 06 11:25:55 2003 +0000
+++ b/mpegvideo.h	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 msmpeg4.c
--- a/msmpeg4.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/msmpeg4.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 msmpeg4data.h
--- a/msmpeg4data.h	Thu Mar 06 11:25:55 2003 +0000
+++ b/msmpeg4data.h	Thu Mar 06 11:32:04 2003 +0000
@@ -1,4 +1,5 @@
-/*
+/**
+ * @file msmpeg4data.h
  * MSMPEG4 data tables. 
  */
 
diff -r b773f9d23236 -r 1e39f273ecd6 oggvorbis.c
--- a/oggvorbis.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/oggvorbis.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 oggvorbis.h
--- a/oggvorbis.h	Thu Mar 06 11:25:55 2003 +0000
+++ b/oggvorbis.h	Thu Mar 06 11:32:04 2003 +0000
@@ -1,3 +1,8 @@
+/**
+ * @file oggvorbis.h
+ * oggvorbis.
+ */
+
 #ifndef AVCODEC_OGGVORBIS_H
 #define AVCODEC_OGGVORBIS_H
 
diff -r b773f9d23236 -r 1e39f273ecd6 opts.c
--- a/opts.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/opts.c	Thu Mar 06 11:32:04 2003 +0000
@@ -2,7 +2,9 @@
  * LGPL
  */
 
-/*
+/**
+ * @file opts.c
+ * options parser.
  * typical parsed command line:
  * msmpeg4:bitrate=720000:qmax=16
  *
diff -r b773f9d23236 -r 1e39f273ecd6 ratecontrol.c
--- a/ratecontrol.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/ratecontrol.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 resample.c
--- a/resample.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/resample.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 rv10.c
--- a/rv10.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/rv10.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 simple_idct.c
--- a/simple_idct.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/simple_idct.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 simple_idct.h
--- a/simple_idct.h	Thu Mar 06 11:25:55 2003 +0000
+++ b/simple_idct.h	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 svq1.c
--- a/svq1.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/svq1.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 svq1_cb.h
--- a/svq1_cb.h	Thu Mar 06 11:25:55 2003 +0000
+++ b/svq1_cb.h	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 utils.c
--- a/utils.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/utils.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 wmadata.h
--- a/wmadata.h	Thu Mar 06 11:25:55 2003 +0000
+++ b/wmadata.h	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 wmadec.c
--- a/wmadec.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/wmadec.c	Thu Mar 06 11:32:04 2003 +0000
@@ -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 -r b773f9d23236 -r 1e39f273ecd6 wmv2.c
--- a/wmv2.c	Thu Mar 06 11:25:55 2003 +0000
+++ b/wmv2.c	Thu Mar 06 11:32:04 2003 +0000
@@ -17,6 +17,11 @@
  *
  */
 
+/**
+ * @file wmv2.c
+ * wmv2 codec.
+ */
+ 
 #include "simple_idct.h"
  
 #define SKIP_TYPE_NONE 0