shithub: aubio

Download patch

ref: 4b7a740dec88b19e245276b47261db6ade864be4
parent: 58997528f52afe9db4b95246bcc3ccb79d83018e
author: Paul Brossier <piem@piem.org>
date: Sat Dec 7 06:58:30 EST 2013

src/pitch/pitch.h: improve documentation

--- a/src/pitch/pitch.h
+++ b/src/pitch/pitch.h
@@ -79,6 +79,8 @@
   \param o pitch detection object as returned by new_aubio_pitch()
   \param mode set pitch units for output
 
+  \return 0 if successfull, non-zero otherwise
+
 */
 uint_t aubio_pitch_set_unit (aubio_pitch_t * o, char_t * mode);
 
@@ -87,14 +89,16 @@
   \param o pitch detection object as returned by new_aubio_pitch()
   \param silence level threshold under which pitch should be ignored, in dB
 
+  \return 0 if successfull, non-zero otherwise
+
 */
 uint_t aubio_pitch_set_silence (aubio_pitch_t * o, smpl_t silence);
 
 /** set the silence threshold of the pitch detection object
 
-  \param o pitch detection object as returned by new_aubio_pitch()
+  \param o pitch detection object as returned by ::new_aubio_pitch()
 
-  \param return level threshold under which pitch should be ignored, in dB
+  \return level threshold under which pitch should be ignored, in dB
 
 */
 smpl_t aubio_pitch_get_silence (aubio_pitch_t * o);
@@ -102,9 +106,8 @@
 /** get the current confidence
 
   \param o pitch detection object as returned by new_aubio_pitch()
-  \return the current confidence of the pitch algorithm
 
-The confidence
+  \return the current confidence of the pitch algorithm
 
 */
 smpl_t aubio_pitch_get_confidence (aubio_pitch_t * o);
--