gst/gstregistry.c: Improve the documentation.

Original commit message from CVS:
* gst/gstregistry.c:
Improve the documentation.

diff --git a/ChangeLog b/ChangeLog
index 0a8b1b2..871ff33 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,10 @@
 2008-04-23  Stefan Kost  <ensonic@users.sf.net>
 
+       * gst/gstregistry.c:
+         Improve the documentation.
+
+2008-04-23  Stefan Kost  <ensonic@users.sf.net>
+
        * gst/gstsegment.c:
          The glib macro seems to be borked. Use g_slice_copy directly and cast
          in the hope that this fixes the warning on 64bit.

diff --git a/common b/common
index 19a5a66..f6fc3fa 160000 (submodule)
--- a/common
+++ b/common
@@ -1 +1 @@
-Subproject commit 19a5a66b2dff75e2820bb2b2d43368d4fcb6a94a
+Subproject commit f6fc3fa7643c03eb912f4e259d48c99b0e8d0aca

diff --git a/gst/gstregistry.c b/gst/gstregistry.c
index d2aa37a..7d78876 100644 (file)
--- a/gst/gstregistry.c
+++ b/gst/gstregistry.c
@@ -545,7 +545,8 @@ gst_registry_plugin_filter (GstRegistry * registry,
  * If the first flag is set, only the first match is
  * returned (as a list with a single object).
  *
- * Returns: a GList of plugin features, gst_plugin_feature_list_free after use.
+ * Returns: a #GList of #GstPluginFeature. Use gst_plugin_list_free() after
+ * usage.
  *
  * MT safe.
  */
@@ -652,8 +653,8 @@ gst_registry_find_feature (GstRegistry * registry, const gchar * name,
  *
  * Retrieves a #GList of #GstPluginFeature of @type.
  *
- * Returns: a #GList of #GstPluginFeature of @type. gst_plugin_feature_list_free
- * after usage.
+ * Returns: a #GList of #GstPluginFeature of @type. Use
+ * gst_plugin_feature_list_free() after usage.
  *
  * MT safe.
  */
@@ -680,7 +681,7 @@ gst_registry_get_feature_list (GstRegistry * registry, GType type)
  * Get a copy of all plugins registered in the given registry. The refcount
  * of each element in the list in incremented.
  *
- * Returns: a #GList of #GstPlugin. gst_plugin_list_free after use.
+ * Returns: a #GList of #GstPlugin. Use gst_plugin_list_free() after usage.
  *
  * MT safe.
  */
@@ -990,7 +991,8 @@ _gst_plugin_feature_filter_plugin_name (GstPluginFeature * feature,
  *
  * Retrieves a #GList of features of the plugin with name @name.
  *
- * Returns: a #GList of #GstPluginFeature. gst_plugin_feature_list_free() after usage.
+ * Returns: a #GList of #GstPluginFeature. Use gst_plugin_feature_list_free()
+ * after usage.
  */
 GList *
 gst_registry_get_feature_list_by_plugin (GstRegistry * registry,