GNOME.org
 

[grilo] doc: Updates and fixes

commit 18da634b72c5670fb96bbbc4af70a868adb040a2
Author: Emanuele Aina <emanuele aina collabora com>
Date:   Wed Aug 21 13:37:33 2013 +0200

    doc: Updates and fixes
    
    - Ignore all the *-priv.h headers
    - Update grilo-sections.txt with new symbols
    - Fix referecens to old GrlMediaSource and GrlMetadataSource to point to
      GrlSource
    - Standardize element-type annotation to use the C symbol names
    - Misc cleanups to fix gtk-doc warnings
    
    https://bugzilla.gnome.org/show_bug.cgi?id=706487

 doc/grilo/Makefile.am         |   11 ++++++++---
 doc/grilo/grilo-sections.txt  |   22 ++++++++++++++++++++--
 doc/grilo/plugins-sources.xml |   15 ++++++++-------
 libs/net/grl-net-wc.c         |    5 +++--
 src/data/grl-data.c           |    4 ++--
 src/grl-caps.c                |    2 +-
 src/grl-caps.h                |    6 ++++++
 src/grl-multiple.c            |    6 +++---
 src/grl-operation-options.c   |   16 +++++++++-------
 src/grl-operation-options.h   |    6 ++++++
 src/grl-plugin.c              |    9 ++++-----
 src/grl-registry.c            |    8 +++++---
 src/grl-source.c              |   17 ++++++++---------
 src/grl-source.h              |    2 +-
 14 files changed, 84 insertions(+), 45 deletions(-)
---
diff --git a/doc/grilo/Makefile.am b/doc/grilo/Makefile.am
index cd0b13c..5055940 100644
--- a/doc/grilo/Makefile.am
+++ b/doc/grilo/Makefile.am
@@ -59,11 +59,16 @@ EXTRA_HFILES=
 # Header files to ignore when scanning. Use base file name, no paths
 # e.g. IGNORE_HFILES=gtkdebug.h gtkintl.h
 IGNORE_HFILES=config.h \
+       grl-log-priv.h \
+       grl-marshal.h \
+       grl-metadata-key-priv.h \
+       grl-metadata-source-priv.h \
+       grl-net-mock-private.h \
+       grl-operation-options-priv.h \
+       grl-operation-priv.h \
        grl-plugin-priv.h \
-       grl-operations-priv.h \
+       grl-registry-priv.h \
        grl-sync-priv.h \
-       grl-metadata-key-priv.h \
-       grl-marshal.h \
        grl-type-builtins.h
 
 # Images to copy into HTML directory.
diff --git a/doc/grilo/grilo-sections.txt b/doc/grilo/grilo-sections.txt
index b795484..7438fc7 100644
--- a/doc/grilo/grilo-sections.txt
+++ b/doc/grilo/grilo-sections.txt
@@ -123,6 +123,7 @@ GrlSourcePrivate
 <TITLE>GrlCaps</TITLE>
 GrlCaps
 GrlCapsClass
+GrlTypeFilter
 grl_caps_new
 grl_caps_get_key_filter
 grl_caps_get_key_range_filter
@@ -150,7 +151,6 @@ GrlCapsPrivate
 <TITLE>GrlOperationOptions</TITLE>
 GrlOperationOptions
 GrlOperationOptionsClass
-GrlOperationCancelCb
 grl_operation_options_new
 grl_operation_options_copy
 grl_operation_options_get_count
@@ -161,7 +161,6 @@ grl_operation_options_get_key_range_filter
 grl_operation_options_get_key_range_filter_list
 grl_operation_options_get_skip
 grl_operation_options_get_type_filter
-grl_operation_options_key_is_set
 grl_operation_options_obey_caps
 grl_operation_options_set_count
 grl_operation_options_set_flags
@@ -242,6 +241,7 @@ grl_related_keys_new_with_keys
 grl_related_keys_dup
 grl_related_keys_get
 grl_related_keys_get_binary
