doc: link examples to Doxygen docs

Include examples to the documentation, using Doxygen's example system.

src/examples/audio-dsp-filter.c

@@ -22,6 +22,12 @@
  * DEALINGS IN THE SOFTWARE.
  */
 
+/*
+ [title]
+ Audio filter using \ref pw_filter "pw_filter".
+ [title]
+ */
+
 #include <stdio.h>
 #include <errno.h>
 #include <math.h>

src/examples/audio-dsp-src.c

@@ -22,6 +22,12 @@
  * DEALINGS IN THE SOFTWARE.
  */
 
+/*
+ [title]
+ Audio source using \ref pw_filter "pw_filter"
+ [title]
+ */
+
 #include <stdio.h>
 #include <errno.h>
 #include <math.h>

src/examples/audio-src.c

@@ -22,6 +22,12 @@
  * DEALINGS IN THE SOFTWARE.
  */
 
+/*
+ [title]
+ Audio source using \ref pw_stream "pw_stream".
+ [title]
+ */
+
 #include <stdio.h>
 #include <errno.h>
 #include <math.h>

src/examples/bluez-session.c

@@ -22,6 +22,12 @@
  * DEALINGS IN THE SOFTWARE.
  */
 
+/*
+ [title]
+ Using the \ref spa_device "SPA Device API", among other things.
+ [title]
+ */
+
 #include <string.h>
 #include <stdio.h>
 #include <errno.h>

src/examples/export-sink.c

@@ -22,6 +22,12 @@
  * DEALINGS IN THE SOFTWARE.
  */
 
+/*
+ [title]
+ Exporting and implementing a video sink SPA node, using \ref api_pw_core.
+ [title]
+ */
+
 #include <errno.h>
 #include <stdio.h>
 #include <sys/mman.h>

src/examples/export-source.c

@@ -22,6 +22,12 @@
  * DEALINGS IN THE SOFTWARE.
  */
 
+/*
+ [title]
+ Exporting and implementing a video source SPA node, using \ref api_pw_core.
+ [title]
+ */
+
 #include <errno.h>
 #include <stdio.h>
 #include <math.h>

src/examples/export-spa-device.c

@@ -22,6 +22,12 @@
  * DEALINGS IN THE SOFTWARE.
  */
 
+/*
+ [title]
+ Exporting and loading a SPA device, using \ref api_pw_core.
+ [title]
+ */
+
 #include <stdio.h>
 #include <sys/mman.h>
 #include <signal.h>

src/examples/export-spa.c

@@ -22,6 +22,12 @@
  * DEALINGS IN THE SOFTWARE.
  */
 
+/*
+ [title]
+ Exporting and loading a SPA node, using \ref api_pw_core.
+ [title]
+ */
+
 #include <stdio.h>
 #include <sys/mman.h>
 #include <signal.h>

src/examples/local-v4l2.c

@@ -22,6 +22,12 @@
  * DEALINGS IN THE SOFTWARE.
  */
 
+/*
+ [title]
+ Using libspa-v4l2
+ [title]
+ */
+
 #include <stdio.h>
 #include <sys/mman.h>
 

src/examples/sdl.h

@@ -22,6 +22,12 @@
  * DEALINGS IN THE SOFTWARE.
  */
 
+/*
+ [title]
+ SDL2 video format conversions
+ [title]
+ */
+
 #include <SDL2/SDL.h>
 
 #include <spa/utils/type.h>

src/examples/video-dsp-play.c

@@ -22,6 +22,12 @@
  * DEALINGS IN THE SOFTWARE.
  */
 
+/*
+ [title]
+ Video input stream using \ref pw_filter "pw_filter".
+ [title]
+ */
+
 #include <stdio.h>
 #include <unistd.h>
 #include <sys/mman.h>

src/examples/video-play-pull.c

@@ -22,6 +22,12 @@
  * DEALINGS IN THE SOFTWARE.
  */
 
+/*
+ [title]
+ Video input stream using \ref pw_stream_trigger_process, for pull mode.
+ [title]
+ */
+
 #include <stdio.h>
 #include <unistd.h>
 #include <signal.h>

src/examples/video-play-reneg.c

@@ -22,6 +22,12 @@
  * DEALINGS IN THE SOFTWARE.
  */
 
+/*
+ [title]
+ Video input stream using \ref pw_stream "pw_stream", with format renegotiation.
+ [title]
+ */
+
 #include <stdio.h>
 #include <unistd.h>
 #include <signal.h>

src/examples/video-play.c

@@ -22,6 +22,12 @@
  * DEALINGS IN THE SOFTWARE.
  */
 
+/*
+ [title]
+ Video input stream using \ref pw_stream "pw_stream".
+ [title]
+ */
+
 #include <stdio.h>
 #include <unistd.h>
 #include <signal.h>

src/examples/video-src-alloc.c

@@ -22,6 +22,12 @@
  * DEALINGS IN THE SOFTWARE.
  */
 
+/*
+ [title]
+ Allocating buffer memory and sending fds to the server.
+ [title]
+ */
+
 #include "config.h"
 
 #include <stdio.h>

src/examples/video-src-reneg.c

@@ -22,6 +22,12 @@
  * DEALINGS IN THE SOFTWARE.
  */
 
+/*
+ [title]
+ Renegotiating video producer and consumer formats with \ref pw_stream
+ [title]
+ */
+
 #include "config.h"
 
 #include <stdio.h>

src/examples/video-src.c

@@ -22,6 +22,12 @@
  * DEALINGS IN THE SOFTWARE.
  */
 
+/*
+ [title]
+ Video source using \ref pw_stream.
+ [title]
+ */
+
 #include <stdio.h>
 #include <errno.h>
 #include <signal.h>