ges: add some g-i annotations according to documentation

Mainly (transfer xxx) and (nullable). Also fix some typo.

https://bugzilla.gnome.org/show_bug.cgi?id=766459

ges/ges-asset.c

@@ -477,7 +477,7 @@ _gtask_return_true (GTask * task, gpointer udata)
  *
  * Looks for asset with specified id in cache and it's completely loaded.
  *
- * Returns: (transfer none): The #GESAsset found or %NULL
+ * Returns: (transfer none) (nullable): The #GESAsset found or %NULL
  */
 GESAsset *
 ges_asset_cache_lookup (GType extractable_type, const gchar * id)
@@ -770,7 +770,7 @@ ges_asset_list_proxies (GESAsset * asset)
  * ges_asset_get_proxy:
  * @asset: The #GESAsset to get currenlty used proxy
  *
- * Returns: (transfer none): The proxy in use for @asset
+ * Returns: (transfer none) (nullable): The proxy in use for @asset
  */
 GESAsset *
 ges_asset_get_proxy (GESAsset * asset)
@@ -788,7 +788,7 @@ ges_asset_get_proxy (GESAsset * asset)
  * ges_asset_get_proxy_target:
  * @proxy: The #GESAsset from which to get the the asset it proxies.
  *
- * Returns: (transfer none): The #GESAsset that is proxied by @proxy
+ * Returns: (transfer none) (nullable): The #GESAsset that is proxied by @proxy
  */
 GESAsset *
 ges_asset_get_proxy_target (GESAsset * proxy)
@@ -1283,8 +1283,8 @@ ges_list_assets (GType filter)
  * ges_asset_get_error:
  * @self: The asset to retrieve the error from
  *
- * Returns: (transfer none): The #GError of the asset or %NULL if the asset was
+ * Returns: (transfer none) (nullable): The #GError of the asset or %NULL if
- * loaded without issue
+ * the asset was loaded without issue
  *
  * Since: 1.8
  */

ges/ges-audio-test-source.c

@@ -203,7 +203,7 @@ ges_audio_test_source_get_volume (GESAudioTestSource * self)
  *
  * Creates a new #GESAudioTestSource.
  *
- * Returns: The newly created #GESAudioTestSource.
+ * Returns: (transfer floating) (nullable): The newly created #GESAudioTestSource.
  */
 GESAudioTestSource *
 ges_audio_test_source_new (void)

ges/ges-audio-track.c

@@ -114,7 +114,7 @@ ges_audio_track_class_init (GESAudioTrackClass * klass)
  * Creates a new #GESAudioTrack of type #GES_TRACK_TYPE_AUDIO and with generic
  * raw audio caps ("audio/x-raw");
  *
- * Returns: A new #GESTrack
+ * Returns: (transfer floating): A new #GESTrack
  */
 GESAudioTrack *
 ges_audio_track_new (void)

ges/ges-audio-transition.c

