validate: Fix annotations

Skipping all functions and methods that are not relevant and not easily
introspectable

Differential Revision: https://phabricator.freedesktop.org/D706

validate/gst/validate/gst-validate-media-info.c

@@ -164,6 +164,9 @@ gst_validate_media_info_save (GstValidateMediaInfo * mi, const gchar * path,
   return TRUE;
 }
 
+/**
+ * gst_validate_media_info_load: (skip):
+ */
 GstValidateMediaInfo *
 gst_validate_media_info_load (const gchar * path, GError ** err)
 {

validate/gst/validate/gst-validate-monitor.c

@@ -246,6 +246,12 @@ gst_validate_monitor_setup (GstValidateMonitor * monitor)
   return GST_VALIDATE_MONITOR_GET_CLASS (monitor)->setup (monitor);
 }
 
+/**
+ * gst_validate_monitor_get_element
+ * @monitor: The monitor
+ *
+ * Returns: (transfer none): The GstElement associated with @monitor
+ */
 GstElement *
 gst_validate_monitor_get_element (GstValidateMonitor * monitor)
 {

validate/gst/validate/gst-validate-override-registry.c

@@ -109,6 +109,9 @@ gst_validate_overide_registery_free (GstValidateOverrideRegistry * reg)
   g_slice_free (GstValidateOverrideRegistry, reg);
 }
 
+/**
+ * gst_validate_override_registry_get: (skip):
+ */
 GstValidateOverrideRegistry *
 gst_validate_override_registry_get (void)
 {
@@ -417,6 +420,9 @@ gst_validate_override_registry_preload (void)
   return nloaded;
 }
 
+/**
+ * gst_validate_override_registry_get_override_for_names: (skip):
+ */
 GList *gst_validate_override_registry_get_override_for_names
     (GstValidateOverrideRegistry * reg, const gchar * name, ...)
 {

validate/gst/validate/gst-validate-override.c

@@ -162,6 +162,9 @@ gst_validate_override_get_severity (GstValidateOverride * override,
   return default_level;
 }
 
+/**
+ * gst_validate_override_set_event_handler: (skip):
+ */
 void
 gst_validate_override_set_event_handler (GstValidateOverride * override,
     GstValidateOverrideEventHandler handler)
@@ -169,6 +172,9 @@ gst_validate_override_set_event_handler (GstValidateOverride * override,
   override->event_handler = handler;
 }
 
+/**
+ * gst_validate_override_set_buffer_handler : (skip):
+ */
 void
 gst_validate_override_set_buffer_handler (GstValidateOverride * override,
     GstValidateOverrideBufferHandler handler)
@@ -176,6 +182,9 @@ gst_validate_override_set_buffer_handler (GstValidateOverride * override,
   override->buffer_handler = handler;
 }
 
+/**
+ * gst_validate_override_set_query_handler: (skip):
+ */
 void
 gst_validate_override_set_query_handler (GstValidateOverride * override,
     GstValidateOverrideQueryHandler handler)
@@ -183,6 +192,9 @@ gst_validate_override_set_query_handler (GstValidateOverride * override,
   override->query_handler = handler;
 }
 
+/**
+ * gst_validate_override_set_buffer_probe_handler: (skip):
+ */
 void
 gst_validate_override_set_buffer_probe_handler (GstValidateOverride * override,
     GstValidateOverrideBufferHandler handler)
@@ -190,6 +202,9 @@ gst_validate_override_set_buffer_probe_handler (GstValidateOverride * override,
   override->buffer_probe_handler = handler;
 }
 
+/**
+ * gst_validate_override_set_getcaps_handler: (skip):
+ */
 void
 gst_validate_override_set_getcaps_handler (GstValidateOverride * override,
     GstValidateOverrideGetCapsHandler handler)
@@ -197,6 +212,9 @@ gst_validate_override_set_getcaps_handler (GstValidateOverride * override,
   override->getcaps_handler = handler;
 }
 
+/**
+ * gst_validate_override_set_setcaps_handler: (skip):
+ */
 void
 gst_validate_override_set_setcaps_handler (GstValidateOverride * override,
     GstValidateOverrideSetCapsHandler handler)
@@ -204,6 +222,9 @@ gst_validate_override_set_setcaps_handler (GstValidateOverride * override,
   override->setcaps_handler = handler;
 }
 
+/**
+ * gst_validate_override_event_handler: (skip):
+ */
 void
 gst_validate_override_event_handler (GstValidateOverride * override,
     GstValidateMonitor * monitor, GstEvent * event)
@@ -212,6 +233,9 @@ gst_validate_override_event_handler (GstValidateOverride * override,
     override->event_handler (override, monitor, event);
 }
 
+/**
+ * gst_validate_override_buffer_handler: (skip):
+ */
 void
 gst_validate_override_buffer_handler (GstValidateOverride * override,
     GstValidateMonitor * monitor, GstBuffer * buffer)
@@ -220,6 +244,9 @@ gst_validate_override_buffer_handler (GstValidateOverride * override,
     override->buffer_handler (override, monitor, buffer);
 }
 
+/**
+ * gst_validate_override_query_handler: (skip):
+ */
 void
 gst_validate_override_query_handler (GstValidateOverride * override,
     GstValidateMonitor * monitor, GstQuery * query)
@@ -228,6 +255,9 @@ gst_validate_override_query_handler (GstValidateOverride * override,
     override->query_handler (override, monitor, query);
 }
 
+/**
+ * gst_validate_override_buffer_probe_handler: (skip):
+ */
 void
 gst_validate_override_buffer_probe_handler (GstValidateOverride * override,
     GstValidateMonitor * monitor, GstBuffer * buffer)
@@ -236,6 +266,9 @@ gst_validate_override_buffer_probe_handler (GstValidateOverride * override,
     override->buffer_probe_handler (override, monitor, buffer);
 }
 
+/**
+ * gst_validate_override_getcaps_handler: (skip):
+ */
 void
 gst_validate_override_getcaps_handler (GstValidateOverride * override,
     GstValidateMonitor * monitor, GstCaps * caps)
@@ -244,6 +277,9 @@ gst_validate_override_getcaps_handler (GstValidateOverride * override,
     override->getcaps_handler (override, monitor, caps);
 }
 
+/**
+ * gst_validate_override_setcaps_handler: (skip):
+ */
 void
 gst_validate_override_setcaps_handler (GstValidateOverride * override,
     GstValidateMonitor * monitor, GstCaps * caps)
@@ -252,6 +288,9 @@ gst_validate_override_setcaps_handler (GstValidateOverride * override,
     override->setcaps_handler (override, monitor, caps);
 }
 
+/**
+ * gst_validate_override_can_attach: (skip):
+ */
 gboolean
 gst_validate_override_can_attach (GstValidateOverride * override,
     GstValidateMonitor * monitor)

validate/gst/validate/gst-validate-reporter.c

@@ -259,7 +259,7 @@ gst_validate_reporter_g_log_func (const gchar * log_domain,
 
 /**
  * gst_validate_report:
- * @report: The source of the new report
+ * @reporter: The source of the new report
  * @issue_id: The #GstValidateIssueId of the issue
  * @format: The format of the message describing the issue in a printf
  *       format followed by the parametters.
@@ -313,6 +313,12 @@ gst_validate_reporter_get_name (GstValidateReporter * reporter)
   return priv->name;
 }
 
+/**
+ * gst_validate_reporter_get_runner:
+ * @reporter: The reporter to get the runner from
+ *
+ * Returns: (transfer none): The runner
+ */
 GstValidateRunner *
 gst_validate_reporter_get_runner (GstValidateReporter * reporter)
 {

validate/gst/validate/gst-validate-scenario.c

@@ -2987,13 +2987,13 @@ gst_validate_action_set_done (GstValidateAction * action)
       (GDestroyNotify) gst_validate_action_unref);
 }
 
-/* gst_validate_action_get_scenario:
+/**
+ * gst_validate_action_get_scenario:
  * @action: The action from which to retrieve the scenario
  *
  * Retrieve the scenario from which @action is executed.
  *
- * Returns: (transfer full): The scenario from which the action
- * is being executed.
+ * Returns: (transfer full): The scenario from which the action is being executed.
  */
 GstValidateScenario *
 gst_validate_action_get_scenario (GstValidateAction * action)
@@ -3011,8 +3011,7 @@ gst_validate_action_get_scenario (GstValidateAction * action)
  * @function: (scope notified): The function to be called to execute the action
  * @parameters: (allow-none) (array zero-terminated=1) (element-type GstValidate.ActionParameter): The #GstValidateActionParameter usable as parameter of the type
  * @description: A description of the new type
- * @is_config: Whether the action is a config action or not. A config action will
- * be executed even before the pipeline starts processing
+ * @flags: The #GstValidateActionTypeFlags to set on the new action type
  *
  * Register a new action type to the action type system. If the action type already
  * exists, it will be overriden by that new definition

validate/gst/validate/gst-validate-utils.c

@@ -446,6 +446,9 @@ _read_power (MathParser * parser)
   return v0;
 }
 