+grl_related_keys_get_boolean
 grl_related_keys_get_boxed
 grl_related_keys_get_float
 grl_related_keys_get_int
@@ -250,10 +250,12 @@ grl_related_keys_get_string
 grl_related_keys_has_key
 grl_related_keys_set
 grl_related_keys_set_binary
+grl_related_keys_set_boolean
 grl_related_keys_set_boxed
 grl_related_keys_set_float
 grl_related_keys_set_int
 grl_related_keys_set_string
+grl_related_keys_remove
 <SUBSECTION Standard>
 GRL_IS_RELATED_KEYS
 GRL_IS_RELATED_KEYS_CLASS
@@ -275,6 +277,7 @@ GRL_CONFIG_KEY_APIKEY
 GRL_CONFIG_KEY_APIKEY_BLOB
 GRL_CONFIG_KEY_APISECRET
 GRL_CONFIG_KEY_APITOKEN
+GRL_CONFIG_KEY_APITOKEN_SECRET
 GRL_CONFIG_KEY_PASSWORD
 GRL_CONFIG_KEY_PLUGIN
 GRL_CONFIG_KEY_SOURCE
@@ -284,6 +287,7 @@ grl_config_get_api_key
 grl_config_get_api_key_blob
 grl_config_get_api_secret
 grl_config_get_api_token
+grl_config_get_api_token_secret
 grl_config_get_binary
 grl_config_get_boolean
 grl_config_get_float
@@ -299,6 +303,7 @@ grl_config_set_api_key
 grl_config_set_api_key_blob
 grl_config_set_api_secret
 grl_config_set_api_token
+grl_config_set_api_token_secret
 grl_config_set_binary
 grl_config_set_boolean
 grl_config_set_float
@@ -326,6 +331,7 @@ GrlConfigPrivate
 GrlMedia
 GrlMediaClass
 GrlMediaSerializeType
+GrlMediaType
 grl_media_new
 grl_media_add_author
 grl_media_add_external_player
@@ -341,6 +347,7 @@ grl_media_get_certificate
 grl_media_get_creation_date
 grl_media_get_description
 grl_media_get_duration
+grl_media_get_favourite
 grl_media_get_external_url
 grl_media_get_external_url_nth
 grl_media_get_id
@@ -380,6 +387,7 @@ grl_media_set_description
 grl_media_set_duration
 grl_media_set_external_player
 grl_media_set_external_url
+grl_media_set_favourite
 grl_media_set_id
 grl_media_set_keyword
 grl_media_set_last_played
@@ -426,6 +434,7 @@ grl_data_add_string
 grl_data_dup
 grl_data_get
 grl_data_get_binary
+grl_data_get_boolean
 grl_data_get_boxed
 grl_data_get_float
 grl_data_get_int
@@ -440,6 +449,7 @@ grl_data_remove
 grl_data_remove_nth
 grl_data_set
 grl_data_set_binary
+grl_data_set_boolean
 grl_data_set_boxed
 grl_data_set_float
 grl_data_set_int
@@ -614,11 +624,13 @@ GRL_METADATA_KEY_CERTIFICATE
 GRL_METADATA_KEY_CHILDCOUNT
 GRL_METADATA_KEY_CREATION_DATE
 GRL_METADATA_KEY_DESCRIPTION
+GRL_METADATA_KEY_DIRECTOR
 GRL_METADATA_KEY_DURATION
 GRL_METADATA_KEY_EPISODE
 GRL_METADATA_KEY_EXPOSURE_TIME
 GRL_METADATA_KEY_EXTERNAL_PLAYER
 GRL_METADATA_KEY_EXTERNAL_URL
+GRL_METADATA_KEY_FAVOURITE
 GRL_METADATA_KEY_FLASH_USED
 GRL_METADATA_KEY_FRAMERATE
 GRL_METADATA_KEY_GENRE
