From 30cf8a58e0f7f6520112c45b7d2877bdecbd6bc1 Mon Sep 17 00:00:00 2001
From: Philip Withnall <philip@tecnocode.co.uk>
Date: Mon, 3 Nov 2014 00:13:51 +0000
Subject: core: Mark all API as stable and impose API and ABI stability
 guarantees
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

It’s time for libgdata to grow up and start guaranteeing some stability
for its users. In this vein, it’s already been API stable for around 3
years (since 0.9.1) — it’s about time that was made explicit.

http://upstream-tracker.org/versions/libgdata.html is quite interesting.
---
 HACKING                                                 | 9 +++++++--
 README                                                  | 2 +-
 gdata/app/gdata-app-categories.c                        | 2 +-
 gdata/atom/gdata-author.c                               | 2 +-
 gdata/atom/gdata-category.c                             | 2 +-
 gdata/atom/gdata-generator.c                            | 2 +-
 gdata/atom/gdata-link.c                                 | 2 +-
 gdata/exif/gdata-exif-tags.c                            | 2 +-
 gdata/gcontact/gdata-gcontact-calendar.c                | 2 +-
 gdata/gcontact/gdata-gcontact-event.c                   | 2 +-
 gdata/gcontact/gdata-gcontact-external-id.c             | 2 +-
 gdata/gcontact/gdata-gcontact-jot.c                     | 2 +-
 gdata/gcontact/gdata-gcontact-language.c                | 2 +-
 gdata/gcontact/gdata-gcontact-relation.c                | 2 +-
 gdata/gcontact/gdata-gcontact-website.c                 | 2 +-
 gdata/gd/gdata-gd-email-address.c                       | 2 +-
 gdata/gd/gdata-gd-feed-link.c                           | 2 +-
 gdata/gd/gdata-gd-im-address.c                          | 2 +-
 gdata/gd/gdata-gd-name.c                                | 2 +-
 gdata/gd/gdata-gd-organization.c                        | 2 +-
 gdata/gd/gdata-gd-phone-number.c                        | 2 +-
 gdata/gd/gdata-gd-postal-address.c                      | 2 +-
 gdata/gd/gdata-gd-reminder.c                            | 2 +-
 gdata/gd/gdata-gd-when.c                                | 2 +-
 gdata/gd/gdata-gd-where.c                               | 2 +-
 gdata/gd/gdata-gd-who.c                                 | 2 +-
 gdata/gdata-access-handler.c                            | 2 +-
 gdata/gdata-access-rule.c                               | 2 +-
 gdata/gdata-authorization-domain.c                      | 2 +-
 gdata/gdata-authorizer.c                                | 2 +-
 gdata/gdata-batch-feed.c                                | 2 +-
 gdata/gdata-batch-operation.c                           | 2 +-
 gdata/gdata-batchable.c                                 | 2 +-
 gdata/gdata-buffer.c                                    | 2 +-
 gdata/gdata-client-login-authorizer.c                   | 2 +-
 gdata/gdata-comment.c                                   | 2 +-
 gdata/gdata-commentable.c                               | 2 +-
 gdata/gdata-comparable.c                                | 2 +-
 gdata/gdata-download-stream.c                           | 2 +-
 gdata/gdata-entry.c                                     | 2 +-
 gdata/gdata-feed.c                                      | 2 +-
 gdata/gdata-goa-authorizer.c                            | 2 +-
 gdata/gdata-oauth1-authorizer.c                         | 2 +-
 gdata/gdata-oauth2-authorizer.c                         | 2 +-
 gdata/gdata-parsable.c                                  | 2 +-
 gdata/gdata-query.c                                     | 2 +-
 gdata/gdata-service.c                                   | 2 +-
 gdata/gdata-types.c                                     | 2 +-
 gdata/gdata-upload-stream.c                             | 2 +-
 gdata/georss/gdata-georss-where.c                       | 2 +-
 gdata/media/gdata-media-category.c                      | 2 +-
 gdata/media/gdata-media-content.c                       | 2 +-
 gdata/media/gdata-media-credit.c                        | 2 +-
 gdata/media/gdata-media-group.c                         | 2 +-
 gdata/media/gdata-media-thumbnail.c                     | 2 +-
 gdata/services/calendar/gdata-calendar-calendar.c       | 2 +-
 gdata/services/calendar/gdata-calendar-event.c          | 2 +-
 gdata/services/calendar/gdata-calendar-feed.c           | 2 +-
 gdata/services/calendar/gdata-calendar-query.c          | 2 +-
 gdata/services/calendar/gdata-calendar-service.c        | 2 +-
 gdata/services/contacts/gdata-contacts-contact.c        | 2 +-
 gdata/services/contacts/gdata-contacts-group.c          | 2 +-
 gdata/services/contacts/gdata-contacts-query.c          | 2 +-
 gdata/services/contacts/gdata-contacts-service.c        | 2 +-
 gdata/services/documents/gdata-documents-document.c     | 2 +-
 gdata/services/documents/gdata-documents-drawing.c      | 2 +-
 gdata/services/documents/gdata-documents-entry.c        | 2 +-
 gdata/services/documents/gdata-documents-feed.c         | 2 +-
 gdata/services/documents/gdata-documents-folder.c       | 2 +-
 gdata/services/documents/gdata-documents-pdf.c          | 2 +-
 gdata/services/documents/gdata-documents-presentation.c | 2 +-
 gdata/services/documents/gdata-documents-query.c        | 2 +-
 gdata/services/documents/gdata-documents-service.c      | 2 +-
 gdata/services/documents/gdata-documents-spreadsheet.c  | 2 +-
 gdata/services/documents/gdata-documents-text.c         | 2 +-
 gdata/services/documents/gdata-documents-upload-query.c | 2 +-
 gdata/services/freebase/gdata-freebase-query.c          | 2 +-
 gdata/services/freebase/gdata-freebase-result.c         | 2 +-
 gdata/services/freebase/gdata-freebase-search-query.c   | 2 +-
 gdata/services/freebase/gdata-freebase-search-result.c  | 2 +-
 gdata/services/freebase/gdata-freebase-service.c        | 2 +-
 gdata/services/freebase/gdata-freebase-topic-query.c    | 2 +-
 gdata/services/freebase/gdata-freebase-topic-result.c   | 2 +-
 gdata/services/picasaweb/gdata-picasaweb-album.c        | 2 +-
 gdata/services/picasaweb/gdata-picasaweb-comment.c      | 2 +-
 gdata/services/picasaweb/gdata-picasaweb-feed.c         | 2 +-
 gdata/services/picasaweb/gdata-picasaweb-file.c         | 2 +-
 gdata/services/picasaweb/gdata-picasaweb-query.c        | 2 +-
 gdata/services/picasaweb/gdata-picasaweb-service.c      | 2 +-
 gdata/services/picasaweb/gdata-picasaweb-user.c         | 2 +-
 gdata/services/tasks/gdata-tasks-query.c                | 2 +-
 gdata/services/tasks/gdata-tasks-service.c              | 2 +-
 gdata/services/tasks/gdata-tasks-task.c                 | 2 +-
 gdata/services/tasks/gdata-tasks-tasklist.c             | 2 +-
 gdata/services/youtube/gdata-youtube-category.c         | 2 +-
 gdata/services/youtube/gdata-youtube-comment.c          | 2 +-
 gdata/services/youtube/gdata-youtube-content.c          | 2 +-
 gdata/services/youtube/gdata-youtube-control.c          | 2 +-
 gdata/services/youtube/gdata-youtube-credit.c           | 2 +-
 gdata/services/youtube/gdata-youtube-group.c            | 2 +-
 gdata/services/youtube/gdata-youtube-query.c            | 2 +-
 gdata/services/youtube/gdata-youtube-service.c          | 2 +-
 gdata/services/youtube/gdata-youtube-state.c            | 2 +-
 gdata/services/youtube/gdata-youtube-video.c            | 2 +-
 gdata/tests/gdata-dummy-authorizer.c                    | 2 +-
 105 files changed, 111 insertions(+), 106 deletions(-)

