update pitch method comments

update pitch method comments

diff --git a/src/pitchschmitt.c b/src/pitchschmitt.c
index 087f21d0c69eee38fc96c7c918ff951f3f8c2a6f..04cf0179817718e22b64b78d9bb1979d94abf39f 100644 (file)
--- a/src/pitchschmitt.c
+++ b/src/pitchschmitt.c
@@ -17,14 +17,6 @@
 
 */
 
-/* 
-  
-   This file was taken from the tuneit project, in the file
-   tuneit.c -- Detect fundamental frequency of a sound
-   see http://delysid.org/tuneit.html 
-  
- */
-
 #include "aubio_priv.h"
 #include "sample.h"
 #include "pitchschmitt.h"

diff --git a/src/pitchschmitt.h b/src/pitchschmitt.h
index c673be04784246b522f6ffaf9465bc279b50e050..8a3192e268275fdf8f4fe95b788b318adc0e2733 100644 (file)
--- a/src/pitchschmitt.h
+++ b/src/pitchschmitt.h
@@ -17,6 +17,20 @@
 
 */
 
+/** \file 
+
+   Pitch detection using a Schmitt trigger 
+ 
+   This pitch extraction method implements a Schmitt trigger to estimate the
+   period of a signal.
+
+   This file was derived from the tuneit project, written by Mario Lang to
+   detect the fundamental frequency of a sound.
+   
+   see http://delysid.org/tuneit.html 
+
+*/
+
 #ifndef _PITCHSCHMITT_H
 #define _PITCHSCHMITT_H
 
@@ -24,10 +38,28 @@
 extern "C" {
 #endif
 
+/** pitch detection object */
 typedef struct _aubio_pitchschmitt_t aubio_pitchschmitt_t;
 
+/** execute pitch detection on an input buffer 
+ 
+  \param p pitch detection object as returned by new_aubio_pitchschmitt 
+  \param input input signal window (length as specified at creation time) 
+ 
+*/
 smpl_t aubio_pitchschmitt_detect (aubio_pitchschmitt_t *p, fvec_t * input);
+/** creation of the pitch detection object
+ 
+  \param size size of the input buffer to analyse 
+  \param samplerate sampling rate of the signal 
+ 
+*/
 aubio_pitchschmitt_t * new_aubio_pitchschmitt (uint_t size, uint_t samplerate);
+/** deletion of the pitch detection object
+ 
+  \param p pitch detection object as returned by new_aubio_pitchschmitt 
+ 
+*/
 void del_aubio_pitchschmitt (aubio_pitchschmitt_t *p);