@@ -626,6 +638,7 @@ GRL_METADATA_KEY_HEIGHT
 GRL_METADATA_KEY_ID
 GRL_METADATA_KEY_INVALID
 GRL_METADATA_KEY_ISO_SPEED
+GRL_METADATA_KEY_KEYWORD
 GRL_METADATA_KEY_LAST_PLAYED
 GRL_METADATA_KEY_LAST_POSITION
 GRL_METADATA_KEY_LICENSE
@@ -633,7 +646,10 @@ GRL_METADATA_KEY_LYRICS
 GRL_METADATA_KEY_MIME
 GRL_METADATA_KEY_MODIFICATION_DATE
 GRL_METADATA_KEY_ORIENTATION
+GRL_METADATA_KEY_ORIGINAL_TITLE
+GRL_METADATA_KEY_PERFORMER
 GRL_METADATA_KEY_PLAY_COUNT
+GRL_METADATA_KEY_PRODUCER
 GRL_METADATA_KEY_PUBLICATION_DATE
 GRL_METADATA_KEY_RATING
 GRL_METADATA_KEY_REGION
@@ -646,6 +662,7 @@ GRL_METADATA_KEY_STUDIO
 GRL_METADATA_KEY_THUMBNAIL
 GRL_METADATA_KEY_THUMBNAIL_BINARY
 GRL_METADATA_KEY_TITLE
+GRL_METADATA_KEY_TRACK_NUMBER
 GRL_METADATA_KEY_URL
 GRL_METADATA_KEY_WIDTH
 grl_metadata_key_get_desc
@@ -689,6 +706,7 @@ grl_multiple_search_sync
 grl_operation_cancel
 grl_operation_get_data
 grl_operation_set_data
+grl_operation_set_data_full
 </SECTION>
 
 <SECTION>
