pbutils: Add/fix various annotations

[platform/upstream/gstreamer.git] / subprojects / gst-plugins-base / gst-libs / gst / pbutils / missing-plugins.c

diff --git a/subprojects/gst-plugins-base/gst-libs/gst/pbutils/missing-plugins.c b/subprojects/gst-plugins-base/gst-libs/gst/pbutils/missing-plugins.c
index 52540bc..69330b9 100644 (file)
--- a/subprojects/gst-plugins-base/gst-libs/gst/pbutils/missing-plugins.c
+++ b/subprojects/gst-plugins-base/gst-libs/gst/pbutils/missing-plugins.c
@@ -205,7 +205,7 @@ copy_and_clean_caps (const GstCaps * caps)
  * that a source element for a particular URI protocol is missing. This
  * function is mainly for use in plugins.
  *
- * Returns: (transfer full): a new #GstMessage, or NULL on error
+ * Returns: (transfer full): a new #GstMessage
  */
 GstMessage *
 gst_missing_uri_source_message_new (GstElement * element,
@@ -238,7 +238,7 @@ gst_missing_uri_source_message_new (GstElement * element,
  * that a sink element for a particular URI protocol is missing. This
  * function is mainly for use in plugins.
  *
- * Returns: (transfer full): a new #GstMessage, or NULL on error
+ * Returns: (transfer full): a new #GstMessage
  */
 GstMessage *
 gst_missing_uri_sink_message_new (GstElement * element, const gchar * protocol)
@@ -270,7 +270,7 @@ gst_missing_uri_sink_message_new (GstElement * element, const gchar * protocol)
  * that a certain required element is missing. This function is mainly for
  * use in plugins.
  *
- * Returns: (transfer full): a new #GstMessage, or NULL on error
+ * Returns: (transfer full): a new #GstMessage
  */
 GstMessage *
 gst_missing_element_message_new (GstElement * element,
@@ -302,7 +302,7 @@ gst_missing_element_message_new (GstElement * element,
  * that a decoder element for a particular set of (fixed) caps is missing.
  * This function is mainly for use in plugins.
  *
- * Returns: (transfer full): a new #GstMessage, or NULL on error
+ * Returns: (transfer full): a new #GstMessage
  */
 GstMessage *
 gst_missing_decoder_message_new (GstElement * element,
@@ -342,7 +342,7 @@ gst_missing_decoder_message_new (GstElement * element,
  * that an encoder element for a particular set of (fixed) caps is missing.
  * This function is mainly for use in plugins.
  *
- * Returns: (transfer full): a new #GstMessage, or NULL on error
+ * Returns: (transfer full): a new #GstMessage
  */
 GstMessage *
 gst_missing_encoder_message_new (GstElement * element,
@@ -433,7 +433,7 @@ missing_structure_get_caps_detail (const GstStructure * s, GstCaps ** p_caps)
  * This function is mainly for applications that call external plugin
  * installation mechanisms using one of the two above-mentioned functions.
  *
- * Returns: a newly-allocated detail string, or NULL on error. Free string
+ * Returns: (nullable): a newly-allocated detail string, or NULL on error. Free string
  *          with g_free() when not needed any longer.
  */
 gchar *
@@ -530,7 +530,7 @@ error:
  * describing a missing plugin, given a previously collected missing-plugin
  * message
  *
- * Returns: a newly-allocated description string, or NULL on error. Free
+ * Returns: a newly-allocated description string. Free
  *          string with g_free() when not needed any longer.
  */
 gchar *
@@ -691,7 +691,7 @@ gst_installer_detail_new (gchar * description, const gchar * type,
  * the case where the application knows exactly what kind of plugin it is
  * missing.
  *
- * Returns: a newly-allocated detail string, or NULL on error. Free string
+ * Returns: (transfer full): a newly-allocated detail string. Free string
  *          with g_free() when not needed any longer.
  */
 gchar *
@@ -719,7 +719,7 @@ gst_missing_uri_source_installer_detail_new (const gchar * protocol)
  * the case where the application knows exactly what kind of plugin it is
  * missing.
  *
- * Returns: a newly-allocated detail string, or NULL on error. Free string
+ * Returns: (transfer full): a newly-allocated detail string. Free string
  *          with g_free() when not needed any longer.
  */
 gchar *
@@ -747,7 +747,7 @@ gst_missing_uri_sink_installer_detail_new (const gchar * protocol)
  * the case where the application knows exactly what kind of plugin it is
  * missing.
  *
- * Returns: a newly-allocated detail string, or NULL on error. Free string
+ * Returns: (transfer full): a newly-allocated detail string. Free string
  *          with g_free() when not needed any longer.
  */
 gchar *
@@ -774,7 +774,7 @@ gst_missing_element_installer_detail_new (const gchar * factory_name)
  * the case where the application knows exactly what kind of plugin it is
  * missing.
  *
- * Returns: a newly-allocated detail string, or NULL on error. Free string
+ * Returns: (transfer full): a newly-allocated detail string. Free string
  *          with g_free() when not needed any longer.
  */
 gchar *
@@ -812,7 +812,7 @@ gst_missing_decoder_installer_detail_new (const GstCaps * decode_caps)
  * the case where the application knows exactly what kind of plugin it is
  * missing.
  *
- * Returns: a newly-allocated detail string, or NULL on error. Free string
+ * Returns: (transfer full): a newly-allocated detail string. Free string
  *          with g_free() when not needed any longer.
  */
 gchar *