Release 0.3.0grilo-0.3.0

7 files changed, 479 insertions, 13 deletions

diff --git a/NEWS b/NEWS
index dff390a..9459261 100644
--- a/NEWS
+++ b/NEWS
@@ -1,3 +1,267 @@
+NEW in 0.3.0
+============
+
+  * New major version
+  * Updated i18n translations
+  * "last-played-time" now is a GDateTime key, instead of string
+  * Support builtin plugins
+  * Get rid of XML plugin definitions
+  * New way of defining plugins (GRL_PLUGIN_DEFINE)
+  * Plugins must be explicitly activated after loading them
+  * Merge GrlMedia{Audio,Video,Image,Box} in GrlMedia
+  * Bugs fixed:
+    * BGO#627207 - Memory leaks/double free
+    * BGO#627863 - gitignore: Put common ignores in the root .gitignore
+    * BGO#627864 - log: Revamp the log system
+    * BGO#628506 - rename the GRL_ERROR quark to GRL_CORE_ERROR
+    * BGO#629002 - Add GRL_METADATA_KEY_SIZE
+    * BGO#629369 - Make get_sources and get_sources_by_operations accessible
+      from JavaScript
+    * BGO#630493 - Using full resolution during searches will cause an
+      uninitialised pointer access
+    * BGO#635394 - Add ability to get video URL from page URL, or <embed> URL
+    * BGO#636414 - build failure on Meego
+    * BGO#657926 - add per-source icon
+    * BGO#662748 - tracker plugin: support multiple resources in a larger file
+    * BGO#662762 - critical when HTTP request fails
+    * BGO#662763 - Bad unref in grl-net
+    * BGO#672933 - Add thetvdb.com metadata
+    * BGO#676822 - test-ui: Make the test window a decent size
+    * BGO#676823 - test-ui: We only really support GTK+ 3.x builds
+    * BGO#680436 - net: Add possibility to set custom HTTP headers on requests
+    * BGO#681983 - Pointer cast warning in grl-source.c
+    * BGO#681984 - sync source functions freeze on bad pre-conditions
+    * BGO#681992 - C++ guards missing in some header files
+    * BGO#682024 - Uninitialized data access in grl_source_get_media_from_uri()
+    * BGO#685861 - Add GRL_METADATA_KEY_FAVOURITE
+    * BGO#686032 - doc: Fix typo in _grl_log_init_core_domains()
+    * BGO#686033 - core: Don't crash with NULL options in _resolve()
+    * BGO#686175 - "last-played-time" declared as string, instead of date-time
+    * BGO#687104 - Searching all doesn't finalizes
+    * BGO#688301 - docs: GrlMedia: Improve certificate/region function docs
+    * BGO#689053 - grl-source: fix compare_queue_element function
+    * BGO#689577 - autogen.sh does not pass all arguments correctly to
+      gnome-autogen.sh
+    * BGO#690612 - grilo: Explain why module could not be loaded
+    * BGO#690613 - grilo: Downgrade init failure to a debug statement
+    * BGO#692118 - [PATCH] Fix build with automake 1.13
+    * BGO#692873 - GrlOperationOptions leaked in grl_source_get_media_from_uri()
+    * BGO#694390 - Assertion when calling grl_registry_unload_plugin() twice
+    * BGO#695303 - new feature: grilo playlist library
+    * BGO#696860 - filesystem: Add support for non-file URIs
+    * BGO#697175 - Grilo's flickr plugin using OAuth
+    * BGO#700310 - Soup HTTP cache size incorrectly set
+    * BGO#700311 - Use a different cache per plugin
+    * BGO#700478 - grilo-test-ui-0.2 segfaults
+    * BGO#704804 - typo in src/grl-registry.c
+    * BGO#705944 - core: Add grl_operation_set_data_full()
+    * BGO#706132 - build: Various srcdir != builddir fixes
+    * BGO#706412 - filesystem plugin filters all on GRL_FILTER_TYPE_NONE (patch)
+    * BGO#706487 - doc: Updates and fixes
+    * BGO#706491 - build: Switch to git.mk to keep the .gitignore file updated
+    * BGO#706495 - core: Use g_clear_error()/g_clear_object()/g_list_free_full()
+    * BGO#706805 - libgrlnet mock data facility's ignored-parameters feature
+      crashes for queries without parameters.
+    * BGO#706877 - Let TheMovieDb resolver perform searches based on file name
+    * BGO#709208 - search instead of browse vs upnp server that does not support
+      search via parentID
+    * BGO#709651 - Double free when running tests
+    * BGO#710185 - grilo-inspect leaves empty directories in /tmp
+    * BGO#722358 - Add grl_registry_add_config_from_resource
+    * BGO#722398 - core: Add unit to duration
+    * BGO#722407 - Grilo build | `GLib.Icon' could not be found
+    * BGO#723077 - Use the GrlSource::source-icon property in grilo-test-ui
+    * BGO#723191 - Support Vala 0.24
+    * BGO#723989 - Misc build fixes
+    * BGO#724018 - core: Fix "Since" in GrlSource::source-icon docs
+    * BGO#724019 - core: Add "source-tags" property
+    * BGO#724430 - Remove check for libvala in configure.ac
+    * BGO#724540 - pls: Return an error when the entry media is of the wrong
+      type
+    * BGO#724620 - core: Fix introspection scanner warnings
+    * BGO#724648 - Vala dependency is not correctly detected
+    * BGO#724658 - test-ui: Fix crasher on exit
+    * BGO#724660 - Warnings on exit
+    * BGO#724871 - Warning fixes
+    * BGO#725148 - Automatic network awareness
+    * BGO#725419 - core: Add names to all the timeouts and idles
+    * BGO#726197 - grilo should not ignore ${libdir} and hardcode lib64
+    * BGO#726340 - core: Add guards for public API
+    * BGO#726698 - core: More cleanups
+    * BGO#727223 - Add grl-launch tool
+    * BGO#728812 - GrlPlsFilterFunc is missing from the doc
+    * BGO#730003 - core: Fix reference to renamed functions
+    * BGO#730548 - GRL_METADATA_KEY_INVALID is missing in the Vala bindings
+    * BGO#730663 - vala bindings: all defines in grl-definitions.h are missing
+      in the bindings
+    * BGO#731282 - Add GRL_METADATA_KEY_MB_ALBUM_ID to core keys
+    * BGO#732878 - Include mb-track-id and mb-artist-id metadata key
+    * BGO#733232 - rhythmbox crashes while using jamendo due to double free in
+      libgrilo
+    * BGO#733285 - gboolean grl_initialized should be reset to FALSE in
+      grl_deinit
+    * BGO#740113 - Fix compilation warning
+    * BGO#740128 - Add missing GRL_OP_STORE to supported ops
+    * BGO#740186 - Modernize vala bindings
+    * BGO#740761 - Correct "file size" metadata key
+    * BGO#740942 - core: Fix excessive ref'ing when registering new keys
+    * BGO#740943 - core: Add register_keys plugin function
+    * BGO#741020 - core: Add tag to grl_operation_options_get_key_range_filter
+    * BGO#741081 - data/grl-media-audio.c: Non-void function should return a
+      value
+    * BGO#741315 - Vala bindings build fixes
+    * BGO#741605 - core: Make the property name match the metadata key name
+    * BGO#742645 - error: ENABLE_VAPIGEN does not appear in AM_CONDITIONAL
+    * BGO#743351 - core: Make grl_init_get_option_group() available to bindings
+    * BGO#743353 - core: Fix grl_init() when using the GOptionGroup instead
+    * BGO#744168 - core: Add "audio-track" property
+    * BGO#744408 - Memory leak in get_additional_sources
+    * BGO#745676 - core: Fix warning when unloading a plugin that failed to load
+    * BGO#747026 - core: Add a way to load builtin plugins
+    * BGO#747029 - source: Only replace source ID in notify if unset
+    * BGO#747953 - Information leak via plain text HTTP connection
+    * BGO#748455 - Some cleanup I made in grilo, I want to implement a test for
+      GrlMediaContainer in a separate branch
+    * BGO#748550 - Unregister custom keys on grl_registry_unload_plugin
+    * BGO#748873 - Documentation and precondition fixes for media resolution
+    * BGO#748896 - src: Try all GrlSources in grl_multiple_get_media_from_uri()
+    * BGO#749587 - Fix make distcheck.
+    * BGO#749887 - Fix coverity bugs
+    * BGO#754093 - grilo-plugins tests fail if build machine has no internet
+      connectivity
+    * BGO#754401 - grilo-test-ui: Fix warning about deprecated gtk-menu-images
+    * BGO#755368 - 'make clean' removes Vala .deps files
+    * BGO#755433 - grl_pls_browse_sync() is not introspectable
+    * BGO#755516 - build: fix build due syntax error
+    * BGO#755551 - remove media specifiers as subclasses
+    * BGO#755702 - Show better configuration information
+    * BGO#758654 - Fix tracker serialisation
+    * BGO#758655 - grl-launch fixes
+    * BGO#759295 - Get rid of XML plugins descriptors
+
+  * Contributors to this release:
+  * Contributors to this release:
+    A S Alam <aalam@users.sf.net>
+    A S Alam <apreet.alam@gmail.com>
+    Adrião Morão <amoran@igalia.com>
+    Alban Browaeys <prahal@yahoo.com>
+    Alberto Garcia <berto@igalia.com>
+    Alberto Garcia <agarcia@igalia.com>
+    Alexandre Franke <alexandre.franke@gmail.com>
+    Anders Jonsson <anders.jonsson@norsjovallen.se>
+    Andika Triwidada <andika@gmail.com>
+    Andres Gomez <agomez@igalia.com>
+    Andrzej Bieniek <andyhelp@gmail.com>
+    Anish A <aneesh.nl@gmail.com>
+    Antía Puentes <apuentes@igalia.com>
+    Ask Hjorth Larsen <asklarsen@gmail.com>
+    Aurimas Černius <aurisc4@gmail.com>
+    Balázs Úr <urbalazs@gmail.com>
+    Bastien Nocera <hadess@hadess.net>
+    Benjamin Steinwender <b@stbe.at>
+    Bernd Homuth <dev@hmt.im>
+    Carles Ferrando <carles.ferrando@gmail.com>
+    Chao-Hsiung Liao <j_h_liau@yahoo.com.tw>
+    Chris Lord <chris@linux.intel.com>
+    Christian Kirbach <Christian.Kirbach@googlemail.com>
+    Claudio Arseni <claudio.arseni@ubuntu.com>
+    Claudio Arseni <claudio.arseni@gmail.com>
+    Colin Walters <walters@verbum.org>
+    Cédric Valmary <cvalmary@yahoo.fr>
+    César García Tapia <tapia@openshine.com>
+    Damien Lespiau <damien.lespiau@intel.com>
+    Daniel Korostil <ted.korostiled@gmail.com>
+    Daniel Mustieles <daniel.mustieles@gmail.com>
+    Dimitris Spingos <dmtrs32@gmail.com>
+    Dominique Leuenberger <dimstar@opensuse.org>
+    Dušan Kazik <prescott66@gmail.com>
+    Eduardo Lima Mitev <elima@igalia.com>
+    Efstathios Iosifidis <iosifidis@opensuse.org>
+    Emanuele Aina <emanuele.aina@collabora.com>
+    Emmanuele Bassi <ebassi@gnome.org>
+    Enrico Nicoletto <liverig@gmail.com>
+    Evan Nemerson <evan@coeus-group.com>
+    Evgeny Bobkin <evgen.ibqn@gmail.com>
+    Fabien Lebaillif - Delamare <fabien@developers.arq-media.com>
+    Fernando Carvalho <phaetonkde@gmail.com>
+    Fran Diéguez <fran.dieguez@mabishu.com>
+    GNOME Translation Robot <gnome-sysadmin@gnome.org>
+    Gabor Kelemen <kelemeng@gnome.hu>
+    George Sedov <radist.morse@gmail.com>
+    Gil Forcada <gforcada@gnome.org>
+    Guillaume Emont <gemont@igalia.com>
+    Guillaume Emont <guijemont@igalia.com>
+    Iago Toral Quiroga <itoral@igalia.com>
+    Inaki Larranaga Murgoitio <dooteo@zundan.com>
+    Jacobo Aragunde Pérez <jaragunde@igalia.com>
+    Jasper Lievisse Adriaanse <jasper@humppa.nl>
+    Jens Georg <jensg@openismus.com>
+    Jens Georg <mail@jensge.org>
+    Jiro Matsuzawa <jmatsuzawa@gnome.org>
+    Joaquim Rocha <jrocha@igalia.com>
+    José Dapena Paz <jdapena@igalia.com>
+    Juan A. Suarez Romero <jasuarez@igalia.com>
+    Jussi Kukkonen <jku@linux.intel.com>
+    Kalev Lember <kalevlember@gmail.com>
+    Kenneth Nielsen <k.nielsen81@gmail.com>
+    Kjartan Maraas <kmaraas@gnome.org>
+    Kristjan SCHMIDT <kristjan.schmidt@googlemail.com>
+    Lionel Landwerlin <lionel.g.landwerlin@linux.intel.com>
+    MarMav <mavridou@gmail.com>
+    Marc-André Lureau <marcandre.lureau@gmail.com>
+    Marcus Lundblad <ml@update.uu.se>
+    Marek Chalupa <mchalupa@redhat.com>
+    Marek Černocký <marek@manet.cz>
+    Martin Srebotnjak <miles@filmsi.net>
+    Matej Urbančič <mateju@svn.gnome.org>
+    Mateu Batle <mateu.batle@collabora.com>
+    Mathias Hasselmann <mathias@openismus.com>
+    Mathieu Duponchelle <mathieu.duponchelle@opencreed.com>
+    Michael Wood <michael.g.wood@linux.intel.com>
+    Miguel Rodriguez Núñez <bokerones.fritos@gmail.com>
+    Mike Ruprecht <mike.ruprecht@collabora.co.uk>
+    Muhammet Kara <muhammetk@gmail.com>
+    Murray Cumming <murrayc@openismus.com>
+    Murray Cumming <murrayc@murrayc.com>
+    Nilamdyuti Goswami <ngoswami@redhat.com>
+    Nishio Futoshi <fut_nis@d3.dion.ne.jp>
+    Nuno Araujo <nuno.araujo@russo79.com>
+    Olav Vitters <olav@vitters.nl>
+    Oliver Krylow <okrylow@gmail.com>
+    Pedro Albuquerque <palbuquerque73@gmail.com>
+    Philip Withnall <philip.withnall@collabora.co.uk>
+    Piotr Drąg <piotrdrag@gmail.com>
+    Rafael Ferreira <rafael.f.f1@gmail.com>
+    Ryan Lortie <desrt@desrt.ca>
+    Rūdolfs Mazurs <rudolfsm@src.gnome.org>
+    Sam Thursfield <sam.thursfield@codethink.co.uk>
+    Samir Ribic <samir.ribic@etf.unsa.ba>
+    Sebastian Keller <sebastian-keller@gmx.de>
+    Seong-ho Cho <darkcircle.0426@gmail.com>
+    Seong-ho Cho <shcho@gnome.org>
+    Sergio Villar Senin <svillar@igalia.com>
+    Simon Pena <spena@igalia.com>
+    Simon Wenner <simon@wenner.ch>
+    Simón Pena <spenap@gmail.com>
+    Stefan Kost <ensonic@users.sf.net>
+    Ting-Wei Lan <lantw@src.gnome.org>
+    Tom Tryfonidis <tomtryf@gmail.com>
+    Victor Ibragimov <victor.ibragimov@gmail.com>
+    Victor Manuel Jaquez Leal <vjaquez@igalia.com>
+    Victor Toso <me@victortoso.com>
+    Wolfgang Stöggl <c72578@yahoo.de>
+    Wylmer Wang <wantinghard@gmail.com>
+    Xabier Rodriguez Calvar <xrcalvar@igalia.com>
+    Xavier Claessens <xavier.claessens@collabora.com>
+    Yaakov Selkowitz <yselkowitz@users.sourceforge.net>
+    Yosef Or Boczko <yoseforb@src.gnome.org>
+    iain <iain@linux.intel.com>
+    leo <leo@Satan>
+    Милош Поповић <gpopac@gmail.com>
+    Мирослав Николић <miroslavnikolic@rocketmail.com>
+    甘露(Gan  Lu) <rhythm.gan@gmail.com>
+
+
 NEW in 0.2.12
 =============
 
