1 files changed, 13 insertions, 1 deletions

diff --git a/core/multimedia/opieplayer/libmad/decoder.c b/core/multimedia/opieplayer/libmad/decoder.c
index b2b6cbb..d039bfb 100644
--- a/core/multimedia/opieplayer/libmad/decoder.c
+++ b/core/multimedia/opieplayer/libmad/decoder.c
@@ -1,9 +1,9 @@
 /*
  * libmad - MPEG audio decoder library
- * Copyright (C) 2000-2001 Robert Leslie
+ * Copyright (C) 2000-2004 Underbit Technologies, Inc.
  *
  * This program is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
  * the Free Software Foundation; either version 2 of the License, or
  * (at your option) any later version.
  *
@@ -49,12 +49,16 @@
 
 # include "stream.h"
 # include "frame.h"
 # include "synth.h"
 # include "decoder.h"
 
+/*
+         * NAME:decoder->init()
+         * DESCRIPTION:initialize a decoder object with callback routines
+ */
 void mad_decoder_init(struct mad_decoder *decoder, void *data,
                       enum mad_flow (*input_func)(void *,
                                                   struct mad_stream *),
                       enum mad_flow (*header_func)(void *,
                                                    struct mad_header const *),
                       enum mad_flow (*filter_func)(void *,
@@ -519,12 +523,16 @@ int run_async(struct mad_decoder *decoder)
 
   /* not reached */
   return -1;
 }
 # endif
 
+/*
+         * NAME:decoder->run()
+         * DESCRIPTION:run the decoder thread either synchronously or asynchronously
+ */
 int mad_decoder_run(struct mad_decoder *decoder, enum mad_decoder_mode mode)
 {
   int result;
   int (*run)(struct mad_decoder *) = 0;
 
   switch (decoder->mode = mode) {
@@ -551,12 +559,16 @@ int mad_decoder_run(struct mad_decoder *decoder, enum mad_decoder_mode mode)
   free(decoder->sync);
   decoder->sync = 0;
 
   return result;
 }
 
+/*
+         * NAME:decoder->message()
+         * DESCRIPTION:send a message to and receive a reply from the decoder process
+ */
 int mad_decoder_message(struct mad_decoder *decoder,
                         void *message, unsigned int *len)
 {
 # if defined(USE_ASYNC)
   if (decoder->mode != MAD_DECODER_MODE_ASYNC ||
       send(decoder->async.out, message, *len) != MAD_FLOW_CONTINUE ||