update resample.h docs

update resample.h docs

diff --git a/src/resample.h b/src/resample.h
index f77a5fb9cb8d1461a777df8036352c9743b52bff..d4449ca3c2e2d88aa6ae21e865afab4ee3ba3c0b 100644 (file)
--- a/src/resample.h
+++ b/src/resample.h
@@ -20,32 +20,37 @@
 #ifndef _RESAMPLE_H
 #define _RESAMPLE_H
 
-/** @file
- * Libsamplerate resampling
- */
+/** \file
+ 
+ Resampling object
+
+ This object resamples an input vector into an output vector using
+ libsamplerate. See http://www.mega-nerd.com/SRC/
+ 
+*/
 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
-/** 
- * resampler object
- */
+/** resampler object */
 typedef struct _aubio_resampler_t aubio_resampler_t;
-/**  
- * create resampler object 
- * \param ratio output_sample_rate / input_sample_rate 
- * \param type libsamplerate resampling type
- */
+/** create resampler object 
+
+  \param ratio output_sample_rate / input_sample_rate 
+  \param type libsamplerate resampling type
+
+*/
 aubio_resampler_t * new_aubio_resampler(float ratio, uint_t type);
 /** delete resampler object */
 void del_aubio_resampler(aubio_resampler_t *s);
-/** 
- * resample input in output
- * \param s resampler object
- * \param input input buffer of size N
- * \param output output buffer of size N*ratio
- */
+/** resample input in output
+
+  \param s resampler object
+  \param input input buffer of size N
+  \param output output buffer of size N*ratio
+
+*/
 uint_t aubio_resampler_process(aubio_resampler_t *s, fvec_t * input,  fvec_t * output);
 
 #ifdef __cplusplus