diff --git a/configure.ac b/configure.ac
index 9af45a4..a03903e 100644
--- a/configure.ac
+++ b/configure.ac
@@ -57,9 +57,9 @@ AC_DEFINE_UNQUOTED(GRLPLS_VERSION, "$GRLPLS_VERSION", [Grilo Pls library version
 # Libtool library version, not to confuse with API version
 # see http://www.gnu.org/software/libtool/manual/html_node/Libtool-versioning.html
 
-GRL_LT_VERSION=10:0:0
-GRLNET_LT_VERSION=2:0:0
-GRLPLS_LT_VERSION=1:0:0
+GRL_LT_VERSION=0:0:0
+GRLNET_LT_VERSION=0:0:0
+GRLPLS_LT_VERSION=0:0:0
 
 AC_SUBST([GRL_LT_VERSION])
 AC_SUBST([GRLNET_LT_VERSION])
diff --git a/src/data/grl-media.c b/src/data/grl-media.c
index deaed68..a361665 100644
--- a/src/data/grl-media.c
+++ b/src/data/grl-media.c
@@ -214,6 +214,8 @@ grl_media_image_new (void)
  * Creates a new media container object.
  *
  * Returns: a newly-allocated media container.
+ *
+ * Since: 0.3.0
  **/
 GrlMedia *
 grl_media_container_new (void)
@@ -223,6 +225,16 @@ grl_media_container_new (void)
                        NULL);
 }
 