diff --git a/HACKING b/HACKING
index 6f4dca86..587b5b8e 100644
--- a/HACKING
+++ b/HACKING
@@ -124,6 +124,9 @@ Adding public API
  - Any async function which uses non-async-scope callbacks as well as the async ready callback should provide GDestroyNotify callbacks for destroying
    the user data for those callbacks. See https://bugzilla.gnome.org/show_bug.cgi?id=649728 for details.
 
+ - Any new class’ class structure (e.g. GDataServiceClass) must have reserved slots to allow future API additions of virtual functions without
+   breaking ABI.
+
 Choosing function names
 =======================
 
@@ -205,7 +208,9 @@ Versioning
 ==========
 
 Starting with version 0.9.0, libgdata has adopted an even–odd/stable–unstable versioning policy, where odd minor version numbers are unstable releases,
-released periodically (with increasing micro version numbers) and leading to a stable release with the next even minor version number. API breaks are
-allowed in micro releases with an odd minor version number, but not in micro releases with an even minor version number.
+released periodically (with increasing micro version numbers) and leading to a stable release with the next even minor version number. API breaks of
+new API are allowed in micro releases with an odd minor version number, but not in micro releases with an even minor version number.
+
+ABI and API backwards compatibility must be preserved unless the major version number is changed. libgdata is now ABI-stable.
 
 It is encouraged to make a new micro release of an odd minor series after each large API addition or break.
diff --git a/README b/README
index 93adb6a9..5354b66a 100644
--- a/README
+++ b/README
@@ -8,7 +8,7 @@ the common Google services, and has full asynchronous support.
 See the test programs in gdata/tests/ for simple examples of how to use the
 code.
 
-libgdata's API is currently unstable and is likely to change wildly.
+libgdata is API and ABI stable.
 
 Dependencies
 ============
diff --git a/gdata/app/gdata-app-categories.c b/gdata/app/gdata-app-categories.c
index 44a24092..375a1e25 100644
--- a/gdata/app/gdata-app-categories.c
+++ b/gdata/app/gdata-app-categories.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-app-categories
  * @short_description: GData APP categories object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/app/gdata-app-categories.h
  *
  * #GDataAPPCategories is a list of categories (#GDataCategory) returned as the result of querying an
diff --git a/gdata/atom/gdata-author.c b/gdata/atom/gdata-author.c
index 21eb38c8..f9de806d 100644
--- a/gdata/atom/gdata-author.c
+++ b/gdata/atom/gdata-author.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-author
  * @short_description: Atom author element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/atom/gdata-author.h
  *
  * #GDataAuthor represents a "author" element from the
diff --git a/gdata/atom/gdata-category.c b/gdata/atom/gdata-category.c
index 87c56039..b9da4ab9 100644
--- a/gdata/atom/gdata-category.c
+++ b/gdata/atom/gdata-category.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-category
  * @short_description: Atom category element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/atom/gdata-category.h
  *
  * #GDataCategory represents a "category" element from the
diff --git a/gdata/atom/gdata-generator.c b/gdata/atom/gdata-generator.c
index f5090b31..bba75552 100644
--- a/gdata/atom/gdata-generator.c
+++ b/gdata/atom/gdata-generator.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-generator
  * @short_description: Atom generator element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/atom/gdata-generator.h
  *
  * #GDataGenerator represents a "generator" element from the
diff --git a/gdata/atom/gdata-link.c b/gdata/atom/gdata-link.c
index 3e3d435f..8d2a9730 100644
--- a/gdata/atom/gdata-link.c
+++ b/gdata/atom/gdata-link.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-link
  * @short_description: Atom link element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/atom/gdata-link.h
  *
  * #GDataLink represents a "link" element from the
