More documentation updates.

diff --git a/imdct.c b/imdct.c
index db7a6d5c7924951d483d5cd9e064b4aeecb6b393..ac085bbc519dcd5dfa8b359f96475270ef2e1a48 100644 (file)
--- a/imdct.c
+++ b/imdct.c
@@ -39,13 +39,15 @@ struct fft_context {
 };
 
 struct mdct_context {
-       /** Size of MDCT (i.e. number of input data * 2). */
+       /** Size of MDCT (number of input data * 2). */
        int n;
        /** n = 2^n bits. */
        int nbits;
-       /** pre/post rotation tables */
+       /** Cosine table for pre/post rotation. */
        fftsample_t *tcos;
+       /** Sine table for pre/post rotation. */
        fftsample_t *tsin;
+       /** The context for the underlying fast Fourier transform. */
        struct fft_context fft;
 };
 
@@ -85,7 +87,8 @@ static int split_radix_permutation(int i, int n)
                return split_radix_permutation(i, m) * 4 - 1;
 }
 
-#define SQRTHALF (float)0.70710678118654752440 /* 1/sqrt(2) */
+/** 1 / sqrt(2). */
+#define SQRTHALF (float)0.70710678118654752440
 
 #define BF(x,y,a,b) {\
     x = a - b;\
@@ -384,6 +387,11 @@ fail:
        return ret;
 }
 
+/**
+ * Deallocate imdct resources.
+ *
+ * \param ctx The pointer obtained by imdct_init().
+ */
 void imdct_end(struct mdct_context *ctx)
 {
        free(ctx->tcos);

diff --git a/imdct.h b/imdct.h
index 6a71a5adc10137890e86c43b698da5078c03c90e..442b98bf7c5581d9ca090ca5fe268113e89a2fde 100644 (file)
--- a/imdct.h
+++ b/imdct.h
@@ -1,4 +1,4 @@
-/** \file imdct.h: Exported symbols from imdct.c. */
+/** \file imdct.h Exported symbols from imdct.c. */
 
 struct mdct_context;
 

diff --git a/wma.h b/wma.h
index 18748dad9be2bdbf6faf1c7a1a49cba6d78e8fac..df61c20a173e78ebd66465c4855c5c3f6d0fae90 100644 (file)
--- a/wma.h
+++ b/wma.h
@@ -1,10 +1,10 @@
+/** \file wma.h The asf_header structure and public wma function declarations. */
+
 /**
  * Information contained in an asf audio file header.
  *
  * Both para_filter and para_afh need to read the header.
  */
-
-/** Information stored in the asf header. */
 struct asf_header_info {
        /** The size of the audio file header. */
        int header_len;