src/: improve documentation

diff --git a/src/cvec.h b/src/cvec.h
index 4dc307c29a7c21c447f3cfcf0ef4e3b61c6b6168..aeff6e019fc05b4a5dac27708bf237d5c6ec8ee5 100644 (file)
--- a/src/cvec.h
+++ b/src/cvec.h
@@ -27,19 +27,21 @@ extern "C" {
 
 /** \file
 
-  Complex buffers
+  Vector of complex-valued data
 
-  This file specifies the cvec_t buffer type, which is used throughout aubio to
-  store complex data. Complex values are stored in terms of phase and
-  norm, within size/2+1 long vectors.
+  This file specifies the ::cvec_t buffer type, which is used throughout aubio
+  to store complex data. Complex values are stored in terms of ::cvec_t.phas
+  and norm, within size/2+1 long vectors of ::smpl_t.
+
+  \example test-cvec.c
 
 */
 
 /** Buffer for complex data */
 typedef struct {
-  uint_t length;   /**< length of buffer = (requested length)/2 + 1 */
-  smpl_t *norm;   /**< norm array of size [length] */
-  smpl_t *phas;   /**< phase array of size [length] */
+  uint_t length;  /**< length of buffer = (requested length)/2 + 1 */
+  smpl_t *norm;   /**< norm array of size ::cvec_t.length */
+  smpl_t *phas;   /**< phase array of size ::cvec_t.length */
 } cvec_t;
 
 /** cvec_t buffer creation function
@@ -47,7 +49,7 @@ typedef struct {
   This function creates a cvec_t structure holding two arrays of size
   [length/2+1], corresponding to the norm and phase values of the
   spectral frame. The length stored in the structure is the actual size of both
-  arrays, not the length of the complex and symetrical vector, specified as
+  arrays, not the length of the complex and symmetrical vector, specified as
   creation argument.
 
   \param length the length of the buffer to create

diff --git a/src/temporal/a_weighting.h b/src/temporal/a_weighting.h
index cf1a1cbf4ff0e0d3a0c2eba42c4543652c45d076..e5f743d07455a338f007dc80097bec9c3cdab386 100644 (file)
--- a/src/temporal/a_weighting.h
+++ b/src/temporal/a_weighting.h
@@ -52,6 +52,8 @@
   The sampling frequency should normally be higher than 20kHz, but most common
   file sampling rates have been included for completeness.
 
+  \example temporal/test-a_weighting.c
+
 */
 
 #ifdef __cplusplus

diff --git a/src/temporal/c_weighting.h b/src/temporal/c_weighting.h
index c80cfc37f3905f3f5c49f923d76879ece349dcf6..5e33b6c387c5848b363f2e19647f6a46955f90fa 100644 (file)
--- a/src/temporal/c_weighting.h
+++ b/src/temporal/c_weighting.h
@@ -52,6 +52,8 @@
   The sampling frequency should normally be higher than 20kHz, but most common
   file sampling rates have been included for completeness.
 
+  \example temporal/test-c_weighting.c
+
 */
 
 #ifdef __cplusplus

diff --git a/src/temporal/filter.h b/src/temporal/filter.h
index 5d151fff1f112808e2898c31d5fee90f04cfc6d7..83d2e78c7ddc9cd28feb80438125177f63ed867f 100644 (file)
--- a/src/temporal/filter.h
+++ b/src/temporal/filter.h
@@ -57,6 +57,8 @@
     - new_aubio_filter_a_weighting() and aubio_filter_set_a_weighting(),
     - new_aubio_filter_c_weighting() and aubio_filter_set_c_weighting().
     - new_aubio_filter_biquad() and aubio_filter_set_biquad().
+
+  \example temporal/test-filter.c
  
 */
 

diff --git a/src/vecutils.h b/src/vecutils.h
index 37857130b19634ba60fff6d11d7a91e8b142c65b..9bbdb48f5e116956966dd1bea629721b7cfa2bed 100644 (file)
--- a/src/vecutils.h
+++ b/src/vecutils.h
@@ -18,9 +18,10 @@
 
 */
 
-/** @file
- *  various utilities functions for fvec and cvec objects
- *
+/** \file
+
+  Utility functions for ::fvec_t and ::cvec_t objects
+
  */
 
 #ifndef _VECUTILS_H