doc: More doc warning fixes

So from this point, the remaining warning for libgstreamer are about
protected member not showing in the doc. This may need some discussion
with upstream gtk-doc people.

* Remove % in from of none macro
* Fixed GST_TYPE_FAGS -> GST_TYPE_FAG_SET
* Minor wording fix
* Can't link to GstUri.port, so split the .port part

diff --git a/gst/gstdevicemonitor.c b/gst/gstdevicemonitor.c
index a1b1180..b055934 100644 (file)
--- a/gst/gstdevicemonitor.c
+++ b/gst/gstdevicemonitor.c
@@ -430,7 +430,7 @@ gst_device_monitor_stop (GstDeviceMonitor * monitor)
  *
  * Filters must be added before the #GstDeviceMonitor is started.
  *
- * Returns: The id of the new filter or %0 if no provider matched the filter's
+ * Returns: The id of the new filter or 0 if no provider matched the filter's
  *  classes.
  *
  * Since: 1.4

diff --git a/gst/gsturi.c b/gst/gsturi.c
index 9af50e8..3efaae3 100644 (file)
--- a/gst/gsturi.c
+++ b/gst/gsturi.c
@@ -27,8 +27,8 @@
  * SECTION:gsturihandler
  * @short_description: Interface to ease URI handling in plugins.
  *
- * The URIHandler is an interface that is implemented by Source and Sink
- * #GstElement to simplify then handling of URI.
+ * The #GstURIHandler is an interface that is implemented by Source and Sink
+ * #GstElement to unify handling of URI.
  *
  * An application can use the following functions to quickly get an element
  * that handles the given URI for reading or writing

diff --git a/gst/gsturi.h b/gst/gsturi.h
index 2542c15..64dc65b 100644 (file)
--- a/gst/gsturi.h
+++ b/gst/gsturi.h
@@ -177,7 +177,7 @@ typedef struct _GstUri GstUri;
 /**
  * GST_URI_NO_PORT:
  *
- * Value for #GstUri.port to indicate no port number.
+ * Value for #GstUri<!-- -->.port to indicate no port number.
  */
 #define GST_URI_NO_PORT 0
 

diff --git a/gst/gstvalue.c b/gst/gstvalue.c
index 4310222..8bd16dc 100644 (file)
--- a/gst/gstvalue.c
+++ b/gst/gstvalue.c
@@ -6149,7 +6149,7 @@ gst_value_lcopy_flagset (const GValue * value, guint n_collect_values,
 
 /**
  * gst_value_set_flagset:
- * @value: a GValue initialized to #GST_TYPE_FLAGS
+ * @value: a GValue initialized to %GST_TYPE_FLAG_SET
  * @flags: The value of the flags set or unset
  * @mask: The mask indicate which flags bits must match for comparisons
  *