diff --git a/doc/grilo/plugins-sources.xml b/doc/grilo/plugins-sources.xml
index da7d33d..81f09a9 100644
--- a/doc/grilo/plugins-sources.xml
+++ b/doc/grilo/plugins-sources.xml
@@ -1272,7 +1272,8 @@ grl_filesystem_media_from_uri (GrlSource *source,
     <para>
       Once users have activated notifications by invoking
       "notify_change_start", media sources should communicate
-      any changes detected by calling grl_media_source_notify_change_list
+      any changes detected by calling <link
+      linkend="grl-source-notify-change-list">grl_source_notify_change_list()</link>
       with a list of the media items changed.
     </para>
 
@@ -1312,10 +1313,10 @@ static gboolean
 grl_foo_source_notify_change_start (GrlSource *source,
                                     GError **error)
 {
-  GrlFooMediaSource *foo_source;
+  GrlFooSource *foo_source;
 
   /* Listen to changes in the media content provider */
-  foo_source = GRL_FOO_MEDIA_SOURCE (source);
+  foo_source = GRL_FOO_SOURCE (source);
   foo_source->listener_id = foo_subscribe_listener_new (content_changed_cb);
 
   return TRUE;
@@ -1325,10 +1326,10 @@ static gboolean
 grl_foo_source_notify_change_stop (GrlSource *source,
                                    GError **error)
 {
-  GrlFooMediaSource *foo_source;
+  GrlFooSource *foo_source;
 
   /* Stop listening to changes in the media content provider */
-  foo_source = GRL_FOO_MEDIA_SOURCE (source);
+  foo_source = GRL_FOO_SOURCE (source);
   foo_listener_destroy (foo_source->listener_id);
 
   return TRUE;
@@ -1337,9 +1338,9 @@ grl_foo_source_notify_change_stop (GrlSource *source,
     </programlisting>
 
     <para>
-      Please check the <link linkend="GrlMediaSource">GrlMediaSource</link> API
+      Please check the <link linkend="GrlSource">GrlSource</link> API
       reference for more details on how <link
-      linkend="grl-media-source-notify-change-list">grl_media_source_notify_change_list()</link>
+      linkend="grl-source-notify-change-list">grl_source_notify_change_list()</link>
       should be used.
     </para>
 
diff --git a/libs/net/grl-net-wc.c b/libs/net/grl-net-wc.c
index 08db71e..9c11d46 100644
--- a/libs/net/grl-net-wc.c
+++ b/libs/net/grl-net-wc.c
@@ -872,7 +872,7 @@ grl_net_wc_request_async (GrlNetWc *self,
  * @cancellable: (allow-none): a #GCancellable instance or %NULL to ignore
  * @callback: The callback when the result is ready
  * @user_data: User data set for the @callback
- * @Varargs: List of tuples of header name and header value, terminated by
+ * @...: List of tuples of header name and header value, terminated by
  * %NULL.
  *
  * Request the fetching of a web resource given the @uri. This request is
@@ -935,8 +935,9 @@ void grl_net_wc_request_with_headers_async (GrlNetWc *self,
  * Request the fetching of a web resource given the @uri. This request is
  * asynchronous, thus the result will be returned within the @callback.
  *
- * Since: 0.2.2
  * Rename to: grl_net_wc_request_with_headers_async
+ *
+ * Since: 0.2.2
  */
 void
 grl_net_wc_request_with_headers_hash_async (GrlNetWc *self,
diff --git a/src/data/grl-data.c b/src/data/grl-data.c
index 3a68438..dd62fcf 100644
--- a/src/data/grl-data.c
+++ b/src/data/grl-data.c
@@ -25,7 +25,7 @@
 /**
  * SECTION:grl-data
  * @short_description: Low-level class for storing metadata information about
- * media resources provided by #GrlMediaSource objects.
+ * media resources provided by #GrlSource objects.
  * @see_also: #GrlMedia, #GrlMediaBox, #GrlMediaVideo, #GrlMediaAudio,
  * #GrlMediaImage
  *
@@ -381,7 +381,7 @@ grl_data_set_boolean (GrlData *data, GrlKeyID key, gboolean boolvalue)
  * @data: data to inspect
  * @key (type GrlKeyID): key to use
  *
- * Returns the first boolean value associated with @key from @data. If @key has
+ * Returns: the first boolean value associated with @key from @data. If @key has
  * no first value, or value is not a gboolean, or @key is not in the data, then
  * FALSE is returned
  *
diff --git a/src/grl-caps.c b/src/grl-caps.c
index 59944d3..dd5ff58 100644
--- a/src/grl-caps.c
+++ b/src/grl-caps.c
@@ -186,7 +186,7 @@ grl_caps_get_type_filter (GrlCaps *caps)
 /**
  * grl_caps_set_type_filter:
  * @caps: a #GrlCaps instance
- * @filter: a #GrlTypefilter
+ * @filter: a #GrlTypeFilter
  *
  * Sets the supported filter capability.
  *
diff --git a/src/grl-caps.h b/src/grl-caps.h
index 91d4d4e..e3298f7 100644
--- a/src/grl-caps.h
+++ b/src/grl-caps.h
@@ -44,6 +44,12 @@ typedef struct {
   gpointer _grl_reserved[GRL_PADDING_SMALL];
 } GrlCaps;
 
+/**
+ * GrlCapsClass:
+ * @parent: the parent class structure
+ *
+ * Grilo Capabilities class.
+ */
 typedef struct {
   GObjectClass parent;
 
diff --git a/src/grl-multiple.c b/src/grl-multiple.c
index 1c78d22..b5ad4cd 100644
--- a/src/grl-multiple.c
+++ b/src/grl-multiple.c
@@ -499,7 +499,7 @@ media_from_uri_cb (GrlSource *source,
 
 /**
  * grl_multiple_search:
- * @sources: (element-type Grl.Source) (allow-none):
+ * @sources: (element-type GrlSource) (allow-none):
  * a #GList of #GrlSource<!-- -->s to search from (%NULL for all
  * searchable sources)
  * @text: the text to search for
@@ -602,7 +602,7 @@ multiple_search_cancel_cb (struct MultipleSearchData *msd)
 
 /**
  * grl_multiple_search_sync:
- * @sources: (element-type Grl.Source) (allow-none):
+ * @sources: (element-type GrlSource) (allow-none):
  * a #GList of #GrlSource<!-- -->s where to search from (%NULL for all
  * available sources with search capability)
  * @text: the text to search for
@@ -615,7 +615,7 @@ multiple_search_cancel_cb (struct MultipleSearchData *msd)
  *
  * This method is synchronous.
  *
- * Returns: (element-type Grl.Media) (transfer full): a list with #GrlMedia elements
+ * Returns: (element-type GrlMedia) (transfer full): a list with #GrlMedia elements
  *
  * Since: 0.2.0
  */
diff --git a/src/grl-operation-options.c b/src/grl-operation-options.c
index 9d1f4e4..554889c 100644
--- a/src/grl-operation-options.c
+++ b/src/grl-operation-options.c
@@ -23,9 +23,9 @@
 /**
  * SECTION:grl-operation-options
  * @short_description: Describes the options to be passed to an operation
- * @see_also: #GrlCaps, grl_metadata_source_resolve(),
- * grl_media_source_search(), grl_media_source_browse(),
- * grl_media_source_query()
+ * @see_also: #GrlCaps, grl_source_resolve(),
+ * grl_source_search(), grl_source_browse(),
+ * grl_source_query()
  *
  */
 #include <grl-operation-options.h>
@@ -421,7 +421,7 @@ grl_operation_options_get_count (GrlOperationOptions *options)
  * grl_operation_options_set_flags:
  * @options: a #GrlOperationOptions instance
  * @flags: the resolution flags to be set for an operation. See
- * #GrlMetadataResolutionFlags for possible values.
+ * #GrlResolutionFlags for possible values.
  *
  * Set the resolution flags for an operation. Will only succeed if @flags obey
  * to the inherent capabilities of @options.
@@ -437,7 +437,7 @@ grl_operation_options_set_flags (GrlOperationOptions *options,
   GValue value = { 0, };
 
   /* FIXME: I think we should use mk_enum to have a GType for
-   * GrlMetadataResolutionFlags */
+   * GrlResolutionFlags */
   g_value_init (&value, G_TYPE_UINT);
   g_value_set_uint (&value, flags);
   set_value (options, GRL_OPERATION_OPTION_FLAGS, &value);
@@ -640,6 +640,8 @@ grl_operation_options_set_key_filters (GrlOperationOptions *options,
  *
  * Rename to: grl_operation_options_set_key_filters
  *
+ * Returns: %TRUE on success
+ *
  * Since: 0.2.0
  */
 gboolean
@@ -695,7 +697,7 @@ grl_operation_options_get_key_filter_list (GrlOperationOptions *options)
 /**
  * grl_operation_options_set_key_range_filter_value:
  * @options: a #GrlOperationOptions instance
- * @key: a #GrlKeyId
+ * @key: a #GrlKeyID
  * @min_value: (in) (allow-none): minimum value for range
  * @max_value: (in) (allow-none): maximum value for range
  *
@@ -858,7 +860,7 @@ grl_operation_options_set_key_range_filter (GrlOperationOptions *options,
 /**
  * grl_operation_options_get_key_range_filter:
  * @options: a #GrlOperationOptions instance
- * @key: a #GrlkeyId
+ * @key: a #GrlKeyID
  * @min_value: (out) (allow-none): the minimum value for the range
  * @max_value: (out) (allow-none): the maximum value for the range
  *
diff --git a/src/grl-operation-options.h b/src/grl-operation-options.h
index 9ed82be..c6445bc 100644
--- a/src/grl-operation-options.h
+++ b/src/grl-operation-options.h
@@ -43,6 +43,12 @@ typedef struct {
   gpointer _grl_reserved[GRL_PADDING_SMALL];
 } GrlOperationOptions;
 
+/**
+ * GrlOperationOptionsClass:
+ * @parent: the parent class structure
+ *
+ * Grilo Operation Options class.
+ */
 typedef struct {
   GObjectClass parent;
 
diff --git a/src/grl-plugin.c b/src/grl-plugin.c
index 7a9c0a7..40fe4ff 100644
--- a/src/grl-plugin.c
+++ b/src/grl-plugin.c
@@ -23,10 +23,9 @@
 /**
  * SECTION:grl-plugin
  * @short_description: Base class for Grilo Plugins
- * @see_also: #GrlMetadataSource, #GrlMediaSource
+ * @see_also: #GrlSource
  *
- * Grilo is extensible, so #GrlMetadataSource or #GrlMediaSource instances can be
- * loaded at runtime.
+ * Grilo is extensible, so #GrlSource instances can be loaded at runtime.
  * A plugin system can provide one or more of the basic
  * <application>Grilo</application> #GrlSource subclasses.
  *
@@ -203,7 +202,7 @@ grl_plugin_set_unload_func (GrlPlugin *plugin,
 /*
  * grl_plugin_load:
  * @plugin: a plugin
- * @configurations: (element-type Grl.Config): a list of configurations
+ * @configurations: (element-type GrlConfig): a list of configurations
  *
  * Load the plugin
  *
@@ -532,7 +531,7 @@ grl_plugin_get_info (GrlPlugin *plugin, const gchar *key)
  *
  * Gets the sources belonging to @plugin.
  *
- * Returns: (transfer container) (element-type Grl.Source): a #GList of
+ * Returns: (transfer container) (element-type GrlSource): a #GList of
  * #GrlSource<!-- -->s. The content of the list should not be modified or
  * freed. Use g_list_free() when done using the list.
  *
diff --git a/src/grl-registry.c b/src/grl-registry.c
index db455af..f846111 100644
--- a/src/grl-registry.c
+++ b/src/grl-registry.c
@@ -1038,7 +1038,7 @@ grl_registry_lookup_source (GrlRegistry *registry,
  *
  * If @ranked is %TRUE, the source list will be ordered by rank.
  *
- * Returns: (element-type Grl.Source) (transfer container): a #GList of
+ * Returns: (element-type GrlSource) (transfer container): a #GList of
  * available #GrlSource<!-- -->s. The content of the list should not be
  * modified or freed. Use g_list_free() when done using the list.
  *
@@ -1077,7 +1077,7 @@ grl_registry_get_sources (GrlRegistry *registry,
  *
  * If @ranked is %TRUE, the source list will be ordered by rank.
  *
- * Returns: (element-type Grl.Source) (transfer container): a #GList of
+ * Returns: (element-type GrlSource) (transfer container): a #GList of
  * available #GrlSource<!-- -->s. The content of the list should not be
  * modified or freed. Use g_list_free() when done using the list.
  *
@@ -1143,7 +1143,7 @@ grl_registry_lookup_plugin (GrlRegistry *registry,
  * If @only_loaded is %TRUE, the plugin list will contain only plugins that are
  * loaded.
  *
- * Returns: (element-type Grl.Plugin) (transfer container): a #GList of
+ * Returns: (element-type GrlPlugin) (transfer container): a #GList of
  * available #GrlPlugin<!-- -->s. The content of the list should not be modified
  * or freed. Use g_list_free() when done using the list.
  *
@@ -1563,6 +1563,8 @@ grl_registry_get_metadata_keys (GrlRegistry *registry)
  *
  * Add a configuration for a plugin/source.
  *
+ * Returns: %TRUE on success
+ *
  * Since: 0.2.0
  */
 gboolean
diff --git a/src/grl-source.c b/src/grl-source.c
index 1abc814..2f58eb7 100644
--- a/src/grl-source.c
+++ b/src/grl-source.c
@@ -391,8 +391,8 @@ grl_source_class_init (GrlSourceClass *source_class)
   /**
    * GrlSource::content-changed:
    * @source: source that has changed
-   * @changed_medias: a #GPtrArray with the medias that changed or a common
-   * ancestor of them of type #GrlMediaBox.
+   * @changed_medias: (element-type GrlMedia): a #GPtrArray with the medias
+   * that changed or a common ancestor of them of type #GrlMediaBox.
    * @change_type: the kind of change that ocurred
    * @location_unknown: @TRUE if the change happened in @media itself or in one
    * of its direct children (when @media is a #GrlMediaBox). @FALSE otherwise
@@ -3630,7 +3630,7 @@ grl_source_browse (GrlSource *source,
  *
  * This method is synchronous.
  *
- * Returns: (element-type Grl.Media) (transfer full): a #GList with #GrlMedia
+ * Returns: (element-type GrlMedia) (transfer full): a #GList with #GrlMedia
  * elements. After use g_object_unref() every element and g_list_free() the
  * list.
  *
@@ -3791,7 +3791,7 @@ grl_source_search (GrlSource *source,
  *
  * This method is synchronous.
  *
- * Returns: (element-type Grl.Media) (transfer full): a #GList with #GrlMedia
+ * Returns: (element-type GrlMedia) (transfer full): a #GList with #GrlMedia
  * elements. After use g_object_unref() every element and g_list_free() the
  * list.
  *
@@ -3947,7 +3947,7 @@ grl_source_query (GrlSource *source,
  *
  * This method is synchronous.
  *
- * Returns: (element-type Grl.Media) (transfer full): a #GList with #GrlMedia
+ * Returns: (element-type GrlMedia) (transfer full): a #GList with #GrlMedia
  * elements. After use g_object_unref() every element and g_list_free() the
  * list.
  *
@@ -4229,14 +4229,13 @@ grl_source_store_metadata_impl (GrlSource *source,
  * grl_source_store_metadata:
  * @source: a metadata source
  * @media: the #GrlMedia object that we want to operate on.
- * @keys: (element-type Grl.KeyID) (allow-none): a list
+ * @keys: (element-type GrlKeyID) (allow-none): a list
  * of #GrlKeyID whose values we want to change.
  * @flags: Flags to configure specific behaviors of the operation.
  * @callback: (scope notified): the callback to execute when the operation is finished.
  * @user_data: user data set for the @callback
  *
- * This is the main method of the #GrlMetadataSource class. It will
- * get the values for @keys from @media and store it permanently. After
+ * Get the values for @keys from @media and store it permanently. After
  * calling this method, future queries that return this media object
  * shall return this new values for the selected keys.
  *
@@ -4370,7 +4369,7 @@ grl_source_notify_change_stop (GrlSource *source,
 /**
  * grl_source_notify_change_list:
  * @source: a source
- * @changed_medias: (element-type Grl.Media) (transfer full):: the list of
+ * @changed_medias: (element-type GrlMedia) (transfer full): the list of
  * medias that have changed
  * @change_type: the type of change
  * @location_unknown: if change has happpened in @media or any descendant
diff --git a/src/grl-source.h b/src/grl-source.h
index 8347d0a..621e2d2 100644
--- a/src/grl-source.h
+++ b/src/grl-source.h
@@ -91,7 +91,7 @@ struct _GrlSource {
  * @GRL_OP_REMOVE: Remove content from a service.
  * @GRL_OP_MEDIA_FROM_URI: Create a #GrlMedia instance from an URI
  * representing a media resource.
- * @GRL_OP_NOTIFY_CHANGE: Notify about changes in the #GrlMediaSource.
+ * @GRL_OP_NOTIFY_CHANGE: Notify about changes in the #GrlSource.
  *
  * Bitwise flags which reflect the kind of operations that a
  * #GrlSource supports.
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]