@@ -287,7 +287,7 @@ ges_audio_transition_duration_changed (GESTrackElement * track_element,
  *
  * Creates a new #GESAudioTransition.
  *
- * Returns: The newly created #GESAudioTransition.
+ * Returns: (transfer floating): The newly created #GESAudioTransition.
  */
 GESAudioTransition *
 ges_audio_transition_new (void)

ges/ges-audio-uri-source.c

@@ -185,8 +185,8 @@ ges_audio_uri_source_init (GESAudioUriSource * self)
  *
  * Creates a new #GESAudioUriSource for the provided @uri.
  *
- * Returns: The newly created #GESAudioUriSource, or %NULL if there was an
+ * Returns: (transfer floating) (nullable): The newly created
- * error.
+ * #GESAudioUriSource, or %NULL if there was an error.
  */
 GESAudioUriSource *
 ges_audio_uri_source_new (gchar * uri)

ges/ges-clip.c

@@ -824,8 +824,8 @@ ges_clip_init (GESClip * self)
  * keep a reference to the newly created trackelement, you therefore need to
  * call @ges_container_remove when you are done with it.
  *
- * Returns: (transfer none): A #GESTrackElement. Returns NULL if the #GESTrackElement could not
+ * Returns: (transfer none) (nullable): A #GESTrackElement. Returns NULL if
- * be created.
+ * the #GESTrackElement could not be created.
  */
 GESTrackElement *
 ges_clip_create_track_element (GESClip * clip, GESTrackType type)
@@ -1053,8 +1053,8 @@ ges_clip_move_to_layer (GESClip * clip, GESLayer * layer)
  * Note: If many objects match, then the one with the highest priority will be
  * returned.
  *
- * Returns: (transfer full): The #GESTrackElement used by @track, else %NULL,
+ * Returns: (transfer full) (nullable): The #GESTrackElement used by @track,
- * Unref after usage
+ * else %NULL. Unref after usage
  */
 
 GESTrackElement *
@@ -1090,7 +1090,7 @@ ges_clip_find_track_element (GESClip * clip, GESTrack * track, GType type)
  *
  * Get the #GESLayer to which this clip belongs.
  *
- * Returns: (transfer full): The #GESLayer where this @clip is being
+ * Returns: (transfer full) (nullable): The #GESLayer where this @clip is being
  * used, or %NULL if it is not used on any layer. The caller should unref it
  * usage.
  */
@@ -1265,8 +1265,8 @@ ges_clip_set_top_effect_index (GESClip * clip, GESBaseEffect * effect,
  * property must be registered using @ges_effect_class_register_rate_property;
  * for the 'pitch' plugin, this is already done.
  *
- * Returns: (transfer none): The newly created #GESClip resulting from the
+ * Returns: (transfer none) (nullable): The newly created #GESClip resulting
- * splitting
+ * from the splitting or %NULL if the clip can't be split.
  */
 GESClip *
 ges_clip_split (GESClip * clip, guint64 position)

ges/ges-effect-clip.c

@@ -176,7 +176,7 @@ _create_track_element (GESClip * self, GESTrackType type)
  *
  * Creates a new #GESEffectClip from the description of the bin.
  *
- * Returns: a newly created #GESEffectClip, or
+ * Returns: (transfer floating) (nullable): a newly created #GESEffectClip, or
  * %NULL if something went wrong.
  */
 GESEffectClip *

ges/ges-effect.c

@@ -257,7 +257,7 @@ ges_effect_create_element (GESTrackElement * object)
  * #ges_asset_request (GES_TYPE_EFFECT, "audio your ! bin ! description", NULL);
  * and extract that asset to be in full control.
  *
- * Returns: a newly created #GESEffect, or %NULL if something went
+ * Returns: (nullable): a newly created #GESEffect, or %NULL if something went
  * wrong.
  */
 GESEffect *

ges/ges-extractable.c

@@ -83,7 +83,8 @@ ges_extractable_default_init (GESExtractableInterface * iface)
  *
  * Method for getting an asset from a #GESExtractable
  *
- * Returns: (transfer none): The #GESAsset or %NULL if none has been set
+ * Returns: (transfer none) (nullable): The #GESAsset or %NULL if none has
+ * been set
  */
 GESAsset *
 ges_extractable_get_asset (GESExtractable * self)
@@ -212,8 +213,8 @@ ges_extractable_type_get_asset_type (GType type)
  *
  * Check if @id is valid for @type
  *
- * Returns: (transfer full): A newly allocated string containing the actuall
+ * Returns: (transfer full) (nullable): A newly allocated string containing
- * ID (after some processing) or %NULL if the ID is wrong.
+ * the actual ID (after some processing) or %NULL if the ID is wrong.
  */
 gchar *
 ges_extractable_type_check_id (GType type, const gchar * id, GError ** error)

ges/ges-group.c

@@ -791,7 +791,7 @@ ges_group_init (GESGroup * self)
  * together, it is recommanded to use the #ges_container_group method so the
  * proper subclass is selected.
  *
- * Returns: The new empty group.
+ * Returns: (transfer floating): The new empty group.
  */
 GESGroup *
 ges_group_new (void)

ges/ges-image-source.c

@@ -181,7 +181,7 @@ ges_image_source_init (GESImageSource * self)
  *
  * Creates a new #GESImageSource for the provided @uri.
  *
- * Returns: A new #GESImageSource.
+ * Returns: (transfer floating): A new #GESImageSource.
  */
 GESImageSource *
 ges_image_source_new (gchar * uri)

ges/ges-layer.c

@@ -502,7 +502,7 @@ ges_layer_is_empty (GESLayer * layer)
  * are constructed, you should connect to the container::child-added signal which
  * is emited right after those elements are ready to be used.
  *
- * Returns: TRUE if the clip was properly added to the layer, or FALSE
+ * Returns: %TRUE if the clip was properly added to the layer, or %FALSE
  * if the @layer refuses to add the clip.
  */
 gboolean
@@ -662,7 +662,7 @@ ges_layer_add_asset (GESLayer * layer,
  *
  * Creates a new #GESLayer.
  *
- * Returns: A new #GESLayer
+ * Returns: (transfer floating): A new #GESLayer
  */
 GESLayer *
 ges_layer_new (void)
@@ -676,7 +676,7 @@ ges_layer_new (void)
  *
  * Get the #GESTimeline in which #GESLayer currently is.
  *
- * Returns: (transfer none):  the #GESTimeline in which #GESLayer
+ * Returns: (transfer none) (nullable): the #GESTimeline in which #GESLayer
  * currently is or %NULL if not in any timeline yet.
  */
 GESTimeline *

ges/ges-meta-container.c

@@ -426,8 +426,8 @@ ges_meta_container_set_meta (GESMetaContainer * container,
  *
  * Serializes a meta container to a string.
  *
- * Returns: a newly-allocated string, or NULL in case of an error. The
+ * Returns: (nullable): a newly-allocated string, or NULL in case of an error.
- *    string must be freed with g_free() when no longer needed.
+ * The string must be freed with g_free() when no longer needed.
  */
 gchar *
 ges_meta_container_metas_to_string (GESMetaContainer * container)

ges/ges-multi-file-source.c

@@ -261,7 +261,7 @@ ges_multi_file_source_init (GESMultiFileSource * self)
  *
  * Creates a new #GESMultiFileSource for the provided @uri.
  *
- * Returns: A new #GESMultiFileSource.
+ * Returns: (transfer floating): A new #GESMultiFileSource.
  */
 GESMultiFileSource *
 ges_multi_file_source_new (gchar * uri)

ges/ges-pipeline.c

@@ -401,7 +401,7 @@ no_encodebin:
  *
  * Creates a new conveninence #GESPipeline.
  *
- * Returns: the new #GESPipeline.
+ * Returns: (transfer floating): the new #GESPipeline.
  */
 GESPipeline *
 ges_pipeline_new (void)
@@ -921,7 +921,7 @@ _unlink_track (GESPipeline * self, GESTrack * track)
 /**
  * ges_pipeline_set_timeline:
  * @pipeline: a #GESPipeline
- * @timeline: the #GESTimeline to set on the @pipeline.
+ * @timeline: (transfer full): the #GESTimeline to set on the @pipeline.
  *
  * Sets the timeline to use in this pipeline.
  *
@@ -1196,7 +1196,7 @@ ges_pipeline_set_mode (GESPipeline * pipeline, GESPipelineFlags mode)
  * is currently used by the sink. This information can be retrieve from caps
  * associated with the buffer.
  *
- * Returns: (transfer full): a #GstSample or %NULL
+ * Returns: (transfer full) (nullable): a #GstSample or %NULL
  */
 
 GstSample *
@@ -1288,7 +1288,7 @@ ges_pipeline_save_thumbnail (GESPipeline * self, int width, int
  * The caller is responsible for unreffing the returned sample with
  * #gst_sample_unref.
  *
- * Returns: (transfer full): a #GstSample or %NULL
+ * Returns: (transfer full) (nullable): a #GstSample or %NULL
  */
 
 GstSample *

ges/ges-project.c

@@ -732,7 +732,7 @@ ges_project_create_asset (GESProject * project, const gchar * id,
  * "asset-added" signal to get the asset when it finally gets added to
  * @project
  *
- * Returns: (transfer full): The newly created #GESAsset
+ * Returns: (transfer full) (nullable): The newly created #GESAsset or %NULL.
  */
 GESAsset *
 ges_project_create_asset_sync (GESProject * project, const gchar * id,

ges/ges-test-clip.c

@@ -358,8 +358,8 @@ ges_test_clip_create_track_element (GESClip * clip, GESTrackType type)
  *
  * Creates a new #GESTestClip.
  *
- * Returns: The newly created #GESTestClip, or NULL if there was an
+ * Returns: (transfer floating) (nullable): The newly created #GESTestClip,
- * error.
+ * or %NULL if there was an error.
  */
 GESTestClip *
 ges_test_clip_new (void)
@@ -379,8 +379,8 @@ ges_test_clip_new (void)
  *
  * Creates a new #GESTestClip for the provided @nick.
  *
- * Returns: The newly created #GESTestClip, or NULL if there was an
+ * Returns: (transfer floating) (nullable): The newly created #GESTestClip,
- * error.
+ * or %NULL if there was an error.
  */
 GESTestClip *
 ges_test_clip_new_for_nick (gchar * nick)

ges/ges-text-overlay-clip.c

@@ -38,7 +38,6 @@ G_DEFINE_TYPE (GESTextOverlayClip, ges_text_overlay_clip,
 #define DEFAULT_PROP_FONT_DESC "Serif 36"
 #define DEFAULT_PROP_VALIGNMENT GES_TEXT_VALIGN_BASELINE
 #define DEFAULT_PROP_HALIGNMENT GES_TEXT_HALIGN_CENTER
-#
 
 struct _GESTextOverlayClipPrivate
 {
@@ -583,8 +582,8 @@ ges_text_overlay_clip_create_track_element (GESClip * clip, GESTrackType type)
  *
  * Creates a new #GESTextOverlayClip
  *
- * Returns: The newly created #GESTextOverlayClip, or NULL if there was an
+ * Returns: (transfer floating) (nullable): The newly created
- * error.
+ * #GESTextOverlayClip, or %NULL if there was an error.
  */
 GESTextOverlayClip *
 ges_text_overlay_clip_new (void)

ges/ges-text-overlay.c

@@ -425,8 +425,8 @@ ges_text_overlay_get_ypos (GESTextOverlay * self)
  *
  * Creates a new #GESTextOverlay.
  *
- * Returns: The newly created #GESTextOverlay or %NULL if something went
+ * Returns: (transfer floating) (nullable): The newly created #GESTextOverlay or
- * wrong.
+ * %NULL if something went wrong.
  */
 GESTextOverlay *
 ges_text_overlay_new (void)

ges/ges-timeline-element.c

@@ -553,8 +553,8 @@ had_parent:
  * Returns the parent of @self. This function increases the refcount
  * of the parent object so you should gst_object_unref() it after usage.
  *
- * Returns: (transfer full): parent of @self, this can be %NULL if @self
+ * Returns: (transfer full) (nullable): parent of @self, this can be %NULL if
- *   has no parent. unref after usage.
+ * @self has no parent. unref after usage.
  */
 GESTimelineElement *
 ges_timeline_element_get_parent (GESTimelineElement * self)
@@ -629,8 +629,8 @@ had_timeline:
  * Returns the timeline of @self. This function increases the refcount
  * of the timeline so you should gst_object_unref() it after usage.
  *
- * Returns: (transfer full): timeline of @self, this can be %NULL if @self
+ * Returns: (transfer full) (nullable): timeline of @self, this can be %NULL if
- *   has no timeline. unref after usage.
+ * @self has no timeline. unref after usage.
  */
 GESTimeline *
 ges_timeline_element_get_timeline (GESTimelineElement * self)

ges/ges-timeline.c

@@ -2786,7 +2786,7 @@ timeline_fill_gaps (GESTimeline * timeline)
  *
  * Creates a new empty #GESTimeline.
  *
- * Returns: The new timeline.
+ * Returns: (transfer floating): The new timeline.
  */
 
 GESTimeline *
@@ -2808,8 +2808,8 @@ ges_timeline_new (void)
  *
  * Creates a timeline from the given URI.
  *
- * Returns: A new timeline if the uri was loaded successfully, or NULL if the
+ * Returns (transfer floating) (nullable): A new timeline if the uri was loaded
- * uri could not be loaded
+ * successfully, or NULL if the uri could not be loaded.
  */
 GESTimeline *
 ges_timeline_new_from_uri (const gchar * uri, GError ** error)
@@ -2831,7 +2831,7 @@ ges_timeline_new_from_uri (const gchar * uri, GError ** error)
  *
  * Loads the contents of URI into the given timeline.
  *
- * Returns: TRUE if the timeline was loaded successfully, or FALSE if the uri
+ * Returns: %TRUE if the timeline was loaded successfully, or %FALSE if the uri
  * could not be loaded.
  */
 gboolean
@@ -2864,8 +2864,8 @@ ges_timeline_load_from_uri (GESTimeline * timeline, const gchar * uri,
  *
  * Saves the timeline to the given location
  *
- * Returns: TRUE if the timeline was successfully saved to the given location,
+ * Returns: %TRUE if the timeline was successfully saved to the given location,
- * else FALSE.
+ * else %FALSE.
  */
 gboolean
 ges_timeline_save_to_uri (GESTimeline * timeline, const gchar * uri,
@@ -2921,12 +2921,12 @@ ges_timeline_append_layer (GESTimeline * timeline)
 /**
  * ges_timeline_add_layer:
  * @timeline: a #GESTimeline
- * @layer: the #GESLayer to add
+ * @layer: (transfer full): the #GESLayer to add
  *
  * Add the layer to the timeline. The reference to the @layer will be stolen
  * by the @timeline.
  *
- * Returns: TRUE if the layer was properly added, else FALSE.
+ * Returns: %TRUE if the layer was properly added, else %FALSE.
  */
 gboolean
 ges_timeline_add_layer (GESTimeline * timeline, GESLayer * layer)
@@ -3001,7 +3001,7 @@ ges_timeline_add_layer (GESTimeline * timeline, GESLayer * layer)
  * the layer will be dropped. If you wish to use the @layer after calling this
  * method, you need to take a reference before calling.
  *
- * Returns: TRUE if the layer was properly removed, else FALSE.
+ * Returns: %TRUE if the layer was properly removed, else %FALSE.
  */
 
 gboolean
@@ -3051,12 +3051,12 @@ ges_timeline_remove_layer (GESTimeline * timeline, GESLayer * layer)
 /**
  * ges_timeline_add_track:
  * @timeline: a #GESTimeline
- * @track: the #GESTrack to add
+ * @track: (transfer full): the #GESTrack to add
  *
  * Add a track to the timeline. The reference to the track will be stolen by the
  * pipeline.
  *
- * Returns: TRUE if the track was properly added, else FALSE.
+ * Returns: %TRUE if the track was properly added, else %FALSE.
  */
 
 /* FIXME: create track elements for clips which have already been
@@ -3143,7 +3143,7 @@ ges_timeline_add_track (GESTimeline * timeline, GESTrack * track)
  * @track will be removed. If you wish to use the @track after calling this
  * function you must ensure that you have a reference to it.
  *
- * Returns: TRUE if the @track was properly removed, else FALSE.
+ * Returns: %TRUE if the @track was properly removed, else %FALSE.
  */
 
 /* FIXME: release any track elements associated with this layer. currenly this
@@ -3222,8 +3222,8 @@ ges_timeline_remove_track (GESTimeline * timeline, GESTrack * track)
  *
  * Search the #GESTrack corresponding to the given @timeline's @pad.
  *
- * Returns: (transfer none): The corresponding #GESTrack if it is found,
+ * Returns: (transfer none) (nullable): The corresponding #GESTrack if it is
- * or %NULL if there is an error.
+ * found, or %NULL if there is an error.
  */
 
 GESTrack *
@@ -3251,8 +3251,8 @@ ges_timeline_get_track_for_pad (GESTimeline * timeline, GstPad * pad)
  *
  * Search the #GstPad corresponding to the given @timeline's @track.
  *
- * Returns: (transfer none): The corresponding #GstPad if it is found,
+ * Returns: (transfer none) (nullable): The corresponding #GstPad if it is
- * or %NULL if there is an error.
+ * found, or %NULL if there is an error.
  */
 
 GstPad *
@@ -3573,7 +3573,7 @@ ges_timeline_set_snapping_distance (GESTimeline * timeline,
  *
  * Gets a #GESTimelineElement contained in the timeline
  *
- * Returns: (transfer full): The #GESTimelineElement or %NULL if
+ * Returns: (transfer full) (nullable): The #GESTimelineElement or %NULL if
  * not found.
  */
 GESTimelineElement *
@@ -3641,7 +3641,8 @@ ges_timeline_is_empty (GESTimeline * timeline)
  *
  * Retrieve the layer with @priority as a priority
  *
- * Returns: (transfer full): A #GESLayer or %NULL if no layer with @priority was found
+ * Returns: (transfer full) (nullable): A #GESLayer or %NULL if no layer with
+ * @priority was found
  *
  * Since 1.6
  */

ges/ges-title-clip.c

@@ -688,8 +688,8 @@ ges_title_clip_create_track_element (GESClip * clip, GESTrackType type)
  *
  * Creates a new #GESTitleClip
  *
- * Returns: The newly created #GESTitleClip, or NULL if there was an
+ * Returns: (transfer floating) (nullable): The newly created #GESTitleClip,
- * error.
+ * or %NULL if there was an error.
  */
 GESTitleClip *
 ges_title_clip_new (void)

ges/ges-title-source.c

@@ -601,8 +601,8 @@ ges_title_source_get_ypos (GESTitleSource * source)
  *
  * Creates a new #GESTitleSource.
  *
- * Returns: The newly created #GESTitleSource, or %NULL if there was an
+ * Returns: (transfer floating) (nullable): The newly created #GESTitleSource,
- * error.
+ * or %NULL if there was an error.
  */
 GESTitleSource *
 ges_title_source_new (void)

ges/ges-track-element.c

@@ -853,8 +853,8 @@ _ges_track_element_get_layer_priority (GESTrackElement * element)
  *
  * Get the #GESTrack to which this object belongs.
  *
- * Returns: (transfer none): The #GESTrack to which this object belongs. Can be %NULL if it
+ * Returns: (transfer none) (nullable): The #GESTrack to which this object
- * is not in any track
+ * belongs. Can be %NULL if it is not in any track
  */
 GESTrack *
 ges_track_element_get_track (GESTrackElement * object)
@@ -1525,8 +1525,8 @@ ges_track_element_set_control_source (GESTrackElement * object,
  * Looks up the various controlled properties for that #GESTrackElement,
  * and returns the #GstControlBinding which controls @property_name.
  *
- * Returns: (transfer none): the #GstControlBinding associated with @property_name, or %NULL
+ * Returns: (transfer none) (nullable): the #GstControlBinding associated with
- * if that property is not controlled.
+ * @property_name, or %NULL if that property is not controlled.
  */
 GstControlBinding *
 ges_track_element_get_control_binding (GESTrackElement * object,

ges/ges-track.c

@@ -711,7 +711,7 @@ ges_track_init (GESTrack * self)
  * The newly created track will steal a reference to the caps. If you wish to
  * use those caps elsewhere, you will have to take an extra reference.
  *
- * Returns: A new #GESTrack.
+ * Returns: (transfer floating): A new #GESTrack.
  */
 GESTrack *
 ges_track_new (GESTrackType type, GstCaps * caps)
@@ -1059,7 +1059,7 @@ ges_track_get_caps (GESTrack * track)
  *
  * Get the #GESTimeline this track belongs to. Can be %NULL.
  *
- * Returns: The #GESTimeline this track belongs to. Can be %NULL.
+ * Returns: (nullable): The #GESTimeline this track belongs to. Can be %NULL.
  */
 const GESTimeline *
 ges_track_get_timeline (GESTrack * track)

ges/ges-transition-clip.c

@@ -337,8 +337,8 @@ _create_track_element (GESClip * clip, GESTrackType type)
  *
  * Creates a new #GESTransitionClip.
  *
- * Returns: a newly created #GESTransitionClip, or %NULL if something
+ * Returns: (transfer floating) (nullable): a newly created #GESTransitionClip,
- * went wrong.
+ * or %NULL if something went wrong.
  */
 GESTransitionClip *
 ges_transition_clip_new (GESVideoStandardTransitionType vtype)
@@ -372,8 +372,8 @@ ges_transition_clip_new (GESVideoStandardTransitionType vtype)
  *
  * Creates a new #GESTransitionClip for the provided @nick.
  *
- * Returns: The newly created #GESTransitionClip, or %NULL if something
+ * Returns: (transfer floating) (nullable): The newly created #GESTransitionClip,
- * went wrong
+ * or %NULL if something went wrong
  */
 
 GESTransitionClip *

ges/ges-uri-asset.c

@@ -476,7 +476,8 @@ ges_uri_clip_asset_new (const gchar * uri, GCancellable * cancellable,
  * Creates a #GESUriClipAsset for @uri syncronously. You should avoid
  * to use it in application, and rather create #GESUriClipAsset asynchronously
  *
- * Returns: (transfer none): A reference to the requested asset or %NULL if an error happend
+ * Returns: (transfer none) (nullable): A reference to the requested asset or
+ * %NULL if an error happened
  */
 GESUriClipAsset *
 ges_uri_clip_asset_request_sync (const gchar * uri, GError ** error)

ges/ges-uri-clip.c

@@ -517,8 +517,8 @@ ges_uri_clip_create_track_element (GESClip * clip, GESTrackType type)
  *
  * Creates a new #GESUriClip for the provided @uri.
  *
- * Returns: The newly created #GESUriClip, or NULL if there was an
+ * Returns: (transfer floating) (nullable): The newly created #GESUriClip, or
- * error.
+ * %NULL if there was an error.
  */
 GESUriClip *
 ges_uri_clip_new (gchar * uri)

ges/ges-utils.c

@@ -39,7 +39,7 @@ static GstElementFactory *compositor_factory = NULL;
  * Creates a new #GESTimeline containing a raw audio and a
  * raw video track.
  *
- * Returns: The newly created #GESTimeline.
+ * Returns: (transfer floating): The newly created #GESTimeline.
  */
 
 GESTimeline *

ges/ges-video-test-source.c

@@ -130,8 +130,8 @@ ges_video_test_source_get_pattern (GESVideoTestSource * source)
  *
  * Creates a new #GESVideoTestSource.
  *
- * Returns: The newly created #GESVideoTestSource, or %NULL if there was an
+ * Returns: (transfer floating) (nullable): The newly created
- * error.
+ * #GESVideoTestSource, or %NULL if there was an error.
  */
 GESVideoTestSource *
 ges_video_test_source_new (void)

ges/ges-video-track.c

@@ -133,7 +133,7 @@ ges_video_track_class_init (GESVideoTrackClass * klass)
  * Creates a new #GESVideoTrack of type #GES_TRACK_TYPE_VIDEO and with generic
  * raw video caps ("video/x-raw");
  *
- * Returns: A new #GESTrack.
+ * Returns: (transfer floating): A new #GESTrack.
  */
 GESVideoTrack *
 ges_video_track_new (void)

ges/ges-video-transition.c

@@ -649,8 +649,8 @@ ges_video_transition_get_transition_type (GESVideoTransition * trans)
  *
  * Creates a new #GESVideoTransition.
  *
- * Returns: The newly created #GESVideoTransition, or %NULL if there was an
+ * Returns: (transfer floating) (nullable): The newly created
- * error.
+ * #GESVideoTransition, or %NULL if there was an error.
  */
 GESVideoTransition *
 ges_video_transition_new (void)

ges/ges-video-uri-source.c

@@ -186,8 +186,8 @@ ges_video_uri_source_init (GESVideoUriSource * self)
  *
  * Creates a new #GESVideoUriSource for the provided @uri.
  *
- * Returns: The newly created #GESVideoUriSource, or %NULL if there was an
+ * Returns: (transfer floating) (nullable): The newly created #GESVideoUriSource,
- * error.
+ * or %NULL if there was an error.
  */
 GESVideoUriSource *
 ges_video_uri_source_new (gchar * uri)