@@ -190,7 +190,7 @@ void parse_loglevel(int argc, char **argv, const OptionDef *options);

  *

  * @param s  Corresponding format context.

  * @param st Stream from s to be checked.

- * @param spec A stream specifier of the [v|a|s|d]:[<stream index>] form.

+ * @param spec A stream specifier of the [v|a|s|d]:[\<stream index\>] form.

  *

  * @return 1 if the stream matches, 0 if it doesn't, <0 on error

  */

@@ -22,10 +22,11 @@

 /**

  * @file

  * Cinepak video decoder

- * by Ewald Snel <ewald@rambo.its.tudelft.nl>

- * For more information on the Cinepak algorithm, visit:

+ * @author Ewald Snel <ewald@rambo.its.tudelft.nl>

+ *

+ * @see For more information on the Cinepak algorithm, visit:

  *   http://www.csse.monash.edu.au/~timf/

- * For more information on the quirky data inside Sega FILM/CPK files, visit:

+ * @see For more information on the quirky data inside Sega FILM/CPK files, visit:

  *   http://wiki.multimedia.cx/index.php?title=Sega_FILM

  */

@@ -22,9 +22,9 @@

 /**

  * @file

  * Electronic Arts Madcow Video Decoder

- * by Peter Ross <pross@xvid.org>

+ * @author Peter Ross <pross@xvid.org>

  *

- * Technical details here:

+ * @see technical details at

  * http://wiki.multimedia.cx/index.php?title=Electronic_Arts_MAD

  */

@@ -75,7 +75,7 @@ void ff_acelp_lsf2lspd(double *lsp, const float *lsf, int lp_order)

 /**

  * @brief decodes polynomial coefficients from LSP

- * @param f [out] decoded polynomial coefficients (-0x20000000 <= (3.22) <= 0x1fffffff)

+ * @param[out] f decoded polynomial coefficients (-0x20000000 <= (3.22) <= 0x1fffffff)

  * @param lsp LSP coefficients (-0x8000 <= (0.15) <= 0x7fff)

  */

 static void lsp2poly(int* f, const int16_t* lsp, int lp_half_order)

@@ -23,7 +23,6 @@

  * @file

  * PulseAudio input using the simple API.

  * @author Luca Barbato <lu_zero@gentoo.org>

- *

  */

 #include <pulse/simple.h>

@@ -31,8 +31,9 @@

 /**

  * @file

- * X11 frame device demuxer by Clemens Fruhwirth <clemens@endorphin.org>

- * and Edouard Gomez <ed.gomez@free.fr>.

+ * X11 frame device demuxer

+ * @author Clemens Fruhwirth <clemens@endorphin.org>

+ * @author Edouard Gomez <ed.gomez@free.fr>

  */

 #include "config.h"

@@ -22,10 +22,10 @@

 /**

  * @file

  * Matroska file demuxer

- * by Ronald Bultje <rbultje@ronald.bitfreak.net>

- * with a little help from Moritz Bunkus <moritz@bunkus.org>

- * totally reworked by Aurelien Jacobs <aurel@gnuage.org>

- * Specs available on the Matroska project page: http://www.matroska.org/.

+ * @author Ronald Bultje <rbultje@ronald.bitfreak.net>

+ * @author with a little help from Moritz Bunkus <moritz@bunkus.org>

+ * @author totally reworked by Aurelien Jacobs <aurel@gnuage.org>

+ * @see specs available on the Matroska project page: http://www.matroska.org/

  */

 #include <stdio.h>

@@ -2,10 +2,9 @@

  * Ogg bitstream support

  * Luca Barbato <lu_zero@gentoo.org>

  * Based on tcvp implementation

- *

  */

-/**

+/*

     Copyright (C) 2005  Michael Ahlberg, Måns Rullgård

     Permission is hereby granted, free of charge, to any person

@@ -27,7 +26,7 @@

     WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

     OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER

     DEALINGS IN THE SOFTWARE.

-**/

+ */

 #include <stdio.h>