X-Git-Url: https://code.delx.au/pulseaudio/blobdiff_plain/f693aa4c8811b67377a4fcc55887d03876fb48be..ca2265f37277081b4fe82e375923483c2e03931d:/polyp/polyplib-simple.h

diff --git a/polyp/polyplib-simple.h b/polyp/polyplib-simple.h
index ee2e27e3..ed552cb4 100644
--- a/polyp/polyplib-simple.h
+++ b/polyp/polyplib-simple.h
@@ -29,12 +29,20 @@
 #include "cdecl.h"
 
 /** \file
- * A simple but limited synchronous playback and recording API. */
+ * A simple but limited synchronous playback and recording
+ * API. This is synchronouse, simplified wrapper around the standard
+ * asynchronous API. */
+
+/** \example pacat-simple.c
+ * A simple playback tool using the simple API */
+
+/** \example parec-simple.c
+ * A simple recording tool using the simple API */
 
 PA_C_DECL_BEGIN
 
 /** \struct pa_simple
- * A simple connection object */
+ * An opaque simple connection object */
 struct pa_simple;
 
 /** Create a new connection to the server */