diff --git a/gdata/exif/gdata-exif-tags.c b/gdata/exif/gdata-exif-tags.c
index 51bd2230..fbe38416 100644
--- a/gdata/exif/gdata-exif-tags.c
+++ b/gdata/exif/gdata-exif-tags.c
@@ -20,7 +20,7 @@
 /*
  * SECTION:gdata-exif-tags
  * @short_description: EXIF tags element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/exif/gdata-exif-tags.h
  *
  * #GDataExifTags represents a "tags" element from the
diff --git a/gdata/gcontact/gdata-gcontact-calendar.c b/gdata/gcontact/gdata-gcontact-calendar.c
index d17b4a94..80b2d12b 100644
--- a/gdata/gcontact/gdata-gcontact-calendar.c
+++ b/gdata/gcontact/gdata-gcontact-calendar.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-gcontact-calendar
  * @short_description: gContact calendar element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gcontact/gdata-gcontact-calendar.h
  *
  * #GDataGContactCalendar represents a "calendarLink" element from the
diff --git a/gdata/gcontact/gdata-gcontact-event.c b/gdata/gcontact/gdata-gcontact-event.c
index 007fee62..d595b14e 100644
--- a/gdata/gcontact/gdata-gcontact-event.c
+++ b/gdata/gcontact/gdata-gcontact-event.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-gcontact-event
  * @short_description: gContact event element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gcontact/gdata-gcontact-event.h
  *
  * #GDataGContactEvent represents a "event" element from the
diff --git a/gdata/gcontact/gdata-gcontact-external-id.c b/gdata/gcontact/gdata-gcontact-external-id.c
index fd74dd19..480e29d2 100644
--- a/gdata/gcontact/gdata-gcontact-external-id.c
+++ b/gdata/gcontact/gdata-gcontact-external-id.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-gcontact-external-id
  * @short_description: gContact externalId element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gcontact/gdata-gcontact-external-id.h
  *
  * #GDataGContactExternalID represents an "externalId" element from the
diff --git a/gdata/gcontact/gdata-gcontact-jot.c b/gdata/gcontact/gdata-gcontact-jot.c
index 8b2637f6..3eedcca9 100644
--- a/gdata/gcontact/gdata-gcontact-jot.c
+++ b/gdata/gcontact/gdata-gcontact-jot.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-gcontact-jot
  * @short_description: gContact jot element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gcontact/gdata-gcontact-jot.h
  *
  * #GDataGContactJot represents a "jot" element from the
diff --git a/gdata/gcontact/gdata-gcontact-language.c b/gdata/gcontact/gdata-gcontact-language.c
index 44a43618..ac524892 100644
--- a/gdata/gcontact/gdata-gcontact-language.c
+++ b/gdata/gcontact/gdata-gcontact-language.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-gcontact-language
  * @short_description: gContact language element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gcontact/gdata-gcontact-language.h
  *
  * #GDataGContactLanguage represents a "language" element from the
diff --git a/gdata/gcontact/gdata-gcontact-relation.c b/gdata/gcontact/gdata-gcontact-relation.c
index 2cfcac5d..9d1062e2 100644
--- a/gdata/gcontact/gdata-gcontact-relation.c
+++ b/gdata/gcontact/gdata-gcontact-relation.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-gcontact-relation
  * @short_description: gContact relation element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gcontact/gdata-gcontact-relation.h
  *
  * #GDataGContactRelation represents a "relation" element from the
diff --git a/gdata/gcontact/gdata-gcontact-website.c b/gdata/gcontact/gdata-gcontact-website.c
index edfcbdbf..8e79bc60 100644
--- a/gdata/gcontact/gdata-gcontact-website.c
+++ b/gdata/gcontact/gdata-gcontact-website.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-gcontact-website
  * @short_description: gContact website element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gcontact/gdata-gcontact-website.h
  *
  * #GDataGContactWebsite represents a "website" element from the
diff --git a/gdata/gd/gdata-gd-email-address.c b/gdata/gd/gdata-gd-email-address.c
index d1ef2bf7..2950e664 100644
--- a/gdata/gd/gdata-gd-email-address.c
+++ b/gdata/gd/gdata-gd-email-address.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-gd-email-address
  * @short_description: GData e-mail address element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gd/gdata-gd-email-address.h
  *
  * #GDataGDEmailAddress represents an "email" element from the
diff --git a/gdata/gd/gdata-gd-feed-link.c b/gdata/gd/gdata-gd-feed-link.c
index eb751066..e29ee51e 100644
--- a/gdata/gd/gdata-gd-feed-link.c
+++ b/gdata/gd/gdata-gd-feed-link.c
@@ -21,7 +21,7 @@
 /*
  * SECTION:gdata-gd-feed-link
  * @short_description: GD feed link element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gd/gdata-gd-feed-link.h
  *
  * #GDataGDFeedLink represents a "feedLink" element from the
diff --git a/gdata/gd/gdata-gd-im-address.c b/gdata/gd/gdata-gd-im-address.c
index 3ded135e..eae29e7c 100644
--- a/gdata/gd/gdata-gd-im-address.c
+++ b/gdata/gd/gdata-gd-im-address.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-gd-im-address
  * @short_description: GData instant messaging address element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gd/gdata-gd-im-address.h
  *
  * #GDataGDIMAddress represents an "im" element from the
diff --git a/gdata/gd/gdata-gd-name.c b/gdata/gd/gdata-gd-name.c
index 7da99934..32d1dd57 100644
--- a/gdata/gd/gdata-gd-name.c
+++ b/gdata/gd/gdata-gd-name.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-gd-name
  * @short_description: GData name element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gd/gdata-gd-name.h
  *
  * #GDataGDName represents a "name" element from the
diff --git a/gdata/gd/gdata-gd-organization.c b/gdata/gd/gdata-gd-organization.c
index fe15d251..f4e6f811 100644
--- a/gdata/gd/gdata-gd-organization.c
+++ b/gdata/gd/gdata-gd-organization.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-gd-organization
  * @short_description: GData organization element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gd/gdata-gd-organization.h
  *
  * #GDataGDOrganization represents an "organization" element from the
diff --git a/gdata/gd/gdata-gd-phone-number.c b/gdata/gd/gdata-gd-phone-number.c
index 5a8d3e4b..280798e6 100644
--- a/gdata/gd/gdata-gd-phone-number.c
+++ b/gdata/gd/gdata-gd-phone-number.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-gd-phone-number
  * @short_description: GData phone number element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gd/gdata-gd-phone-number.h
  *
  * #GDataGDPhoneNumber represents a "phoneNumber" element from the
diff --git a/gdata/gd/gdata-gd-postal-address.c b/gdata/gd/gdata-gd-postal-address.c
index 38689763..6067409a 100644
--- a/gdata/gd/gdata-gd-postal-address.c
+++ b/gdata/gd/gdata-gd-postal-address.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-gd-postal-address
  * @short_description: GData postal address element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gd/gdata-gd-postal-address.h
  *
  * #GDataGDPostalAddress represents a "structuredPostalAddress" element from the
diff --git a/gdata/gd/gdata-gd-reminder.c b/gdata/gd/gdata-gd-reminder.c
index 2e8d7b7a..92763037 100644
--- a/gdata/gd/gdata-gd-reminder.c
+++ b/gdata/gd/gdata-gd-reminder.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-gd-reminder
  * @short_description: GData reminder element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gd/gdata-gd-reminder.h
  *
  * #GDataGDReminder represents a "reminder" element from the
diff --git a/gdata/gd/gdata-gd-when.c b/gdata/gd/gdata-gd-when.c
index 9d347cbb..52de500d 100644
--- a/gdata/gd/gdata-gd-when.c
+++ b/gdata/gd/gdata-gd-when.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-gd-when
  * @short_description: GData when element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gd/gdata-gd-when.h
  *
  * #GDataGDWhen represents a "when" element from the
diff --git a/gdata/gd/gdata-gd-where.c b/gdata/gd/gdata-gd-where.c
index 63075d19..202ac429 100644
--- a/gdata/gd/gdata-gd-where.c
+++ b/gdata/gd/gdata-gd-where.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-gd-where
  * @short_description: GData where element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gd/gdata-gd-where.h
  *
  * #GDataGDWhere represents a "where" element from the
diff --git a/gdata/gd/gdata-gd-who.c b/gdata/gd/gdata-gd-who.c
index 1264ed91..4f45a17b 100644
--- a/gdata/gd/gdata-gd-who.c
+++ b/gdata/gd/gdata-gd-who.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-gd-who
  * @short_description: GData who element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gd/gdata-gd-who.h
  *
  * #GDataGDWho represents an "who" element from the
diff --git a/gdata/gdata-access-handler.c b/gdata/gdata-access-handler.c
index 0093f615..40ef797f 100644
--- a/gdata/gdata-access-handler.c
+++ b/gdata/gdata-access-handler.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-access-handler
  * @short_description: GData access handler interface
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-access-handler.h
  *
  * #GDataAccessHandler is an interface which can be implemented by #GDataEntry<!-- -->s which can have their permissions controlled by an
diff --git a/gdata/gdata-access-rule.c b/gdata/gdata-access-rule.c
index fff2e43d..1d1c5956 100644
--- a/gdata/gdata-access-rule.c
+++ b/gdata/gdata-access-rule.c
@@ -21,7 +21,7 @@
 /**
  * SECTION:gdata-access-rule
  * @short_description: GData access rule object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-access-rule.h
  *
  * #GDataAccessRule is a subclass of #GDataEntry to represent a generic access rule from an access control list (ACL).
diff --git a/gdata/gdata-authorization-domain.c b/gdata/gdata-authorization-domain.c
index b94357a9..a0c640db 100644
--- a/gdata/gdata-authorization-domain.c
+++ b/gdata/gdata-authorization-domain.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-authorization-domain
  * @short_description: GData authorization domain
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-authorization-domain.h
  *
  * A #GDataAuthorizationDomain represents a single data domain which a user can authorize libgdata to access. This might be a domain covering the
diff --git a/gdata/gdata-authorizer.c b/gdata/gdata-authorizer.c
index f41878c8..5fa00a06 100644
--- a/gdata/gdata-authorizer.c
+++ b/gdata/gdata-authorizer.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-authorizer
  * @short_description: GData authorization interface
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-authorizer.h
  *
  * The #GDataAuthorizer interface provides a uniform way to implement authentication and authorization processes for use by #GDataService<!-- -->s.
diff --git a/gdata/gdata-batch-feed.c b/gdata/gdata-batch-feed.c
index 16d2b486..0c04bcc8 100644
--- a/gdata/gdata-batch-feed.c
+++ b/gdata/gdata-batch-feed.c
@@ -20,7 +20,7 @@
 /*
  * SECTION:gdata-batch-feed
  * @short_description: GData batch feed helper object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-batch-feed.h
  *
  * Helper class to parse the feed returned from a batch operation and instantiate different types of #GDataEntry according to the batch operation
diff --git a/gdata/gdata-batch-operation.c b/gdata/gdata-batch-operation.c
index 675473a7..1959f90d 100644
--- a/gdata/gdata-batch-operation.c
+++ b/gdata/gdata-batch-operation.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-batch-operation
  * @short_description: GData batch operation object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-batch-operation.h
  *
  * #GDataBatchOperation is a transient standalone class which represents and handles a single batch operation request to a service. To make a batch
diff --git a/gdata/gdata-batchable.c b/gdata/gdata-batchable.c
index df053fa5..6389a4dc 100644
--- a/gdata/gdata-batchable.c
+++ b/gdata/gdata-batchable.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-batchable
  * @short_description: GData batch service interface
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-batchable.h
  *
  * #GDataBatchable is an interface which can be implemented by #GDataService<!-- -->s which support batch operations on their entries. It allows the
diff --git a/gdata/gdata-buffer.c b/gdata/gdata-buffer.c
index e7b46991..c8c1298f 100644
--- a/gdata/gdata-buffer.c
+++ b/gdata/gdata-buffer.c
@@ -20,7 +20,7 @@
 /*
  * SECTION:gdata-buffer
  * @short_description: GData buffer to allow threadsafe buffering
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-buffer.h
  *
  * #GDataBuffer is a simple object which allows threadsafe buffering of data meaning, for example, data can be received from
diff --git a/gdata/gdata-client-login-authorizer.c b/gdata/gdata-client-login-authorizer.c
index 4a7fb4df..5596be24 100644
--- a/gdata/gdata-client-login-authorizer.c
+++ b/gdata/gdata-client-login-authorizer.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-client-login-authorizer
  * @short_description: GData ClientLogin authorization interface
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-client-login-authorizer.h
  *
  * #GDataClientLoginAuthorizer provides an implementation of the #GDataAuthorizer interface for authentication and authorization using the deprecated
diff --git a/gdata/gdata-comment.c b/gdata/gdata-comment.c
index b1306a80..c5bcc103 100644
--- a/gdata/gdata-comment.c
+++ b/gdata/gdata-comment.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-comment
  * @short_description: GData comment object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-comment.h
  *
  * #GDataComment is a subclass of #GDataEntry to represent a generic comment on an entry. It is returned by the methods implemented in the
diff --git a/gdata/gdata-commentable.c b/gdata/gdata-commentable.c
index 57f41090..96ed4eeb 100644
--- a/gdata/gdata-commentable.c
+++ b/gdata/gdata-commentable.c
@@ -21,7 +21,7 @@
 /**
  * SECTION:gdata-commentable
  * @short_description: GData commentable interface
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-commentable.h
  *
  * #GDataCommentable is an interface which can be implemented by commentable objects: objects which support having comments added to them by users,
diff --git a/gdata/gdata-comparable.c b/gdata/gdata-comparable.c
index 9046e323..7817f37d 100644
--- a/gdata/gdata-comparable.c
+++ b/gdata/gdata-comparable.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-comparable
  * @short_description: GData comparable interface
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-comparable.h
  *
  * #GDataComparable is an interface which can be implemented by any object which needs to be compared to another object of the same type or of a
diff --git a/gdata/gdata-download-stream.c b/gdata/gdata-download-stream.c
index dde8f4a8..cddf8926 100644
--- a/gdata/gdata-download-stream.c
+++ b/gdata/gdata-download-stream.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-download-stream
  * @short_description: GData download stream object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-download-stream.h
  *
  * #GDataDownloadStream is a #GInputStream subclass to allow downloading of files from GData services with authorization from a #GDataService under
diff --git a/gdata/gdata-entry.c b/gdata/gdata-entry.c
index 1c189623..be242e59 100644
--- a/gdata/gdata-entry.c
+++ b/gdata/gdata-entry.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-entry
  * @short_description: GData entry object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-entry.h
  *
  * #GDataEntry represents a single object on the online service, such as a playlist, video or calendar event. It is a snapshot of the
diff --git a/gdata/gdata-feed.c b/gdata/gdata-feed.c
index fb0e58f1..f17174de 100644
--- a/gdata/gdata-feed.c
+++ b/gdata/gdata-feed.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-feed
  * @short_description: GData feed object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-feed.h
  *
  * #GDataFeed is a list of entries (#GDataEntry) returned as the result of a query to a #GDataService, or given as the input to another
diff --git a/gdata/gdata-goa-authorizer.c b/gdata/gdata-goa-authorizer.c
index fb0dfa0f..bcb1bcea 100644
--- a/gdata/gdata-goa-authorizer.c
+++ b/gdata/gdata-goa-authorizer.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-goa-authorizer
  * @short_description: GData GOA authorization interface
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-goa-authorizer.h
  *
  * #GDataGoaAuthorizer provides an implementation of the #GDataAuthorizer interface for authentication and authorization using GNOME Online Accounts
diff --git a/gdata/gdata-oauth1-authorizer.c b/gdata/gdata-oauth1-authorizer.c
index 2ec3beba..9f00b27f 100644
--- a/gdata/gdata-oauth1-authorizer.c
+++ b/gdata/gdata-oauth1-authorizer.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-oauth1-authorizer
  * @short_description: GData OAuth 1.0 authorization interface
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-oauth1-authorizer.h
  *
  * #GDataOAuth1Authorizer provides an implementation of the #GDataAuthorizer interface for authentication and authorization using the
diff --git a/gdata/gdata-oauth2-authorizer.c b/gdata/gdata-oauth2-authorizer.c
index 63feea79..3117b9d3 100644
--- a/gdata/gdata-oauth2-authorizer.c
+++ b/gdata/gdata-oauth2-authorizer.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-oauth2-authorizer
  * @short_description: GData OAuth 2.0 authorization interface
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-oauth2-authorizer.h
  *
  * #GDataOAuth2Authorizer provides an implementation of the #GDataAuthorizer
diff --git a/gdata/gdata-parsable.c b/gdata/gdata-parsable.c
index 357418a9..242f6b86 100644
--- a/gdata/gdata-parsable.c
+++ b/gdata/gdata-parsable.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-parsable
  * @short_description: GData parsable object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-parsable.h
  *
  * #GDataParsable is an abstract class allowing easy implementation of an extensible parser. It is primarily extended by #GDataFeed and #GDataEntry,
diff --git a/gdata/gdata-query.c b/gdata/gdata-query.c
index 814e77b8..bf42fe2b 100644
--- a/gdata/gdata-query.c
+++ b/gdata/gdata-query.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-query
  * @short_description: GData query object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-query.h
  *
  * #GDataQuery represents a collection of query parameters used in a series of queries on a #GDataService. It allows the query parameters to be
diff --git a/gdata/gdata-service.c b/gdata/gdata-service.c
index afcacd03..368e7000 100644
--- a/gdata/gdata-service.c
+++ b/gdata/gdata-service.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-service
  * @short_description: GData service object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-service.h
  *
  * #GDataService represents a GData API service, typically a website using the GData API, such as YouTube or Google Calendar. One
diff --git a/gdata/gdata-types.c b/gdata/gdata-types.c
index ecc6a9db..ba7fd143 100644
--- a/gdata/gdata-types.c
+++ b/gdata/gdata-types.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-types
  * @short_description: miscellaneous data types
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-types.h
  *
  * The structures here are used haphazardly across the library, describing
diff --git a/gdata/gdata-upload-stream.c b/gdata/gdata-upload-stream.c
index ce985457..87d8a319 100644
--- a/gdata/gdata-upload-stream.c
+++ b/gdata/gdata-upload-stream.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-upload-stream
  * @short_description: GData upload stream object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/gdata-upload-stream.h
  *
  * #GDataUploadStream is a #GOutputStream subclass to allow uploading of files from GData services with authorization from a #GDataService under
diff --git a/gdata/georss/gdata-georss-where.c b/gdata/georss/gdata-georss-where.c
index 66247c89..e03ab079 100644
--- a/gdata/georss/gdata-georss-where.c
+++ b/gdata/georss/gdata-georss-where.c
@@ -21,7 +21,7 @@
 /*
  * SECTION:gdata-georss-where
  * @short_description: GeoRSS where element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/georss/gdata-georss-where.h
  *
  * #GDataGeoRSSWhere represents a "where" element from the
diff --git a/gdata/media/gdata-media-category.c b/gdata/media/gdata-media-category.c
index 8f7fa417..66d4215d 100644
--- a/gdata/media/gdata-media-category.c
+++ b/gdata/media/gdata-media-category.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-media-category
  * @short_description: Media RSS category element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/media/gdata-media-category.h
  *
  * #GDataMediaCategory represents a "category" element from the
diff --git a/gdata/media/gdata-media-content.c b/gdata/media/gdata-media-content.c
index 9d6527b2..4180d2ea 100644
--- a/gdata/media/gdata-media-content.c
+++ b/gdata/media/gdata-media-content.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-media-content
  * @short_description: Media RSS content element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/media/gdata-media-content.h
  *
  * #GDataMediaContent represents a "content" element from the
diff --git a/gdata/media/gdata-media-credit.c b/gdata/media/gdata-media-credit.c
index 92a96619..896693b9 100644
--- a/gdata/media/gdata-media-credit.c
+++ b/gdata/media/gdata-media-credit.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-media-credit
  * @short_description: Media RSS credit element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/media/gdata-media-credit.h
  *
  * #GDataMediaCredit represents a "credit" element from the
diff --git a/gdata/media/gdata-media-group.c b/gdata/media/gdata-media-group.c
index 21b9e330..42d628bf 100644
--- a/gdata/media/gdata-media-group.c
+++ b/gdata/media/gdata-media-group.c
@@ -20,7 +20,7 @@
 /*
  * SECTION:gdata-media-group
  * @short_description: Media RSS group element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/media/gdata-media-group.h
  *
  * #GDataMediaGroup represents a "group" element from the
diff --git a/gdata/media/gdata-media-thumbnail.c b/gdata/media/gdata-media-thumbnail.c
index 13fa96e9..413e0e91 100644
--- a/gdata/media/gdata-media-thumbnail.c
+++ b/gdata/media/gdata-media-thumbnail.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-media-thumbnail
  * @short_description: Media RSS thumbnail element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/media/gdata-media-thumbnail.h
  *
  * #GDataMediaThumbnail represents a "thumbnail" element from the
diff --git a/gdata/services/calendar/gdata-calendar-calendar.c b/gdata/services/calendar/gdata-calendar-calendar.c
index dcfcbcfa..93f14534 100644
--- a/gdata/services/calendar/gdata-calendar-calendar.c
+++ b/gdata/services/calendar/gdata-calendar-calendar.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-calendar-calendar
  * @short_description: GData Calendar calendar object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/calendar/gdata-calendar-calendar.h
  *
  * #GDataCalendarCalendar is a subclass of #GDataEntry to represent a calendar from Google Calendar.
diff --git a/gdata/services/calendar/gdata-calendar-event.c b/gdata/services/calendar/gdata-calendar-event.c
index 498dc4d7..069bf338 100644
--- a/gdata/services/calendar/gdata-calendar-event.c
+++ b/gdata/services/calendar/gdata-calendar-event.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-calendar-event
  * @short_description: GData Calendar event object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/calendar/gdata-calendar-event.h
  *
  * #GDataCalendarEvent is a subclass of #GDataEntry to represent an event on a calendar from Google Calendar.
diff --git a/gdata/services/calendar/gdata-calendar-feed.c b/gdata/services/calendar/gdata-calendar-feed.c
index a6021b0f..ce0ca915 100644
--- a/gdata/services/calendar/gdata-calendar-feed.c
+++ b/gdata/services/calendar/gdata-calendar-feed.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-calendar-feed
  * @short_description: GData Calendar feed object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/calendar/gdata-calendar-feed.h
  *
  * #GDataCalendarFeed is a subclass of #GDataFeed to represent a results feed from Google Calendar. It adds a couple of
diff --git a/gdata/services/calendar/gdata-calendar-query.c b/gdata/services/calendar/gdata-calendar-query.c
index 5177e80e..85da9171 100644
--- a/gdata/services/calendar/gdata-calendar-query.c
+++ b/gdata/services/calendar/gdata-calendar-query.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-calendar-query
  * @short_description: GData Calendar query object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/calendar/gdata-calendar-query.h
  *
  * #GDataCalendarQuery represents a collection of query parameters specific to the Google Calendar service, which go above and beyond
diff --git a/gdata/services/calendar/gdata-calendar-service.c b/gdata/services/calendar/gdata-calendar-service.c
index 75a0ac15..e326eabd 100644
--- a/gdata/services/calendar/gdata-calendar-service.c
+++ b/gdata/services/calendar/gdata-calendar-service.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-calendar-service
  * @short_description: GData Calendar service object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/calendar/gdata-calendar-service.h
  *
  * #GDataCalendarService is a subclass of #GDataService for communicating with the GData API of Google Calendar. It supports querying
diff --git a/gdata/services/contacts/gdata-contacts-contact.c b/gdata/services/contacts/gdata-contacts-contact.c
index b76008ff..ae0a0006 100644
--- a/gdata/services/contacts/gdata-contacts-contact.c
+++ b/gdata/services/contacts/gdata-contacts-contact.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-contacts-contact
  * @short_description: GData Contacts contact object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/contacts/gdata-contacts-contact.h
  *
  * #GDataContactsContact is a subclass of #GDataEntry to represent a contact from a Google address book.
diff --git a/gdata/services/contacts/gdata-contacts-group.c b/gdata/services/contacts/gdata-contacts-group.c
index 711c3585..90522033 100644
--- a/gdata/services/contacts/gdata-contacts-group.c
+++ b/gdata/services/contacts/gdata-contacts-group.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-contacts-group
  * @short_description: GData Contacts group object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/contacts/gdata-contacts-group.h
  *
  * #GDataContactsGroup is a subclass of #GDataEntry to represent a group from a Google address book.
diff --git a/gdata/services/contacts/gdata-contacts-query.c b/gdata/services/contacts/gdata-contacts-query.c
index 639f7090..5156882d 100644
--- a/gdata/services/contacts/gdata-contacts-query.c
+++ b/gdata/services/contacts/gdata-contacts-query.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-contacts-query
  * @short_description: GData Contacts query object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/contacts/gdata-contacts-query.h
  *
  * #GDataContactsQuery represents a collection of query parameters specific to the Google Contacts service, which go above and beyond
diff --git a/gdata/services/contacts/gdata-contacts-service.c b/gdata/services/contacts/gdata-contacts-service.c
index 6bbcac3c..8fe77806 100644
--- a/gdata/services/contacts/gdata-contacts-service.c
+++ b/gdata/services/contacts/gdata-contacts-service.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-contacts-service
  * @short_description: GData Contacts service object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/contacts/gdata-contacts-service.h
  *
  * #GDataContactsService is a subclass of #GDataService for communicating with the GData API of Google Contacts. It supports querying
diff --git a/gdata/services/documents/gdata-documents-document.c b/gdata/services/documents/gdata-documents-document.c
index 71b918ff..81789748 100644
--- a/gdata/services/documents/gdata-documents-document.c
+++ b/gdata/services/documents/gdata-documents-document.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-documents-document
  * @short_description: GData documents document object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/documents/gdata-documents-document.h
  *
  * #GDataDocumentsDocument is a subclass of #GDataDocumentsEntry to represent an arbitrary Google Documents document (i.e. an arbitrary file which
diff --git a/gdata/services/documents/gdata-documents-drawing.c b/gdata/services/documents/gdata-documents-drawing.c
index 7f87b935..b9ce55f3 100644
--- a/gdata/services/documents/gdata-documents-drawing.c
+++ b/gdata/services/documents/gdata-documents-drawing.c
@@ -22,7 +22,7 @@
 /**
  * SECTION:gdata-documents-drawing
  * @short_description: GData Documents drawing object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/documents/gdata-documents-drawing.h
  *
  * #GDataDocumentsDrawing is a subclass of #GDataDocumentsDocument to represent a drawing document from Google Documents.
diff --git a/gdata/services/documents/gdata-documents-entry.c b/gdata/services/documents/gdata-documents-entry.c
index 6eaa211b..7277cc5e 100644
--- a/gdata/services/documents/gdata-documents-entry.c
+++ b/gdata/services/documents/gdata-documents-entry.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-documents-entry
  * @short_description: GData document object abstract class
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/documents/gdata-documents-entry.h
  *
  * #GDataDocumentsEntry is a subclass of #GDataEntry to represent a Google Documents entry, which is then further subclassed
diff --git a/gdata/services/documents/gdata-documents-feed.c b/gdata/services/documents/gdata-documents-feed.c
index 4f32db95..d2c67c20 100644
--- a/gdata/services/documents/gdata-documents-feed.c
+++ b/gdata/services/documents/gdata-documents-feed.c
@@ -21,7 +21,7 @@
 /**
  * SECTION:gdata-documents-feed
  * @short_description: GData documents feed object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/documents/gdata-documents-feed.h
  *
  * #GDataDocumentsFeed is a list of entries (#GDataDocumentsEntry subclasses) returned as the result of a query to a #GDataDocumentsService,
diff --git a/gdata/services/documents/gdata-documents-folder.c b/gdata/services/documents/gdata-documents-folder.c
index 94ab1e29..3f1cd766 100644
--- a/gdata/services/documents/gdata-documents-folder.c
+++ b/gdata/services/documents/gdata-documents-folder.c
@@ -21,7 +21,7 @@
 /**
  * SECTION:gdata-documents-folder
  * @short_description: GData documents folder object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/documents/gdata-documents-folder.h
  *
  * #GDataDocumentsFolder is a subclass of #GDataDocumentsEntry to represent a folder from Google Documents.
diff --git a/gdata/services/documents/gdata-documents-pdf.c b/gdata/services/documents/gdata-documents-pdf.c
index e4035a43..e3b08f09 100644
--- a/gdata/services/documents/gdata-documents-pdf.c
+++ b/gdata/services/documents/gdata-documents-pdf.c
@@ -22,7 +22,7 @@
 /**
  * SECTION:gdata-documents-pdf
  * @short_description: GData Documents pdf object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/documents/gdata-documents-pdf.h
  *
  * #GDataDocumentsPdf is a subclass of #GDataDocumentsDocument to represent a PDF document from Google Documents.
diff --git a/gdata/services/documents/gdata-documents-presentation.c b/gdata/services/documents/gdata-documents-presentation.c
index 47300818..f08d361c 100644
--- a/gdata/services/documents/gdata-documents-presentation.c
+++ b/gdata/services/documents/gdata-documents-presentation.c
@@ -21,7 +21,7 @@
 /**
  * SECTION:gdata-documents-presentation
  * @short_description: GData documents presentation object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/documents/gdata-documents-presentation.h
  *
  * #GDataDocumentsPresentation is a subclass of #GDataDocumentsDocument to represent a Google Documents presentation.
diff --git a/gdata/services/documents/gdata-documents-query.c b/gdata/services/documents/gdata-documents-query.c
index 3fdd6823..76f4dd21 100644
--- a/gdata/services/documents/gdata-documents-query.c
+++ b/gdata/services/documents/gdata-documents-query.c
@@ -21,7 +21,7 @@
 /**
  * SECTION:gdata-documents-query
  * @short_description: GData Documents query object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/documents/gdata-documents-query.h
  *
  * #GDataDocumentsQuery represents a collection of query parameters specific to the Google Documents service, which go above and beyond
diff --git a/gdata/services/documents/gdata-documents-service.c b/gdata/services/documents/gdata-documents-service.c
index 5e617d81..b2646545 100644
--- a/gdata/services/documents/gdata-documents-service.c
+++ b/gdata/services/documents/gdata-documents-service.c
@@ -21,7 +21,7 @@
 /**
  * SECTION:gdata-documents-service
  * @short_description: GData Documents service object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/documents/gdata-documents-service.h
  *
  * #GDataDocumentsService is a subclass of #GDataService for communicating with the GData API of Google Documents. It supports querying
diff --git a/gdata/services/documents/gdata-documents-spreadsheet.c b/gdata/services/documents/gdata-documents-spreadsheet.c
index 3af0f2d6..4cadc7d6 100644
--- a/gdata/services/documents/gdata-documents-spreadsheet.c
+++ b/gdata/services/documents/gdata-documents-spreadsheet.c
@@ -21,7 +21,7 @@
 /**
  * SECTION:gdata-documents-spreadsheet
  * @short_description: GData Documents spreadsheet object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/documents/gdata-documents-spreadsheet.h
  *
  * #GDataDocumentsSpreadsheet is a subclass of #GDataDocumentsDocument to represent a spreadsheet from Google Documents.
diff --git a/gdata/services/documents/gdata-documents-text.c b/gdata/services/documents/gdata-documents-text.c
index 532cc8c7..46c397ef 100644
--- a/gdata/services/documents/gdata-documents-text.c
+++ b/gdata/services/documents/gdata-documents-text.c
@@ -21,7 +21,7 @@
 /**
  * SECTION:gdata-documents-text
  * @short_description: GData Documents text object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/documents/gdata-documents-text.h
  *
  * #GDataDocumentsText is a subclass of #GDataDocumentsDocument to represent a text document from Google Documents.
diff --git a/gdata/services/documents/gdata-documents-upload-query.c b/gdata/services/documents/gdata-documents-upload-query.c
index a0198389..383db176 100644
--- a/gdata/services/documents/gdata-documents-upload-query.c
+++ b/gdata/services/documents/gdata-documents-upload-query.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-documents-upload-query
  * @short_description: GData Documents upload query object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/documents/gdata-documents-upload-query.h
  *
  * #GDataDocumentsUploadQuery is a collection of parameters for document uploads to Google Documents, allowing various options to be set when uploading
diff --git a/gdata/services/freebase/gdata-freebase-query.c b/gdata/services/freebase/gdata-freebase-query.c
index 175849e2..ca62f395 100644
--- a/gdata/services/freebase/gdata-freebase-query.c
+++ b/gdata/services/freebase/gdata-freebase-query.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-freebase-query
  * @short_description: GData Freebase query object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/freebase/gdata-freebase-query.h
  *
  * #GDataFreebaseQuery represents a MQL query specific to the Google Freebase service.
diff --git a/gdata/services/freebase/gdata-freebase-result.c b/gdata/services/freebase/gdata-freebase-result.c
index d82a6ab0..a147e994 100644
--- a/gdata/services/freebase/gdata-freebase-result.c
+++ b/gdata/services/freebase/gdata-freebase-result.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-freebase-result
  * @short_description: GData Freebase result object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/freebase/gdata-freebase-result.h
  *
  * #GDataFreebaseResult is a subclass of #GDataEntry to represent the result of a Google Freebase MQL query.
diff --git a/gdata/services/freebase/gdata-freebase-search-query.c b/gdata/services/freebase/gdata-freebase-search-query.c
index ec9ea873..affae23e 100644
--- a/gdata/services/freebase/gdata-freebase-search-query.c
+++ b/gdata/services/freebase/gdata-freebase-search-query.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-freebase-search-query
  * @short_description: GData Freebase query object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/freebase/gdata-freebase-query.h
  *
  * #GDataFreebaseQuery represents a collection of query parameters specific to the Google Freebase service.
diff --git a/gdata/services/freebase/gdata-freebase-search-result.c b/gdata/services/freebase/gdata-freebase-search-result.c
index 640c01d9..02f416cd 100644
--- a/gdata/services/freebase/gdata-freebase-search-result.c
+++ b/gdata/services/freebase/gdata-freebase-search-result.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-freebase-search-result
  * @short_description: GData Freebase search result object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/freebase/gdata-freebase-result.h
  *
  * #GDataFreebaseSearchResult is a subclass of #GDataEntry to represent the result of a Freebase search query.
diff --git a/gdata/services/freebase/gdata-freebase-service.c b/gdata/services/freebase/gdata-freebase-service.c
index 823d949e..9063a2cf 100644
--- a/gdata/services/freebase/gdata-freebase-service.c
+++ b/gdata/services/freebase/gdata-freebase-service.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-freebase-service
  * @short_description: GData Freebase service object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/freebase/gdata-freebase-service.h
  *
  * #GDataFreebaseService is a subclass of #GDataService for communicating with the Google Freebase API. It supports queries
diff --git a/gdata/services/freebase/gdata-freebase-topic-query.c b/gdata/services/freebase/gdata-freebase-topic-query.c
index 924fb031..b30d0562 100644
--- a/gdata/services/freebase/gdata-freebase-topic-query.c
+++ b/gdata/services/freebase/gdata-freebase-topic-query.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-freebase-topic-query
  * @short_description: GData Freebase topic query object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/freebase/gdata-freebase-topic-query.h
  *
  * #GDataFreebaseTopicQuery represents a Freebase topic query. The topic query happens on a single Freebase ID,
diff --git a/gdata/services/freebase/gdata-freebase-topic-result.c b/gdata/services/freebase/gdata-freebase-topic-result.c
index 5700d7c8..0426ce1d 100644
--- a/gdata/services/freebase/gdata-freebase-topic-result.c
+++ b/gdata/services/freebase/gdata-freebase-topic-result.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-freebase-topic-result
  * @short_description: GData Freebase topic result object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/freebase/gdata-freebase-topic-result.h
  *
  * #GDataFreebaseTopicResult is a subclass of #GDataFreebaseResult that contains all or a subset of the information
diff --git a/gdata/services/picasaweb/gdata-picasaweb-album.c b/gdata/services/picasaweb/gdata-picasaweb-album.c
index db9ba878..6c10f07f 100644
--- a/gdata/services/picasaweb/gdata-picasaweb-album.c
+++ b/gdata/services/picasaweb/gdata-picasaweb-album.c
@@ -21,7 +21,7 @@
 /**
  * SECTION:gdata-picasaweb-album
  * @short_description: GData PicasaWeb album object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/picasaweb/gdata-picasaweb-album.h
  *
  * #GDataPicasaWebAlbum is a subclass of #GDataEntry to represent an album from Google PicasaWeb.
diff --git a/gdata/services/picasaweb/gdata-picasaweb-comment.c b/gdata/services/picasaweb/gdata-picasaweb-comment.c
index c1449ae0..d43ea213 100644
--- a/gdata/services/picasaweb/gdata-picasaweb-comment.c
+++ b/gdata/services/picasaweb/gdata-picasaweb-comment.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-picasaweb-comment
  * @short_description: GData PicasaWeb comment object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/picasaweb/gdata-picasaweb-comment.h
  *
  * #GDataPicasaWebComment is a subclass of #GDataComment to represent a comment on a #GDataPicasaWebFile. It is returned by the #GDataCommentable
diff --git a/gdata/services/picasaweb/gdata-picasaweb-feed.c b/gdata/services/picasaweb/gdata-picasaweb-feed.c
index 749afd2f..f7a4ecc2 100644
--- a/gdata/services/picasaweb/gdata-picasaweb-feed.c
+++ b/gdata/services/picasaweb/gdata-picasaweb-feed.c
@@ -21,7 +21,7 @@
 /**
  * SECTION:gdata-picasaweb-feed
  * @short_description: GData PicasaWeb Feed object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/picasaweb/gdata-picasaweb-feed.h
  *
  * #GDataPicasaWebFeed is a subclass of #GDataFeed to represent properties for a PicasaWeb feed. It adds a couple of
diff --git a/gdata/services/picasaweb/gdata-picasaweb-file.c b/gdata/services/picasaweb/gdata-picasaweb-file.c
index 0f04cb9d..0cbf07a6 100644
--- a/gdata/services/picasaweb/gdata-picasaweb-file.c
+++ b/gdata/services/picasaweb/gdata-picasaweb-file.c
@@ -21,7 +21,7 @@
 /**
  * SECTION:gdata-picasaweb-file
  * @short_description: GData PicasaWeb file object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/picasaweb/gdata-picasaweb-file.h
  *
  * #GDataPicasaWebFile is a subclass of #GDataEntry to represent a file (photo or video) in an album on Google PicasaWeb.
diff --git a/gdata/services/picasaweb/gdata-picasaweb-query.c b/gdata/services/picasaweb/gdata-picasaweb-query.c
index 133ec486..0e8cce54 100644
--- a/gdata/services/picasaweb/gdata-picasaweb-query.c
+++ b/gdata/services/picasaweb/gdata-picasaweb-query.c
@@ -21,7 +21,7 @@
 /**
  * SECTION:gdata-picasaweb-query
  * @short_description: GData PicasaWeb query object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/picasaweb/gdata-picasaweb-query.h
  *
  * #GDataPicasaWebQuery represents a collection of query parameters specific to the Google PicasaWeb service, which go above and beyond
diff --git a/gdata/services/picasaweb/gdata-picasaweb-service.c b/gdata/services/picasaweb/gdata-picasaweb-service.c
index 681e20b5..67455a23 100644
--- a/gdata/services/picasaweb/gdata-picasaweb-service.c
+++ b/gdata/services/picasaweb/gdata-picasaweb-service.c
@@ -21,7 +21,7 @@
 /**
  * SECTION:gdata-picasaweb-service
  * @short_description: GData PicasaWeb service object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/picasaweb/gdata-picasaweb-service.h
  *
  * #GDataPicasaWebService is a subclass of #GDataService for communicating with the GData API of Google PicasaWeb. It supports querying for files
diff --git a/gdata/services/picasaweb/gdata-picasaweb-user.c b/gdata/services/picasaweb/gdata-picasaweb-user.c
index 91aebe9b..8062656f 100644
--- a/gdata/services/picasaweb/gdata-picasaweb-user.c
+++ b/gdata/services/picasaweb/gdata-picasaweb-user.c
@@ -21,7 +21,7 @@
 /**
  * SECTION:gdata-picasaweb-user
  * @short_description: GData PicasaWeb User object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/picasaweb/gdata-picasaweb-user.h
  *
  * #GDataPicasaWebUser is a subclass of #GDataEntry to represent properties for a PicasaWeb user. It adds a couple of
diff --git a/gdata/services/tasks/gdata-tasks-query.c b/gdata/services/tasks/gdata-tasks-query.c
index 8cb20faa..9e6dbd95 100644
--- a/gdata/services/tasks/gdata-tasks-query.c
+++ b/gdata/services/tasks/gdata-tasks-query.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-tasks-query
  * @short_description: GData Tasks query object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/tasks/gdata-tasks-query.h
  *
  * #GDataTasksQuery represents a collection of query parameters specific to the Google Tasks service, which go above and beyond
diff --git a/gdata/services/tasks/gdata-tasks-service.c b/gdata/services/tasks/gdata-tasks-service.c
index 2c68ca6f..c7f6204d 100644
--- a/gdata/services/tasks/gdata-tasks-service.c
+++ b/gdata/services/tasks/gdata-tasks-service.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-tasks-service
  * @short_description: GData Tasks service object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/tasks/gdata-tasks-service.h
  *
  * #GDataTasksService is a subclass of #GDataService for communicating with the API of Google Tasks. It supports querying
diff --git a/gdata/services/tasks/gdata-tasks-task.c b/gdata/services/tasks/gdata-tasks-task.c
index 29ed38ed..00490b89 100644
--- a/gdata/services/tasks/gdata-tasks-task.c
+++ b/gdata/services/tasks/gdata-tasks-task.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-tasks-task
  * @short_description: GData Tasks task object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/tasks/gdata-tasks-task.h
  *
  * #GDataTasksTask is a subclass of #GDataEntry to represent a task in a tasklist from Google Tasks.
diff --git a/gdata/services/tasks/gdata-tasks-tasklist.c b/gdata/services/tasks/gdata-tasks-tasklist.c
index 7c392d65..1690c232 100644
--- a/gdata/services/tasks/gdata-tasks-tasklist.c
+++ b/gdata/services/tasks/gdata-tasks-tasklist.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-tasks-tasklist
  * @short_description: GData Tasks tasklist object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/tasks/gdata-tasks-tasklist.h
  *
  * #GDataTasksTasklist is a subclass of #GDataEntry to represent a tasklist from Google Tasks.
diff --git a/gdata/services/youtube/gdata-youtube-category.c b/gdata/services/youtube/gdata-youtube-category.c
index f405c8f6..0387d02b 100644
--- a/gdata/services/youtube/gdata-youtube-category.c
+++ b/gdata/services/youtube/gdata-youtube-category.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-youtube-category
  * @short_description: YouTube category element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/youtube/gdata-youtube-category.h
  *
  * #GDataYouTubeCategory represents the YouTube-specific customizations to #GDataCategory. For more information,
diff --git a/gdata/services/youtube/gdata-youtube-comment.c b/gdata/services/youtube/gdata-youtube-comment.c
index 7c975fb2..f4996df1 100644
--- a/gdata/services/youtube/gdata-youtube-comment.c
+++ b/gdata/services/youtube/gdata-youtube-comment.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-youtube-comment
  * @short_description: GData YouTube comment object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/youtube/gdata-youtube-comment.h
  *
  * #GDataYouTubeComment is a subclass of #GDataComment to represent a comment on a #GDataYouTubeVideo. It is returned by the #GDataCommentable
diff --git a/gdata/services/youtube/gdata-youtube-content.c b/gdata/services/youtube/gdata-youtube-content.c
index 9a5d73f7..06c0aa0e 100644
--- a/gdata/services/youtube/gdata-youtube-content.c
+++ b/gdata/services/youtube/gdata-youtube-content.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-youtube-content
  * @short_description: YouTube content element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/youtube/gdata-youtube-content.h
  *
  * #GDataYouTubeContent represents the YouTube-specific customizations to #GDataMediaContent. For more information,
diff --git a/gdata/services/youtube/gdata-youtube-control.c b/gdata/services/youtube/gdata-youtube-control.c
index 243c4bc6..3436e1b2 100644
--- a/gdata/services/youtube/gdata-youtube-control.c
+++ b/gdata/services/youtube/gdata-youtube-control.c
@@ -20,7 +20,7 @@
 /*
  * SECTION:gdata-youtube-control
  * @short_description: Atom Publishing Protocol control element with YouTube-specific modifications
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/youtube/gdata-youtube-control.h
  *
  * #GDataYouTubeControl represents a "control" element from the
diff --git a/gdata/services/youtube/gdata-youtube-credit.c b/gdata/services/youtube/gdata-youtube-credit.c
index 69e5caa7..bfaf7edc 100644
--- a/gdata/services/youtube/gdata-youtube-credit.c
+++ b/gdata/services/youtube/gdata-youtube-credit.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-youtube-credit
  * @short_description: YouTube credit element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/youtube/gdata-youtube-credit.h
  *
  * #GDataYouTubeCredit represents the YouTube-specific customizations to #GDataMediaCredit. For more information,
diff --git a/gdata/services/youtube/gdata-youtube-group.c b/gdata/services/youtube/gdata-youtube-group.c
index 49a7e188..c75b4013 100644
--- a/gdata/services/youtube/gdata-youtube-group.c
+++ b/gdata/services/youtube/gdata-youtube-group.c
@@ -20,7 +20,7 @@
 /*
  * SECTION:gdata-youtube-group
  * @short_description: YouTube group element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/youtube/gdata-youtube-group.h
  *
  * #GDataYouTubeGroup represents the YouTube-specific customizations to #GDataMediaGroup. For more information,
diff --git a/gdata/services/youtube/gdata-youtube-query.c b/gdata/services/youtube/gdata-youtube-query.c
index 6e348e5d..bf95730a 100644
--- a/gdata/services/youtube/gdata-youtube-query.c
+++ b/gdata/services/youtube/gdata-youtube-query.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-youtube-query
  * @short_description: GData YouTube query object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/youtube/gdata-youtube-query.h
  *
  * #GDataYouTubeQuery represents a collection of query parameters specific to the YouTube service, which go above and beyond
diff --git a/gdata/services/youtube/gdata-youtube-service.c b/gdata/services/youtube/gdata-youtube-service.c
index 15c7afb4..e1210ae4 100644
--- a/gdata/services/youtube/gdata-youtube-service.c
+++ b/gdata/services/youtube/gdata-youtube-service.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-youtube-service
  * @short_description: GData YouTube service object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/youtube/gdata-youtube-service.h
  *
  * #GDataYouTubeService is a subclass of #GDataService for communicating with the GData API of YouTube. It supports querying for and
diff --git a/gdata/services/youtube/gdata-youtube-state.c b/gdata/services/youtube/gdata-youtube-state.c
index 6df4da5c..e2da9bb5 100644
--- a/gdata/services/youtube/gdata-youtube-state.c
+++ b/gdata/services/youtube/gdata-youtube-state.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-youtube-state
  * @short_description: YouTube state element
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/youtube/gdata-youtube-state.h
  *
  * #GDataYouTubeState represents a "state" element from the
diff --git a/gdata/services/youtube/gdata-youtube-video.c b/gdata/services/youtube/gdata-youtube-video.c
index 2d5e7a2c..e93751da 100644
--- a/gdata/services/youtube/gdata-youtube-video.c
+++ b/gdata/services/youtube/gdata-youtube-video.c
@@ -20,7 +20,7 @@
 /**
  * SECTION:gdata-youtube-video
  * @short_description: GData YouTube video object
- * @stability: Unstable
+ * @stability: Stable
  * @include: gdata/services/youtube/gdata-youtube-video.h
  *
  * #GDataYouTubeVideo is a subclass of #GDataEntry to represent a single video on YouTube, either when uploading or querying.
diff --git a/gdata/tests/gdata-dummy-authorizer.c b/gdata/tests/gdata-dummy-authorizer.c
index 3b4e76c5..5a73cc2b 100644
--- a/gdata/tests/gdata-dummy-authorizer.c
+++ b/gdata/tests/gdata-dummy-authorizer.c
@@ -20,7 +20,7 @@
 /*
  * SECTION:gdata-dummy-authorizer
  * @short_description: GData dummy authorization interface
- * @stability: Unstable
+ * @stability: Stable
  * @include: tests/gdata-dummy-authorizer.h
  *
  * #GDataDummyAuthorizer is a dummy #GDataAuthorizer implementation intended for
-- 
cgit v1.2.1