src/temporal/: improve documentation for a and c-design filters

diff --git a/src/temporal/adesign.h b/src/temporal/adesign.h
index 910d6f7..b0aa424 100644 (file)
--- a/src/temporal/adesign.h
+++ b/src/temporal/adesign.h
@@ -17,12 +17,23 @@
 
 */
 
-/** create a new A-design filter 
+/** \file
+
+  Create a new A-design filter 
+
+  This file creates an IIR filter object with A-design coefficients.
+
+*/
+
+/** create new A-design filter
 
   \param samplerate sampling-rate of the signal to filter 
+  \param channels number of channels to allocate
 
 */
 aubio_filter_t * new_aubio_adsgn_filter(uint_t samplerate, uint_t channels);
 
+/** filter input vector (in-place) */
 #define aubio_adsgn_filter_do aubio_filter_do
+/** delete a-design filter object */
 #define del_aubio_adsgn_filter del_aubio_filter

diff --git a/src/temporal/cdesign.h b/src/temporal/cdesign.h
index f07f62f..df40ede 100644 (file)
--- a/src/temporal/cdesign.h
+++ b/src/temporal/cdesign.h
@@ -19,12 +19,23 @@
 
 #include "filter.h"
 
-/** create a new C-design filter 
+/** \file
+
+  Create a new C-design filter 
+
+  This file creates an IIR filter object with A-design coefficients.
+
+*/
+
+/** create new C-design filter
 
   \param samplerate sampling-rate of the signal to filter 
+  \param channels number of channels to allocate
 
 */
 aubio_filter_t * new_aubio_cdsgn_filter(uint_t samplerate, uint_t channels);
 
+/** filter input vector (in-place) */
 #define aubio_cdsgn_filter_do aubio_filter_do
+/** delete c-design filter object */
 #define del_aubio_cdsgn_filter del_aubio_filter