+/**
+ * gst_validate_utils_parse_expression: (skip):
+ */
 gdouble
 gst_validate_utils_parse_expression (const gchar * expr,
     GstValidateGstValidateParseVariableFunc variable_func, gpointer user_data,
@@ -614,6 +617,9 @@ failed:
   goto done;
 }
 
+/**
+ * gst_validate_utils_structs_parse_from_filename: (skip):
+ */
 GList *
 gst_validate_utils_structs_parse_from_filename (const gchar * scenario_file)
 {
@@ -629,6 +635,9 @@ gst_validate_utils_structs_parse_from_filename (const gchar * scenario_file)
   return _lines_get_strutures (lines);
 }
 
+/**
+ * gst_validate_structs_parse_from_gfile: (skip):
+ */
 GList *
 gst_validate_structs_parse_from_gfile (GFile * scenario_file)
 {

validate/gst/validate/media-descriptor.c

@@ -536,6 +536,9 @@ gst_validate_media_descriptor_detects_frames (GstValidateMediaDescriptor * self)
   return self->filenode->frame_detection;
 }
 
+/**
+ * gst_validate_media_descriptor_get_buffers: (skip):
+ */
 gboolean
 gst_validate_media_descriptor_get_buffers (GstValidateMediaDescriptor * self,
     GstPad * pad, GCompareFunc compare_func, GList ** bufs)
@@ -630,6 +633,9 @@ gst_validate_media_descriptor_get_seekable (GstValidateMediaDescriptor * self)
   return self->filenode->seekable;
 }
 
+/**
+ * gst_validate_media_descriptor_get_pads: (skip):
+ */
 GList *
 gst_validate_media_descriptor_get_pads (GstValidateMediaDescriptor * self)
 {