summaryrefslogtreecommitdiffstats
path: root/ext/pulse
diff options
context:
space:
mode:
authorStefan Kost <ensonic@users.sf.net>2009-01-28 17:46:06 +0200
committerStefan Kost <ensonic@users.sf.net>2009-01-28 18:05:09 +0200
commit9cf73bdd8f18505269fa4b6d1d80127945e735b1 (patch)
tree799b0f7efa6d37844173fbd636bc58254cbccd78 /ext/pulse
parent1f32369451bd5ddf7a59defef7900d508ee144da (diff)
Update and add documentation for plugins with deps (ext).
Link to properties. Correct titles for examples. Document a few trivial cases. Keep lists in section file and docs/plugins/Makefile.am alphabetically ordered. Fix warnings that gtk-doc points out.
Diffstat (limited to 'ext/pulse')
-rw-r--r--ext/pulse/pulsemixer.c6
-rw-r--r--ext/pulse/pulsesink.c22
-rw-r--r--ext/pulse/pulsesrc.c14
3 files changed, 14 insertions, 28 deletions
diff --git a/ext/pulse/pulsemixer.c b/ext/pulse/pulsemixer.c
index 3a0de9da..5ced971b 100644
--- a/ext/pulse/pulsemixer.c
+++ b/ext/pulse/pulsemixer.c
@@ -21,16 +21,14 @@
/**
* SECTION:element-pulsemixer
- * @short_description: Element to control sound input and output levels for the PulseAudio sound server
* @see_also: pulsesrc, pulsesink
*
- * <refsect2>
- * <para>
* This element lets you adjust sound input and output levels for the
* PulseAudio sound server. It supports the GstMixer interface, which can be
* used to obtain a list of available mixer tracks. Set the mixer element to
* READY state before using the GstMixer interface on it.
- * </para>
+ *
+ * <refsect2>
* <title>Example pipelines</title>
* <para>
* pulsemixer can't be used in a sensible way in gst-launch.
diff --git a/ext/pulse/pulsesink.c b/ext/pulse/pulsesink.c
index df774990..b41dba50 100644
--- a/ext/pulse/pulsesink.c
+++ b/ext/pulse/pulsesink.c
@@ -21,28 +21,20 @@
/**
* SECTION:element-pulsesink
- * @short_description: Output audio to a PulseAudio sound server
* @see_also: pulsesrc, pulsemixer
*
+ * This element outputs audio to a
+ * <ulink href="http://www.pulseaudio.org">PulseAudio sound server</ulink>.
+ *
* <refsect2>
- * <para>
- * This element outputs audio to a PulseAudio sound server.
- * </para>
* <title>Example pipelines</title>
- * <para>
- * <programlisting>
+ * |[
* gst-launch -v filesrc location=sine.ogg ! oggdemux ! vorbisdec ! audioconvert ! audioresample ! pulsesink
- * </programlisting>
- * Play an Ogg/Vorbis file.
- * </para>
- * <para>
- * <programlisting>
+ * ]| Play an Ogg/Vorbis file.
+ * |[
* gst-launch -v audiotestsrc ! audioconvert ! volume volume=0.4 ! pulsesink
- * </programlisting>
- * Play a 440Hz sine wave.
- * </para>
+ * ]| Play a 440Hz sine wave.
* </refsect2>
- *
*/
#ifdef HAVE_CONFIG_H
diff --git a/ext/pulse/pulsesrc.c b/ext/pulse/pulsesrc.c
index 0e1ca20e..08fec595 100644
--- a/ext/pulse/pulsesrc.c
+++ b/ext/pulse/pulsesrc.c
@@ -21,20 +21,16 @@
/**
* SECTION:element-pulsesrc
- * @short_description: Capture audio from a PulseAudio sound server
* @see_also: pulsesink, pulsemixer
*
+ * This element captures audio from a
+ * <ulink href="http://www.pulseaudio.org">PulseAudio sound server</ulink>.
+ *
* <refsect2>
- * <para>
- * This element captures audio from a PulseAudio sound server.
- * </para>
* <title>Example pipelines</title>
- * <para>
- * <programlisting>
+ * |[
* gst-launch -v pulsesrc ! audioconvert ! vorbisenc ! oggmux ! filesink location=alsasrc.ogg
- * </programlisting>
- * Record from a sound card using ALSA and encode to Ogg/Vorbis.
- * </para>
+ * ]| Record from a sound card using ALSA and encode to Ogg/Vorbis.
* </refsect2>
*/