+/**
+ * grl_media_is_audio:
+ * @media: a media
+ *
+ * Check if @media is an audio
+ *
+ * Returns: %TRUE if @media is an audio
+ *
+ * Since: 0.3.0
+ **/
 gboolean
 grl_media_is_audio (GrlMedia *media)
 {
@@ -231,6 +243,16 @@ grl_media_is_audio (GrlMedia *media)
   return (media->priv->media_type == GRL_MEDIA_TYPE_AUDIO);
 }
 
+/**
+ * grl_media_is_video:
+ * @media: a media
+ *
+ * Check if @media is a video
+ *
+ * Returns: %TRUE if @media is a video
+ *
+ * Since: 0.3.0
+ **/
 gboolean
 grl_media_is_video (GrlMedia *media)
 {
@@ -239,6 +261,16 @@ grl_media_is_video (GrlMedia *media)
   return (media->priv->media_type == GRL_MEDIA_TYPE_VIDEO);
 }
 
+/**
+ * grl_media_is_image:
+ * @media: a media
+ *
+ * Check if @media is an image
+ *
+ * Returns: %TRUE if @media is an image
+ *
+ * Since: 0.3.0
+ **/
 gboolean
 grl_media_is_image (GrlMedia *media)
 {
@@ -247,6 +279,16 @@ grl_media_is_image (GrlMedia *media)
   return (media->priv->media_type == GRL_MEDIA_TYPE_IMAGE);
 }
 
