[0.11] gstreamer: docs: fix some gtk-doc warnings

[Edward Hervey]

Module: gstreamer
Branch: 0.11
Commit: 84eafff61b7e2d086439cc63365909a1c4ea6cd5
URL:    http://cgit.freedesktop.org/gstreamer/gstreamer/commit/?id=84eafff61b7e2d086439cc63365909a1c4ea6cd5

Author: Stefan Kost <ensonic at users.sf.net>
Date:   Thu Mar 24 18:27:09 2011 +0200

docs: fix some gtk-doc warnings

Document the queue leaky enums.

---

 docs/plugins/gstreamer-plugins-sections.txt |    1 +
 plugins/elements/gstqueue.h                 |   25 +++++++++++++++++--------
 2 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/docs/plugins/gstreamer-plugins-sections.txt b/docs/plugins/gstreamer-plugins-sections.txt
index 1854112..742fdf9 100644
--- a/docs/plugins/gstreamer-plugins-sections.txt
+++ b/docs/plugins/gstreamer-plugins-sections.txt
@@ -149,6 +149,7 @@ GST_INPUT_SELECTOR_WAIT
 <FILE>element-queue</FILE>
 <TITLE>queue</TITLE>
 GstQueue
+GstQueueLeaky
 <SUBSECTION Standard>
 GstQueueClass
 GST_QUEUE
diff --git a/plugins/elements/gstqueue.h b/plugins/elements/gstqueue.h
index c72bcb7..6ab8617 100644
--- a/plugins/elements/gstqueue.h
+++ b/plugins/elements/gstqueue.h
@@ -39,17 +39,26 @@ G_BEGIN_DECLS
 #define GST_IS_QUEUE_CLASS(klass) \
   (G_TYPE_CHECK_CLASS_TYPE((klass),GST_TYPE_QUEUE))
 
-enum {
-  GST_QUEUE_NO_LEAK             = 0,
-  GST_QUEUE_LEAK_UPSTREAM       = 1,
-  GST_QUEUE_LEAK_DOWNSTREAM     = 2
-};
-
 typedef struct _GstQueue GstQueue;
 typedef struct _GstQueueSize GstQueueSize;
+typedef enum _GstQueueLeaky GstQueueLeaky;
 typedef struct _GstQueueClass GstQueueClass;
 
 /**
+ * GstQueueLeaky:
+ * @GST_QUEUE_NO_LEAK: Not Leaky
+ * @GST_QUEUE_LEAK_UPSTREAM: Leaky on upstream (new buffers)
+ * @GST_QUEUE_LEAK_DOWNSTREAM: Leaky on downstream (old buffers)
+ *
+ * Buffer dropping scheme to avoid the queue to block when full.
+ */
+enum _GstQueueLeaky {
+  GST_QUEUE_NO_LEAK             = 0,
+  GST_QUEUE_LEAK_UPSTREAM       = 1,
+  GST_QUEUE_LEAK_DOWNSTREAM     = 2
+};
+
+/*
  * GstQueueSize:
  * @buffers: number of buffers
  * @bytes: number of bytes
@@ -115,8 +124,8 @@ struct _GstQueue {
 
   gboolean head_needs_discont, tail_needs_discont;
   gboolean push_newsegment;
-  
-  gboolean silent;      /* don't emit signals */ 
+
+  gboolean silent;      /* don't emit signals */
 
   /* whether the first new segment has been applied to src */
   gboolean newseg_applied_to_src;