From 4e3723d3d90422d034d7fb88bbe9467bf9fbfe54 Mon Sep 17 00:00:00 2001
From: Paul Brossier <piem@piem.org>
Date: Sun, 3 Mar 2013 14:33:36 -0500
Subject: [PATCH] src/io/: add link to examples and missing c++ extern

---
 src/io/sink.h               |  8 ++++----
 src/io/sink_apple_audio.h   | 10 ++++++----
 src/io/sink_sndfile.h       | 10 ++++++----
 src/io/sndfileio.h          |  6 ++++--
 src/io/source.h             | 10 ++++++----
 src/io/source_apple_audio.h | 16 ++++++++++++++++
 src/io/source_sndfile.h     | 14 ++++++++++++++
 7 files changed, 56 insertions(+), 18 deletions(-)

diff --git a/src/io/sink.h b/src/io/sink.h
index 5db236e3..846b1acf 100644
--- a/src/io/sink.h
+++ b/src/io/sink.h
@@ -21,10 +21,6 @@
 #ifndef _AUBIO_SINK_H
 #define _AUBIO_SINK_H
 
-#ifdef __cplusplus
-extern "C" {
-#endif
-
 /** \file
 
   Media sink
@@ -33,6 +29,10 @@ extern "C" {
 
 */
 
+#ifdef __cplusplus
+extern "C" {
+#endif
+
 typedef struct _aubio_sink_t aubio_sink_t;
 aubio_sink_t * new_aubio_sink(char_t * uri, uint_t samplerate);
 void aubio_sink_do(aubio_sink_t * s, fvec_t * write_data, uint_t written);
diff --git a/src/io/sink_apple_audio.h b/src/io/sink_apple_audio.h
index 5403fa2a..13dae942 100644
--- a/src/io/sink_apple_audio.h
+++ b/src/io/sink_apple_audio.h
@@ -21,16 +21,18 @@
 #ifndef _AUBIO_SINK_APPLE_AUDIO_H
 #define _AUBIO_SINK_APPLE_AUDIO_H
 
-#ifdef __cplusplus
-extern "C" {
-#endif
-
 /** \file
 
   Apple Audio Media
 
+  \example io/test-sink_apple_audio.c
+
 */
 
+#ifdef __cplusplus
+extern "C" {
+#endif
+
 typedef struct _aubio_sink_apple_audio_t aubio_sink_apple_audio_t;
 aubio_sink_apple_audio_t * new_aubio_sink_apple_audio(char_t * method, uint_t samplerate);
 void aubio_sink_apple_audio_do(aubio_sink_apple_audio_t * s, fvec_t * write_data, uint_t write);
diff --git a/src/io/sink_sndfile.h b/src/io/sink_sndfile.h
index df913489..330ed39f 100644
--- a/src/io/sink_sndfile.h
+++ b/src/io/sink_sndfile.h
@@ -21,16 +21,18 @@
 #ifndef _AUBIO_SINK_SNDFILE_H
 #define _AUBIO_SINK_SNDFILE_H
 
-#ifdef __cplusplus
-extern "C" {
-#endif
-
 /** \file
 
   sndfile sink
 
+  \example io/test-sink_sndfile.c
+
 */
 
+#ifdef __cplusplus
+extern "C" {
+#endif
+
 typedef struct _aubio_sink_sndfile_t aubio_sink_sndfile_t;
 aubio_sink_sndfile_t * new_aubio_sink_sndfile(char_t * method, uint_t samplerate);
 void aubio_sink_sndfile_do(aubio_sink_sndfile_t * s, fvec_t * write_data, uint_t write);
diff --git a/src/io/sndfileio.h b/src/io/sndfileio.h
index 73d78b0a..36846437 100644
--- a/src/io/sndfileio.h
+++ b/src/io/sndfileio.h
@@ -21,8 +21,10 @@
 #ifndef SNDFILEIO_H
 #define SNDFILEIO_H
 
-/** @file 
- * sndfile functions
+/** \file
+
+  sndfile functions
+
  */
 
 #ifdef __cplusplus
diff --git a/src/io/source.h b/src/io/source.h
index e6073127..1659f6fe 100644
--- a/src/io/source.h
+++ b/src/io/source.h
@@ -21,16 +21,18 @@
 #ifndef _AUBIO_SOURCE_H
 #define _AUBIO_SOURCE_H
 
-#ifdef __cplusplus
-extern "C" {
-#endif
-
 /** \file
 
   Media source 
 
+  \example io/test-source.c
+
 */
 
+#ifdef __cplusplus
+extern "C" {
+#endif
+
 typedef struct _aubio_source_t aubio_source_t;
 aubio_source_t * new_aubio_source(char_t * uri, uint_t samplerate, uint_t hop_size);
 void aubio_source_do(aubio_source_t * s, fvec_t * read_data, uint_t * read);
diff --git a/src/io/source_apple_audio.h b/src/io/source_apple_audio.h
index fe6e9cce..d6744120 100644
--- a/src/io/source_apple_audio.h
+++ b/src/io/source_apple_audio.h
@@ -21,10 +21,26 @@
 #ifndef _AUBIO_SOURCE_APPLE_AUDIO_H
 #define _AUBIO_SOURCE_APPLE_AUDIO_H
 
+/** \file
+
+  aubio source using ExtAudioFileRef
+
+  \example io/test-source_apple_audio.c
+
+*/
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
 typedef struct _aubio_source_apple_audio_t aubio_source_apple_audio_t;
 aubio_source_apple_audio_t * new_aubio_source_apple_audio(char_t * path, uint_t samplerate, uint_t block_size);
 void aubio_source_apple_audio_do(aubio_source_apple_audio_t * s, fvec_t * read_to, uint_t * read);
 uint_t aubio_source_apple_audio_get_samplerate(aubio_source_apple_audio_t * s);
 void del_aubio_source_apple_audio(aubio_source_apple_audio_t * s);
 
+#ifdef __cplusplus
+}
+#endif
+
 #endif /* _AUBIO_SOURCE_APPLE_AUDIO_H */
diff --git a/src/io/source_sndfile.h b/src/io/source_sndfile.h
index cfa38b7e..1dff6d8e 100644
--- a/src/io/source_sndfile.h
+++ b/src/io/source_sndfile.h
@@ -21,10 +21,24 @@
 #ifndef _AUBIO_SOURCE_SNDFILE_H
 #define _AUBIO_SOURCE_SNDFILE_H
 
+/** \file
+
+  \example io/test-source_sndfile.c
+
+*/
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
 typedef struct _aubio_source_sndfile_t aubio_source_sndfile_t;
 aubio_source_sndfile_t * new_aubio_source_sndfile(char_t * path, uint_t samplerate, uint_t block_size);
 void aubio_source_sndfile_do(aubio_source_sndfile_t * s, fvec_t * read_to, uint_t * read);
 uint_t aubio_source_sndfile_get_samplerate(aubio_source_sndfile_t * s);
 void del_aubio_source_sndfile(aubio_source_sndfile_t * s);
 
+#ifdef __cplusplus
+}
+#endif
+
 #endif /* _AUBIO_SOURCE_SNDFILE_H */
-- 
2.26.2