+/**
+ * grl_media_is_container:
+ * @media: a media
+ *
+ * Check if @media is a container
+ *
+ * Returns: %TRUE if @media is a container
+ *
+ * Since: 0.3.0
+ **/
 gboolean
 grl_media_is_container (GrlMedia *media)
 {
@@ -290,6 +332,8 @@ grl_media_set_rating (GrlMedia *media, gfloat rating, gfloat max)
  * @height: media height, or -1 to ignore
  *
  * Sets all the keys related with the URL of a media resource in one go.
+ *
+ * Since: 0.3.0
  **/
 void
 grl_media_set_url_data (GrlMedia *media,
@@ -334,6 +378,8 @@ grl_media_set_url_data (GrlMedia *media,
  *
  * Sets all the keys related with the URL of a media resource and adds it to
  * @media (useful for resources with more than one URL).
+ *
+ * Since: 0.3.0
  **/
 void
 grl_media_add_url_data (GrlMedia *media,
@@ -488,6 +534,8 @@ grl_media_add_keyword (GrlMedia *media,
  * @artist: an audio's artist
  *
  * Adds a new artist to @media.
+ *
+ * Since: 0.3.0
  **/
 void
 grl_media_add_artist (GrlMedia *media, const gchar *artist)
@@ -502,6 +550,8 @@ grl_media_add_artist (GrlMedia *media, const gchar *artist)
  * @genre: an audio's genre
  *
  * Adds a new genre to @media.
+ *
+ * Since: 0.3.0
  **/
 void
 grl_media_add_genre (GrlMedia *media, const gchar *genre)
@@ -516,6 +566,8 @@ grl_media_add_genre (GrlMedia *media, const gchar *genre)
  * @lyrics: an audio's lyrics
  *
  * Adds a new lyrics to @media.
+ *
+ * Since: 0.3.0
  **/
 void
 grl_media_add_lyrics (GrlMedia *media, const gchar *lyrics)
@@ -530,6 +582,8 @@ grl_media_add_lyrics (GrlMedia *media, const gchar *lyrics)
  * @mb_artist_id: a MusicBrainz artist identifier
  *
  * Adds a new MusicBrainz artist id to @media.
+ *
+ * Since: 0.3.0
  **/
 void
 grl_media_add_mb_artist_id (GrlMedia *media,
@@ -546,6 +600,8 @@ grl_media_add_mb_artist_id (GrlMedia *media,
  * @performer: an actor performing in the movie
  *
  * Adds the actor performing in the movie.
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_add_performer (GrlMedia *media,
@@ -563,6 +619,8 @@ grl_media_add_performer (GrlMedia *media,
  * @producer: producer of the movie
  *
  * Adds the producer of the media.
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_add_producer (GrlMedia *media,
@@ -580,6 +638,8 @@ grl_media_add_producer (GrlMedia *media,
  * @director: director of the movie
  *
  * Adds the director of the media
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_add_director (GrlMedia *media,
@@ -1343,7 +1403,7 @@ grl_media_set_play_count (GrlMedia *media, gint play_count)
  *
  * Set the media last played date
  *
- * Since: 0.1.4
+ * Since: 0.3.0
  */
 void
 grl_media_set_last_played (GrlMedia *media, const GDateTime *last_played)
@@ -1536,6 +1596,8 @@ grl_media_set_size (GrlMedia *media, gint64 size)
  * @track_number: the audio's track number
  *
  * Set the track number of the media
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_track_number (GrlMedia *media, gint track_number)
@@ -1551,6 +1613,8 @@ grl_media_set_track_number (GrlMedia *media, gint track_number)
  * @bitrate: the audio's bitrate
  *
  * Set the bitrate of the media
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_bitrate (GrlMedia *media, gint bitrate)
@@ -1566,6 +1630,8 @@ grl_media_set_bitrate (GrlMedia *media, gint bitrate)
  * @mb_track_id: the MusicBrainz track identifier
  *
  * Set the MusicBrainz track identifier of the media
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_mb_track_id (GrlMedia *media, const gchar *mb_track_id)
@@ -1581,6 +1647,8 @@ grl_media_set_mb_track_id (GrlMedia *media, const gchar *mb_track_id)
  * @mb_recording_id: the MusicBrainz recording identifier
  *
  * Set the MusicBrainz recording identifier of the media
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_mb_recording_id (GrlMedia *media,
@@ -1597,6 +1665,8 @@ grl_media_set_mb_recording_id (GrlMedia *media,
  * @mb_artist_id: the MusicBrainz artist identifier
  *
  * Set the MusicBrainz artist identifier of the media
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_mb_artist_id (GrlMedia *media, const gchar *mb_artist_id)
@@ -1612,6 +1682,8 @@ grl_media_set_mb_artist_id (GrlMedia *media, const gchar *mb_artist_id)
  * @mb_album_id: the MusicBrainz album identifier
  *
  * Set the MusicBrainz album identifier of the media
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_mb_album_id (GrlMedia *media, const gchar *mb_album_id)
@@ -1627,6 +1699,8 @@ grl_media_set_mb_album_id (GrlMedia *media, const gchar *mb_album_id)
  * @lyrics: the audio's lyrics
  *
  * Set the lyrics of the media
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_lyrics (GrlMedia *media, const gchar *lyrics)
@@ -1642,6 +1716,8 @@ grl_media_set_lyrics (GrlMedia *media, const gchar *lyrics)
  * @genre: the audio's genre
  *
  * Set the genre of the media
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_genre (GrlMedia *media, const gchar *genre)
@@ -1657,6 +1733,8 @@ grl_media_set_genre (GrlMedia *media, const gchar *genre)
  * @album: the audio's album
  *
  * Set the album of the media
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_album (GrlMedia *media, const gchar *album)
@@ -1673,7 +1751,7 @@ grl_media_set_album (GrlMedia *media, const gchar *album)
  *
  * Set the artist of the media
  *
- * Since: 0.1.4
+ * Since: 0.3.0
  */
 void
 grl_media_set_artist (GrlMedia *media, const gchar *artist)
@@ -1689,6 +1767,8 @@ grl_media_set_artist (GrlMedia *media, const gchar *artist)
  * @width: the video's width
  *
  * Set the width of the media
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_width (GrlMedia *media, gint width)
@@ -1705,6 +1785,8 @@ grl_media_set_width (GrlMedia *media, gint width)
  * @height: the video's height
  *
  * Set the height of the media
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_height (GrlMedia *media, gint height)
@@ -1721,6 +1803,8 @@ grl_media_set_height (GrlMedia *media, gint height)
  * @framerate: the video's framerate
  *
  * Set the framerate of the media
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_framerate (GrlMedia *media, gfloat framerate)
@@ -1737,6 +1821,8 @@ grl_media_set_framerate (GrlMedia *media, gfloat framerate)
  * @season: the video's season
  *
  * Sets the season number of the media
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_season (GrlMedia *media, gint season)
@@ -1753,6 +1839,8 @@ grl_media_set_season (GrlMedia *media, gint season)
  * @episode: the video's episode
  *
  * Sets the episode number of the media
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_episode (GrlMedia *media, gint episode)
@@ -1769,6 +1857,8 @@ grl_media_set_episode (GrlMedia *media, gint episode)
  * @episode_title: the title of the episode
  *
  * Sets the title of an media
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_episode_title (GrlMedia *media,
@@ -1787,6 +1877,8 @@ grl_media_set_episode_title (GrlMedia *media,
  * @show: the video's show name
  *
  * Sets the show title of the media
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_show (GrlMedia *media, const gchar *show)
@@ -1803,6 +1895,8 @@ grl_media_set_show (GrlMedia *media, const gchar *show)
  * @performer: an actor performing in the movie
  *
  * Sets the actor performing in the movie.
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_performer (GrlMedia *media,
@@ -1820,6 +1914,8 @@ grl_media_set_performer (GrlMedia *media,
  * @producer: producer of the movie
  *
  * Sets the producer of the media.
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_producer (GrlMedia *media, const gchar *producer)
@@ -1836,6 +1932,8 @@ grl_media_set_producer (GrlMedia *media, const gchar *producer)
  * @director: director of the movie
  *
  * Sets the director of the media.
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_director (GrlMedia *media,
@@ -1853,6 +1951,8 @@ grl_media_set_director (GrlMedia *media,
  * @original_title: original, untranslated title of the movie
  *
  * Sets the original, untranslated title of the media.
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_original_title (GrlMedia *media,
@@ -1870,6 +1970,8 @@ grl_media_set_original_title (GrlMedia *media,
   * @camera_model: model of camera used to take picture
   *
   * Set the camera_model of the media
+  *
+  * Since: 0.3.0
   */
 void
 grl_media_set_camera_model (GrlMedia *media,
@@ -1889,6 +1991,8 @@ grl_media_set_camera_model (GrlMedia *media,
   * Set the flash_used of the media
   * See
   * http://library.gnome.org/devel/ontology/unstable/nmm-classes.html#nmm-Flash
+  *
+  * Since: 0.3.0
   */
 void
 grl_media_set_flash_used (GrlMedia *media,
@@ -1906,6 +2010,8 @@ grl_media_set_flash_used (GrlMedia *media,
   * @exposure_time: picture's exposure time
   *
   * Set the exposure_time of the media
+  *
+  * Since: 0.3.0
   */
 void
 grl_media_set_exposure_time (GrlMedia *media,
@@ -1923,6 +2029,8 @@ grl_media_set_exposure_time (GrlMedia *media,
   * @iso_speed: picture's iso speed
   *
   * Set the iso_speed of the media
+  *
+  * Since: 0.3.0
   */
 void
 grl_media_set_iso_speed (GrlMedia *media,
@@ -1940,6 +2048,8 @@ grl_media_set_iso_speed (GrlMedia *media,
   * @orientation: degrees clockwise orientation of the picture
   *
   * Set the orientation of the media
+  *
+  * Since: 0.3.0
   */
 void
 grl_media_set_orientation (GrlMedia *media,
@@ -1958,6 +2068,8 @@ grl_media_set_orientation (GrlMedia *media,
  *
  * Sets the number of children of this container. Use
  * #GRL_METADATA_KEY_CHILDCOUNT_UNKNOWN if it is unknown.
+ *
+ * Since: 0.3.0
  */
 void
 grl_media_set_childcount (GrlMedia *media,
@@ -2015,6 +2127,8 @@ grl_media_get_url (GrlMedia *media)
  * @height: the url height, or %NULL to ignore
  *
  * Returns: the media's URL and its related properties.
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_url_data (GrlMedia *media,
@@ -2045,8 +2159,10 @@ grl_media_get_url_data (GrlMedia *media,
  * @framerate: the url framerate, or %NULL to ignore
  * @width: the url width, or %NULL to ignore
  * @height: the url height, or %NULL to ignore
-*
+ *
  * Returns: the n-th media's URL and its related properties.
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_url_data_nth (GrlMedia *media,
@@ -2536,7 +2652,7 @@ grl_media_get_last_position (GrlMedia *media)
  *
  * Returns: the media's last played time
  *
- * Since: 0.1.4
+ * Since: 0.3.0
  */
 GDateTime *
 grl_media_get_last_played (GrlMedia *media)
@@ -2791,6 +2907,8 @@ grl_media_get_size (GrlMedia *media)
  * @media: the media instance
  *
  * Returns: the track number of the media
+ *
+ * Since: 0.3.0
  */
 gint
 grl_media_get_track_number (GrlMedia *media)
@@ -2804,6 +2922,8 @@ grl_media_get_track_number (GrlMedia *media)
  * @media: the media instance
  *
  * Returns: the bitrate of the media
+ *
+ * Since: 0.3.0
  */
 gint
 grl_media_get_bitrate (GrlMedia *media)
@@ -2817,6 +2937,8 @@ grl_media_get_bitrate (GrlMedia *media)
  * @media: the media instance
  *
  * Returns: the MusicBrainz album identifier
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_mb_album_id (GrlMedia *media)
@@ -2830,6 +2952,8 @@ grl_media_get_mb_album_id (GrlMedia *media)
  * @media: the media instance
  *
  * Returns: the MusicBrainz artist identifier
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_mb_artist_id (GrlMedia *media)
@@ -2844,6 +2968,8 @@ grl_media_get_mb_artist_id (GrlMedia *media)
  * @index: element to retrieve, starting at 0
  *
  * Returns: the n-th MusicBrainz artist identifier of the media
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_mb_artist_id_nth (GrlMedia *media, guint index)
@@ -2869,6 +2995,8 @@ grl_media_get_mb_artist_id_nth (GrlMedia *media, guint index)
  * @media: the media instance
  *
  * Returns: the MusicBrainz recording identifier
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_mb_recording_id (GrlMedia *media)
@@ -2882,7 +3010,8 @@ grl_media_get_mb_recording_id (GrlMedia *media)
  * @media: the media instance
  *
  * Returns: the MusicBrainz track identifier
- * Since: 0.2.12
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_mb_track_id (GrlMedia *media)
@@ -2896,6 +3025,8 @@ grl_media_get_mb_track_id (GrlMedia *media)
  * @media: the media instance
  *
  * Returns: the lyrics of the media
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_lyrics (GrlMedia *media)
@@ -2910,6 +3041,8 @@ grl_media_get_lyrics (GrlMedia *media)
  * @index: element to retrieve, starting at 0
  *
  * Returns: the n-th lyrics of the media
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_lyrics_nth (GrlMedia *media, guint index)
@@ -2935,6 +3068,8 @@ grl_media_get_lyrics_nth (GrlMedia *media, guint index)
  * @media: the media instance
  *
  * Returns: the genre of the media
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_genre (GrlMedia *media)
@@ -2949,6 +3084,8 @@ grl_media_get_genre (GrlMedia *media)
  * @index: element to retrieve, starting at 0
  *
  * Returns: the n-th genre of the media
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_genre_nth (GrlMedia *media, guint index)
@@ -2972,6 +3109,8 @@ grl_media_get_genre_nth (GrlMedia *media, guint index)
  * @media: the media instance
  *
  * Returns: the album of the media
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_album (GrlMedia *media)
@@ -2985,6 +3124,8 @@ grl_media_get_album (GrlMedia *media)
  * @media: the media instance
  *
  * Returns: the artist of the media
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_artist (GrlMedia *media)
@@ -2999,6 +3140,8 @@ grl_media_get_artist (GrlMedia *media)
  * @index: element to retrieve, starting at 0
  *
  * Returns: the n-th artist of the media
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_artist_nth (GrlMedia *media, guint index)
@@ -3019,6 +3162,16 @@ grl_media_get_artist_nth (GrlMedia *media, guint index)
   }
 }
 
+/**
+ * grl_media_get_media_type:
+ * @media: the media instance
+ *
+ * Gets the "media-type" property.
+ *
+ * Returns: media type
+ *
+ * Since: 0.3.0
+ */
 GrlMediaType
 grl_media_get_media_type (GrlMedia *media)
 {
@@ -3032,6 +3185,8 @@ grl_media_get_media_type (GrlMedia *media)
  * @media: the media instance
  *
  * Returns: the width of the media
+ *
+ * Since: 0.3.0
  */
 gint
 grl_media_get_width (GrlMedia *media)
@@ -3045,6 +3200,8 @@ grl_media_get_width (GrlMedia *media)
  * @media: the media instance
  *
  * Returns: the height of the media
+ *
+ * Since: 0.3.0
  */
 gint
 grl_media_get_height (GrlMedia *media)
@@ -3058,6 +3215,8 @@ grl_media_get_height (GrlMedia *media)
  * @media: the media instance
  *
  * Returns: the framerate of the media
+ *
+ * Since: 0.3.0
  */
 gfloat
 grl_media_get_framerate (GrlMedia *media)
@@ -3071,6 +3230,8 @@ grl_media_get_framerate (GrlMedia *media)
  * @media: the media instance
  *
  * Returns: the season number of the media
+ *
+ * Since: 0.3.0
  */
 gint
 grl_media_get_season (GrlMedia *media)
@@ -3084,6 +3245,8 @@ grl_media_get_season (GrlMedia *media)
  * @media: the media instance
  *
  * Returns: the episode number of the media
+ *
+ * Since: 0.3.0
  */
 gint
 grl_media_get_episode (GrlMedia *media)
@@ -3097,6 +3260,8 @@ grl_media_get_episode (GrlMedia *media)
  * @media: the media instance
  *
  * Returns: the title of the episode
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_episode_title (GrlMedia *media)
@@ -3111,6 +3276,8 @@ grl_media_get_episode_title (GrlMedia *media)
  * @media: the media instance
  *
  * Returns: the show title of the media
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_show (GrlMedia *media)
@@ -3125,6 +3292,8 @@ grl_media_get_show (GrlMedia *media)
  * @media: a #GrlMedia
  *
  * Returns: (transfer none): the actor performing in the movie (owned by @media).
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_performer (GrlMedia *media)
@@ -3140,6 +3309,8 @@ grl_media_get_performer (GrlMedia *media)
  * @index: element to retrieve
  *
  * Returns: (transfer none): the actor performing in the movie (owned by @medi).
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_performer_nth (GrlMedia *media,
@@ -3167,6 +3338,8 @@ grl_media_get_performer_nth (GrlMedia *media,
  * @media: a #GrlMedia
  *
  * Returns: (transfer none): the producer of the movie (owned by @media).
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_producer (GrlMedia *media)
@@ -3182,6 +3355,8 @@ grl_media_get_producer (GrlMedia *media)
  * @index: element to retrieve
  *
  * Returns: (transfer none): the producer of the movie (owned by @media).
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_producer_nth (GrlMedia *media,
@@ -3209,6 +3384,8 @@ grl_media_get_producer_nth (GrlMedia *media,
  * @media: a #GrlMedia
  *
  * Returns: (transfer none): the director of the movie (owned by @media).
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_director (GrlMedia *media)
@@ -3224,6 +3401,8 @@ grl_media_get_director (GrlMedia *media)
  * @index: element to retrieve
  *
  * Returns: (transfer none): the director of the movie (owned by @media).
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_director_nth (GrlMedia *media,
@@ -3251,6 +3430,8 @@ grl_media_get_director_nth (GrlMedia *media,
  * @media: a #GrlMedia
  *
  * Returns: (transfer none): the original, untranslated title of the movie (owned by @media).
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_original_title (GrlMedia *media)
@@ -3265,6 +3446,8 @@ grl_media_get_original_title (GrlMedia *media)
  * @media: the media instance
  *
  * Returns: model of camera used to take picture
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_camera_model (GrlMedia *media)
@@ -3279,9 +3462,11 @@ grl_media_get_camera_model (GrlMedia *media)
  * @media: the media instance
  *
  * Returns: whether the flash was used.
-
+ *
  * See
  * http://library.gnome.org/devel/ontology/unstable/nmm-classes.html#nmm-Flash
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_media_get_flash_used (GrlMedia *media)
@@ -3296,6 +3481,8 @@ grl_media_get_flash_used (GrlMedia *media)
  * @media: the media instance
  *
  * Returns: picture's exposure time
+ *
+ * Since: 0.3.0
  */
 gfloat
 grl_media_get_exposure_time (GrlMedia *media)
@@ -3310,6 +3497,8 @@ grl_media_get_exposure_time (GrlMedia *media)
  * @media: the media instance
  *
  * Returns: picture's iso speed
+ *
+ * Since: 0.3.0
  */
 gfloat
 grl_media_get_iso_speed (GrlMedia *media)
@@ -3324,6 +3513,8 @@ grl_media_get_iso_speed (GrlMedia *media)
  * @media: the image instance
  *
  * Returns: degrees clockwise orientation of the picture
+ *
+ * Since: 0.3.0
  */
 gint
 grl_media_get_orientation (GrlMedia *media)
@@ -3341,6 +3532,8 @@ grl_media_get_orientation (GrlMedia *media)
  *
  * Returns: number of children, or #GRL_METADATA_KEY_CHILDCOUNT_UNKNOWN if
  * unknown.
+ *
+ * Since: 0.3.0
  */
 gint
 grl_media_get_childcount (GrlMedia *media)
diff --git a/src/grl-plugin.c b/src/grl-plugin.c
index 739a522..4c4311f 100644
--- a/src/grl-plugin.c
+++ b/src/grl-plugin.c
@@ -511,6 +511,8 @@ grl_plugin_get_filename (GrlPlugin *plugin)
  * Get the plugin module name
  *
  * Returns: the module name containing @plugin
+ *
+ * Since: 0.3.0
  */
 const gchar *
 grl_plugin_get_module_name (GrlPlugin *plugin)
diff --git a/src/grl-registry.c b/src/grl-registry.c
index 88bb11f..0622ef0 100644
--- a/src/grl-registry.c
+++ b/src/grl-registry.c
@@ -1131,6 +1131,8 @@ grl_registry_prepare_plugin (GrlRegistry *registry,
  * Activate all the plugins loaded.
  *
  * Returns: %TRUE if some plugin has been activated
+ *
+ * Since: 0.3.0
  **/
 gboolean
 grl_registry_activate_all_plugins (GrlRegistry *registry)
@@ -1339,6 +1341,7 @@ grl_registry_load_all_plugins (GrlRegistry *registry,
  *
  * Returns: %TRUE if the plugin is loaded correctly
  *
+ * Since: 0.3.0
  **/
 gboolean
 grl_registry_activate_plugin_by_id (GrlRegistry *registry,
@@ -1631,7 +1634,7 @@ grl_registry_unload_plugin (GrlRegistry *registry,
 
  * Returns: The #GrlKeyID registered.
  *
- * Since: 0.2.0
+ * Since: 0.3.0
  */
 GrlKeyID
 grl_registry_register_metadata_key (GrlRegistry *registry,
diff --git a/src/grl-registry.h b/src/grl-registry.h
index 2de5200..1bbcb63 100644
--- a/src/grl-registry.h
+++ b/src/grl-registry.h
@@ -88,6 +88,8 @@
 * the module.
 * @register_keys: (allow-none): function to execute before loading the
 * plugin. It's aim is to register new keys
+*
+* Since: 0.3.0
 */
 #define GRL_PLUGIN_DEFINE(major,                                \
                           minor,                                \
@@ -150,6 +152,8 @@ typedef void (*GrlPluginRegisterKeysFunc) (GrlRegistry *registry,
 * is to register new keys
 *
 * This structure is used for the module loader
+*
+* Since: 0.3.0
 */
 struct _GrlPluginDescriptor {
   gint major_version;
diff --git a/src/grl-source.c b/src/grl-source.c
index 8471c96..aedbacc 100644
--- a/src/grl-source.c
+++ b/src/grl-source.c
@@ -3095,7 +3095,7 @@ grl_source_get_rank (GrlSource *source)
  *
  * Returns: a #GrlSupportedMedia value
  *
- * Since: 0.2.3
+ * Since: 0.3.0
  **/
 GrlSupportedMedia
 grl_source_get_supported_media (GrlSource *source)
@@ -4331,7 +4331,7 @@ grl_source_store_impl (GrlSource *source,
  *
  * This method is asynchronous.
  *
- * Since: 0.2.0
+ * Since: 0.3.0
  */
 void
 grl_source_store (GrlSource *source,
@@ -4356,7 +4356,7 @@ grl_source_store (GrlSource *source,
  *
  * This method is synchronous.
  *
- * Since: 0.2.0
+ * Since: 0.3.0
  */
 void
 grl_source_store_sync (GrlSource *source,