[evolution-data-server] Add "Since: 2.28" tags to the API documentation.

From: Matthew Barnes <mbarnes src gnome org>
To: commits-list gnome org
Cc:
Subject: [evolution-data-server] Add "Since: 2.28" tags to the API documentation.
Date: Sat, 13 Mar 2010 23:55:21 +0000 (UTC)
commit 9e27380474601f098e67301ad6090ed631b18e34
Author: Matthew Barnes <mbarnes redhat com>
Date:   Sat Mar 13 18:53:26 2010 -0500

    Add "Since: 2.28" tags to the API documentation.
    
    Also create "Index of new symbols in 2.28" index pages in the table
    of contents pages.

 calendar/libecal/e-cal-component.c                 |   10 +
 calendar/libecal/e-cal-system-timezone.c           |    2 +
 calendar/libecal/e-cal-util.c                      |    4 +
 calendar/libedata-cal/e-cal-backend-cache.c        |    5 +
 calendar/libedata-cal/e-cal-backend-file-store.c   |    5 +
 calendar/libedata-cal/e-cal-backend-file-store.h   |    5 +
 calendar/libedata-cal/e-cal-backend-store.c        |  100 ++++++++++
 calendar/libedata-cal/e-cal-backend-store.h        |    5 +
 calendar/libedata-cal/e-cal-backend.c              |    2 +
 camel/camel-db.c                                   |   15 ++
 camel/camel-folder-summary.c                       |   18 ++-
 camel/camel-folder-summary.h                       |    7 +
 camel/camel-folder.c                               |    2 +
 camel/camel-mime-message.c                         |    2 +
 camel/camel-mime-part-utils.c                      |    5 +
 camel/camel-store.h                                |   14 +-
 camel/providers/imapx/camel-imapx-tokenise.h       |    5 +-
 .../addressbook/libebook/libebook-docs.sgml        |    4 +
 .../libedata-book/libedata-book-docs.sgml          |    4 +
 docs/reference/calendar/libecal/libecal-docs.sgml  |    4 +
 .../calendar/libedata-cal/libedata-cal-docs.sgml   |    6 +
 .../libedata-cal/libedata-cal-sections.txt         |   10 +-
 .../calendar/libedata-cal/tmpl/e-cal-backend.sgml  |   44 +++++
 .../libedata-cal/tmpl/e-data-cal-common.sgml       |  194 --------------------
 .../calendar/libedata-cal/tmpl/e-data-cal.sgml     |   37 ++++
 docs/reference/camel/camel-docs.sgml               |    4 +
 docs/reference/libebackend/libebackend-docs.xml    |    4 +
 .../libedataserver/libedataserver-docs.sgml        |    4 +
 .../libedataserverui/libedataserverui-docs.sgml    |    4 +
 libedataserver/e-data-server-util.c                |    2 +
 libedataserver/e-sexp.c                            |    8 +-
 libedataserver/e-source-list.c                     |   12 ++
 libedataserverui/e-source-selector-dialog.c        |    2 +
 33 files changed, 342 insertions(+), 207 deletions(-)
---
diff --git a/calendar/libecal/e-cal-component.c b/calendar/libecal/e-cal-component.c
index 0caf9b5..3230b0e 100644
--- a/calendar/libecal/e-cal-component.c
+++ b/calendar/libecal/e-cal-component.c
@@ -3390,6 +3390,11 @@ e_cal_component_get_percent (ECalComponent *comp, gint **percent)
 		*percent = NULL;
 }
 
+/**
+ * e_cal_component_set_percent_as_int:
+ *
+ * Since: 2.28
+ **/
 void
 e_cal_component_set_percent_as_int (ECalComponent *comp, gint percent)
 {
@@ -3422,6 +3427,11 @@ e_cal_component_set_percent_as_int (ECalComponent *comp, gint percent)
 
 }
 
+/**
+ * e_cal_component_get_percent_as_int:
+ *
+ * Since: 2.28
+ **/
 gint
 e_cal_component_get_percent_as_int (ECalComponent *comp)
 {
diff --git a/calendar/libecal/e-cal-system-timezone.c b/calendar/libecal/e-cal-system-timezone.c
index b6b81ef..2a13622 100644
--- a/calendar/libecal/e-cal-system-timezone.c
+++ b/calendar/libecal/e-cal-system-timezone.c
@@ -434,6 +434,8 @@ system_timezone_find (void)
  *
  * Returns system timezone location string, NULL on an error.
  * Returned pointer should be freed with g_free().
+ *
+ * Since: 2.28
  **/
 gchar *
 e_cal_system_timezone_get_location (void)
diff --git a/calendar/libecal/e-cal-util.c b/calendar/libecal/e-cal-util.c
index da32e2b..d645e1a 100644
--- a/calendar/libecal/e-cal-util.c
+++ b/calendar/libecal/e-cal-util.c
@@ -1145,6 +1145,8 @@ e_cal_util_remove_instances (icalcomponent *icalcomp,
  *
  * Returns system timezone location string, NULL on an error.
  * Returned pointer should be freed with g_free().
+ *
+ * Since: 2.28
  **/
 gchar *
 e_cal_util_get_system_timezone_location (void)
@@ -1157,6 +1159,8 @@ e_cal_util_get_system_timezone_location (void)
  *
  * Returns icaltimezone object of the system timezone. NULL on an error.
  * Returned pointer is part of the built-in timezones, thus do not free it.
+ *
+ * Since: 2.28
  **/
 icaltimezone *
 e_cal_util_get_system_timezone (void)
diff --git a/calendar/libedata-cal/e-cal-backend-cache.c b/calendar/libedata-cal/e-cal-backend-cache.c
index 0ac3dd8..ee63ac0 100644
--- a/calendar/libedata-cal/e-cal-backend-cache.c
+++ b/calendar/libedata-cal/e-cal-backend-cache.c
@@ -857,6 +857,11 @@ e_cal_backend_cache_get_key_value (ECalBackendCache *cache, const gchar *key)
 	return value;
 }
 
+/**
+ * e_cal_backend_cache_remove:
+ *
+ * Since: 2.28
+ **/
 gboolean
 e_cal_backend_cache_remove (const gchar *uri, ECalSourceType source_type)
 {
diff --git a/calendar/libedata-cal/e-cal-backend-file-store.c b/calendar/libedata-cal/e-cal-backend-file-store.c
index 0272078..b9181f6 100644
--- a/calendar/libedata-cal/e-cal-backend-file-store.c
+++ b/calendar/libedata-cal/e-cal-backend-file-store.c
@@ -938,6 +938,11 @@ e_cal_backend_file_store_init (ECalBackendFileStore *self)
 	priv->save_timeout_id = 0;
 }
 
+/**
+ * e_cal_backend_file_store_new:
+ *
+ * Since: 2.28
+ **/
 ECalBackendFileStore*
 e_cal_backend_file_store_new (const gchar *uri, ECalSourceType source_type)
 {
diff --git a/calendar/libedata-cal/e-cal-backend-file-store.h b/calendar/libedata-cal/e-cal-backend-file-store.h
index f105b44..40daff2 100644
--- a/calendar/libedata-cal/e-cal-backend-file-store.h
+++ b/calendar/libedata-cal/e-cal-backend-file-store.h
@@ -46,6 +46,11 @@ G_BEGIN_DECLS
 
 typedef struct _ECalBackendFileStorePrivate ECalBackendFileStorePrivate;
 
+/**
+ * ECalBackendFileStore:
+ *
+ * Since: 2.28
+ **/
 typedef struct {
 	ECalBackendStore parent;
 	ECalBackendFileStorePrivate *priv;
diff --git a/calendar/libedata-cal/e-cal-backend-store.c b/calendar/libedata-cal/e-cal-backend-store.c
index ad88478..cf81e54 100644
--- a/calendar/libedata-cal/e-cal-backend-store.c
+++ b/calendar/libedata-cal/e-cal-backend-store.c
@@ -218,6 +218,11 @@ e_cal_backend_store_init (ECalBackendStore *store)
 	priv->loaded = FALSE;
 }
 
+/**
+ * e_cal_backend_store_get_path:
+ *
+ * Since: 2.28
+ **/
 const gchar *
 e_cal_backend_store_get_path (ECalBackendStore *store)
 {
@@ -231,6 +236,11 @@ e_cal_backend_store_get_path (ECalBackendStore *store)
 	return priv->path;
 }
 
+/**
+ * e_cal_backend_store_load:
+ *
+ * Since: 2.28
+ **/
 gboolean
 e_cal_backend_store_load (ECalBackendStore *store)
 {
@@ -249,6 +259,11 @@ e_cal_backend_store_load (ECalBackendStore *store)
 	return priv->loaded;
 }
 
+/**
+ * e_cal_backend_store_remove:
+ *
+ * Since: 2.28
+ **/
 gboolean
 e_cal_backend_store_remove (ECalBackendStore *store)
 {
@@ -258,6 +273,11 @@ e_cal_backend_store_remove (ECalBackendStore *store)
 	return (E_CAL_BACKEND_STORE_GET_CLASS (store))->remove (store);
 }
 
+/**
+ * e_cal_backend_store_clean:
+ *
+ * Since: 2.28
+ **/
 gboolean
 e_cal_backend_store_clean (ECalBackendStore *store)
 {
@@ -267,6 +287,11 @@ e_cal_backend_store_clean (ECalBackendStore *store)
 	return (E_CAL_BACKEND_STORE_GET_CLASS (store))->clean (store);
 }
 
+/**
+ * e_cal_backend_store_get_component:
+ *
+ * Since: 2.28
+ **/
 ECalComponent *
 e_cal_backend_store_get_component (ECalBackendStore *store, const gchar *uid, const gchar *rid)
 {
@@ -277,6 +302,11 @@ e_cal_backend_store_get_component (ECalBackendStore *store, const gchar *uid, co
 	return (E_CAL_BACKEND_STORE_GET_CLASS (store))->get_component (store, uid, rid);
 }
 
+/**
+ * e_cal_backend_store_has_component:
+ *
+ * Since: 2.28
+ **/
 gboolean
 e_cal_backend_store_has_component (ECalBackendStore *store, const gchar *uid, const gchar *rid)
 {
@@ -287,6 +317,11 @@ e_cal_backend_store_has_component (ECalBackendStore *store, const gchar *uid, co
 	return (E_CAL_BACKEND_STORE_GET_CLASS (store))->has_component (store, uid, rid);
 }
 
+/**
+ * e_cal_backend_store_put_component:
+ *
+ * Since: 2.28
+ **/
 gboolean
 e_cal_backend_store_put_component (ECalBackendStore *store, ECalComponent *comp)
 {
@@ -298,6 +333,11 @@ e_cal_backend_store_put_component (ECalBackendStore *store, ECalComponent *comp)
 	return (E_CAL_BACKEND_STORE_GET_CLASS (store))->put_component (store, comp);
 }
 
+/**
+ * e_cal_backend_store_remove_component:
+ *
+ * Since: 2.28
+ **/
 gboolean
 e_cal_backend_store_remove_component (ECalBackendStore *store, const gchar *uid, const gchar *rid)
 {
@@ -308,6 +348,11 @@ e_cal_backend_store_remove_component (ECalBackendStore *store, const gchar *uid,
 	return (E_CAL_BACKEND_STORE_GET_CLASS (store))->remove_component (store, uid, rid);
 }
 
+/**
+ * e_cal_backend_store_get_timezone:
+ *
+ * Since: 2.28
+ **/
 const icaltimezone *
 e_cal_backend_store_get_timezone (ECalBackendStore *store, const gchar *tzid)
 {
@@ -318,6 +363,11 @@ e_cal_backend_store_get_timezone (ECalBackendStore *store, const gchar *tzid)
 	return (E_CAL_BACKEND_STORE_GET_CLASS (store))->get_timezone (store, tzid);
 }
 
+/**
+ * e_cal_backend_store_put_timezone:
+ *
+ * Since: 2.28
+ **/
 gboolean
 e_cal_backend_store_put_timezone (ECalBackendStore *store, const icaltimezone *zone)
 {
@@ -328,6 +378,11 @@ e_cal_backend_store_put_timezone (ECalBackendStore *store, const icaltimezone *z
 	return (E_CAL_BACKEND_STORE_GET_CLASS (store))->put_timezone (store, zone);
 }
 
+/**
+ * e_cal_backend_store_remove_timezone:
+ *
+ * Since: 2.28
+ **/
 gboolean
 e_cal_backend_store_remove_timezone (ECalBackendStore *store, const gchar *tzid)
 {
@@ -338,6 +393,11 @@ e_cal_backend_store_remove_timezone (ECalBackendStore *store, const gchar *tzid)
 	return (E_CAL_BACKEND_STORE_GET_CLASS (store))->remove_timezone (store, tzid);
 }
 
+/**
+ * e_cal_backend_store_get_default_timezone:
+ *
+ * Since: 2.28
+ **/
 const icaltimezone *
 e_cal_backend_store_get_default_timezone (ECalBackendStore *store)
 {
@@ -347,6 +407,11 @@ e_cal_backend_store_get_default_timezone (ECalBackendStore *store)
 	return (E_CAL_BACKEND_STORE_GET_CLASS (store))->get_default_timezone (store);
 }
 
+/**
+ * e_cal_backend_store_set_default_timezone:
+ *
+ * Since: 2.28
+ **/
 gboolean
 e_cal_backend_store_set_default_timezone (ECalBackendStore *store, const icaltimezone *zone)
 {
@@ -357,6 +422,11 @@ e_cal_backend_store_set_default_timezone (ECalBackendStore *store, const icaltim
 	return (E_CAL_BACKEND_STORE_GET_CLASS (store))->set_default_timezone (store, zone);
 }
 
+/**
+ * e_cal_backend_store_get_components_by_uid:
+ *
+ * Since: 2.28
+ **/
 GSList *
 e_cal_backend_store_get_components_by_uid (ECalBackendStore *store, const gchar *uid)
 {
@@ -367,6 +437,11 @@ e_cal_backend_store_get_components_by_uid (ECalBackendStore *store, const gchar
 	return (E_CAL_BACKEND_STORE_GET_CLASS (store))->get_components_by_uid (store, uid);
 }
 
+/**
+ * e_cal_backend_store_get_components:
+ *
+ * Since: 2.28
+ **/
 GSList *
 e_cal_backend_store_get_components (ECalBackendStore *store)
 {
@@ -376,6 +451,11 @@ e_cal_backend_store_get_components (ECalBackendStore *store)
 	return (E_CAL_BACKEND_STORE_GET_CLASS (store))->get_components (store);
 }
 
+/**
+ * e_cal_backend_store_get_component_ids:
+ *
+ * Since: 2.28
+ **/
 GSList *
 e_cal_backend_store_get_component_ids (ECalBackendStore *store)
 {
@@ -385,6 +465,11 @@ e_cal_backend_store_get_component_ids (ECalBackendStore *store)
 	return (E_CAL_BACKEND_STORE_GET_CLASS (store))->get_component_ids (store);
 }
 
+/**
+ * e_cal_backend_store_get_key_value:
+ *
+ * Since: 2.28
+ **/
 const gchar *
 e_cal_backend_store_get_key_value (ECalBackendStore *store, const gchar *key)
 {
@@ -395,6 +480,11 @@ e_cal_backend_store_get_key_value (ECalBackendStore *store, const gchar *key)
 	return (E_CAL_BACKEND_STORE_GET_CLASS (store))->get_key_value (store, key);
 }
 
+/**
+ * e_cal_backend_store_put_key_value:
+ *
+ * Since: 2.28
+ **/
 gboolean
 e_cal_backend_store_put_key_value (ECalBackendStore *store, const gchar *key, const gchar *value)
 {
@@ -405,6 +495,11 @@ e_cal_backend_store_put_key_value (ECalBackendStore *store, const gchar *key, co
 	return (E_CAL_BACKEND_STORE_GET_CLASS (store))->put_key_value (store, key, value);
 }
 
+/**
+ * e_cal_backend_store_thaw_changes:
+ *
+ * Since: 2.28
+ **/
 void
 e_cal_backend_store_thaw_changes (ECalBackendStore *store)
 {
@@ -414,6 +509,11 @@ e_cal_backend_store_thaw_changes (ECalBackendStore *store)
 	(E_CAL_BACKEND_STORE_GET_CLASS (store))->thaw_changes (store);
 }
 
+/**
+ * e_cal_backend_store_freeze_changes:
+ *
+ * Since: 2.28
+ **/
 void
 e_cal_backend_store_freeze_changes (ECalBackendStore *store)
 {
diff --git a/calendar/libedata-cal/e-cal-backend-store.h b/calendar/libedata-cal/e-cal-backend-store.h
index f982a7e..290d572 100644
--- a/calendar/libedata-cal/e-cal-backend-store.h
+++ b/calendar/libedata-cal/e-cal-backend-store.h
@@ -47,6 +47,11 @@ G_BEGIN_DECLS
 
 typedef struct _ECalBackendStorePrivate ECalBackendStorePrivate;
 
+/**
+ * ECalBackendStore:
+ *
+ * Since: 2.28
+ **/
 typedef struct {
 	GObject parent;
 	ECalBackendStorePrivate *priv;
diff --git a/calendar/libedata-cal/e-cal-backend.c b/calendar/libedata-cal/e-cal-backend.c
index 0d9c8ec..60b3580 100644
--- a/calendar/libedata-cal/e-cal-backend.c
+++ b/calendar/libedata-cal/e-cal-backend.c
@@ -1503,6 +1503,8 @@ e_cal_backend_notify_error (ECalBackend *backend, const gchar *message)
  *
  * Empties backend's cache with all notifications and so on, thus all listening
  * will know there is nothing in this backend.
+ *
+ * Since: 2.28
  **/
 void
 e_cal_backend_empty_cache (ECalBackend *backend, ECalBackendCache *cache)
diff --git a/camel/camel-db.c b/camel/camel-db.c
index b3b1191..2b1bc7b 100644
--- a/camel/camel-db.c
+++ b/camel/camel-db.c
@@ -1012,6 +1012,11 @@ read_preview_callback (gpointer ref, gint ncol, gchar ** cols, gchar ** name)
 	return 0;
 }
 
+/**
+ * camel_db_get_folder_preview:
+ *
+ * Since: 2.28
+ **/
 GHashTable *
 camel_db_get_folder_preview (CamelDB *db, gchar *folder_name, CamelException *ex)
 {
@@ -1032,6 +1037,11 @@ camel_db_get_folder_preview (CamelDB *db, gchar *folder_name, CamelException *ex
 	 return hash;
 }
 
+/**
+ * camel_db_write_preview_record:
+ *
+ * Since: 2.28
+ **/
 gint
 camel_db_write_preview_record (CamelDB *db, gchar *folder_name, const gchar *uid, const gchar *msg, CamelException *ex)
 {
@@ -1254,6 +1264,11 @@ camel_db_migrate_folder_recreate (CamelDB *cdb, const gchar *folder_name, gint v
 	return ret;
 }
 
+/**
+ * camel_db_reset_folder_version:
+ *
+ * Since: 2.28
+ **/
 gint
 camel_db_reset_folder_version (CamelDB *cdb, const gchar *folder_name, gint reset_version, CamelException *ex)
 {
diff --git a/camel/camel-folder-summary.c b/camel/camel-folder-summary.c
index ee58a59..cca3ef3 100644
--- a/camel/camel-folder-summary.c
+++ b/camel/camel-folder-summary.c
@@ -1009,6 +1009,11 @@ camel_folder_summary_reload_from_db (CamelFolderSummary *s, CamelException *ex)
 	return ret == 0 ? 0 : -1;
 }
 
+/**
+ * camel_folder_summary_add_preview:
+ *
+ * Since: 2.28
+ **/
 void
 camel_folder_summary_add_preview (CamelFolderSummary *s, CamelMessageInfo *info)
 {
@@ -1025,6 +1030,8 @@ camel_folder_summary_add_preview (CamelFolderSummary *s, CamelMessageInfo *info)
  * @ex: #CamelException object.
  *
  * Loads all infos into memory, if they are not yet.
+ *
+ * Since: 2.28
  **/
 void
 camel_folder_summary_ensure_infos_loaded (CamelFolderSummary *s, gint at_least, CamelException *ex)
@@ -5037,13 +5044,22 @@ camel_folder_summary_class_init (CamelFolderSummaryClass *klass)
 
 }
 
-/* Utils */
+/**
+ * camel_folder_summary_set_need_preview:
+ *
+ * Since: 2.28
+ **/
 void
 camel_folder_summary_set_need_preview (CamelFolderSummary *summary, gboolean preview)
 {
 	_PRIVATE(summary)->need_preview = preview;
 }
 
+/**
+ * camel_folder_summary_get_need_preview:
+ *
+ * Since: 2.28
+ **/
 gboolean
 camel_folder_summary_get_need_preview (CamelFolderSummary *summary)
 {
diff --git a/camel/camel-folder-summary.h b/camel/camel-folder-summary.h
index a8cf162..463aeac 100644
--- a/camel/camel-folder-summary.h
+++ b/camel/camel-folder-summary.h
@@ -446,7 +446,14 @@ time_t camel_message_info_time(const CamelMessageInfo *mi, gint id);
 #define camel_message_info_uid(mi) ((const gchar *)((const CamelMessageInfo *)mi)->uid)
 
 #define camel_message_info_subject(mi) ((const gchar *)camel_message_info_ptr((const CamelMessageInfo *)mi, CAMEL_MESSAGE_INFO_SUBJECT))
+
+/**
+ * camel_message_info_preview:
+ *
+ * Since: 2.28
+ **/
 #define camel_message_info_preview(mi) ((const gchar *)camel_message_info_ptr((const CamelMessageInfo *)mi, CAMEL_MESSAGE_INFO_PREVIEW))
+
 #define camel_message_info_from(mi) ((const gchar *)camel_message_info_ptr((const CamelMessageInfo *)mi, CAMEL_MESSAGE_INFO_FROM))
 #define camel_message_info_to(mi) ((const gchar *)camel_message_info_ptr((const CamelMessageInfo *)mi, CAMEL_MESSAGE_INFO_TO))
 #define camel_message_info_cc(mi) ((const gchar *)camel_message_info_ptr((const CamelMessageInfo *)mi, CAMEL_MESSAGE_INFO_CC))
diff --git a/camel/camel-folder.c b/camel/camel-folder.c
index 4a8a02f..879e18c 100644
--- a/camel/camel-folder.c
+++ b/camel/camel-folder.c
@@ -1272,6 +1272,8 @@ cmp_uids (CamelFolder *folder, const gchar *uid1, const gchar *uid2)
  *
  * Note that the default compare function expects a decimal number at the beginning of a uid,
  * thus if provider uses different uid values, then it should subclass this function.
+ *
+ * Since: 2.28
  **/
 gint
 camel_folder_cmp_uids (CamelFolder *folder, const gchar *uid1, const gchar *uid2)
diff --git a/camel/camel-mime-message.c b/camel/camel-mime-message.c
index ca5e336..dab56f6 100644
--- a/camel/camel-mime-message.c
+++ b/camel/camel-mime-message.c
@@ -1187,6 +1187,8 @@ find_attachment (CamelMimeMessage *msg, CamelMimePart *part, gpointer data)
  * @message: a #CamelMimeMessage object
  *
  * Returns whether message contains at least one attachment part.
+ *
+ * Since: 2.28
  **/
 gboolean
 camel_mime_message_has_attachment (CamelMimeMessage *message)
diff --git a/camel/camel-mime-part-utils.c b/camel/camel-mime-part-utils.c
index ff27bf1..c761c32 100644
--- a/camel/camel-mime-part-utils.c
+++ b/camel/camel-mime-part-utils.c
@@ -139,6 +139,11 @@ camel_mime_part_construct_content_from_parser (CamelMimePart *dw, CamelMimeParse
 	g_free (encoding);
 }
 
+/**
+ * camel_mime_message_build_preview:
+ *
+ * Since: 2.28
+ **/
 gboolean
 camel_mime_message_build_preview (CamelMimePart *msg, CamelMessageInfo *info)
 {
diff --git a/camel/camel-store.h b/camel/camel-store.h
index abf8cfd..76347bf 100644
--- a/camel/camel-store.h
+++ b/camel/camel-store.h
@@ -149,10 +149,16 @@ struct _CamelStore {
 #define CAMEL_STORE_FOLDER_INFO_RECURSIVE  (1 << 1)
 #define CAMEL_STORE_FOLDER_INFO_SUBSCRIBED (1 << 2)
 #define CAMEL_STORE_FOLDER_INFO_NO_VIRTUAL (1 << 3)  /* don't include vTrash/vJunk folders */
-/* Fetch only the subscription list. Clients should use this */
-/* flag for requesting the list of folders available for  */
-/* subscription. Used in Exchange / IMAP  connectors for public */
-/* folder fetching */
+/**
+ * CAMEL_STORE_FOLDER_INFO_SUBSCRIPTION_LIST:
+ *
+ * Fetch only the subscription list. Clients should use this
+ * flag for requesting the list of folders available for
+ * subscription. Used in Exchange / IMAP connectors for public
+ * folder fetching.
+ *
+ * Since: 2.28
+ **/
 #define CAMEL_STORE_FOLDER_INFO_SUBSCRIPTION_LIST (1 << 4)
 
 typedef struct {
diff --git a/camel/providers/imapx/camel-imapx-tokenise.h b/camel/providers/imapx/camel-imapx-tokenise.h
index be70a54..09ae312 100644
--- a/camel/providers/imapx/camel-imapx-tokenise.h
+++ b/camel/providers/imapx/camel-imapx-tokenise.h
@@ -1,4 +1,4 @@
-/* ANSI-C code produced by gperf version 3.0.2 */
+/* ANSI-C code produced by gperf version 3.0.3 */
 /* Command-line: /usr/bin/gperf -H imapx_hash -N imapx_tokenise_struct -L ANSI-C -o -t -k'1,$' camel-imapx-tokens.txt  */
 
 #if !((' ' == 32) && ('!' == 33) && ('"' == 34) && ('#' == 35) \
@@ -82,6 +82,9 @@ imapx_hash (register const char *str, register unsigned int len)
 
 #ifdef __GNUC__
 __inline
+#ifdef __GNUC_STDC_INLINE__
+__attribute__ ((__gnu_inline__))
+#endif
 #endif
 struct _imapx_keyword *
 imapx_tokenise_struct (register const char *str, register unsigned int len)
diff --git a/docs/reference/addressbook/libebook/libebook-docs.sgml b/docs/reference/addressbook/libebook/libebook-docs.sgml
index d194713..27f60e7 100644
--- a/docs/reference/addressbook/libebook/libebook-docs.sgml
+++ b/docs/reference/addressbook/libebook/libebook-docs.sgml
@@ -29,4 +29,8 @@
     <title>Index of new symbols in 2.30</title>
     <xi:include href="xml/api-index-2.30.xml"><xi:fallback /></xi:include>
   </index>
+  <index id="api-index-2.28" role="2.28">
+    <title>Index of new symbols in 2.28</title>
+    <xi:include href="xml/api-index-2.28.xml"><xi:fallback /></xi:include>
+  </index>
 </book>
diff --git a/docs/reference/addressbook/libedata-book/libedata-book-docs.sgml b/docs/reference/addressbook/libedata-book/libedata-book-docs.sgml
index d50ef16..7c637c3 100644
--- a/docs/reference/addressbook/libedata-book/libedata-book-docs.sgml
+++ b/docs/reference/addressbook/libedata-book/libedata-book-docs.sgml
@@ -31,4 +31,8 @@
     <title>Index of new symbols in 2.30</title>
     <xi:include href="xml/api-index-2.30.xml"><xi:fallback /></xi:include>
   </index>
+  <index id="api-index-2.28" role="2.28">
+    <title>Index of new symbols in 2.28</title>
+    <xi:include href="xml/api-index-2.28.xml"><xi:fallback /></xi:include>
+  </index>
 </book>
diff --git a/docs/reference/calendar/libecal/libecal-docs.sgml b/docs/reference/calendar/libecal/libecal-docs.sgml
index 1249b5c..4a66260 100644
--- a/docs/reference/calendar/libecal/libecal-docs.sgml
+++ b/docs/reference/calendar/libecal/libecal-docs.sgml
@@ -29,4 +29,8 @@
     <title>Index of new symbols in 2.30</title>
     <xi:include href="xml/api-index-2.30.xml"><xi:fallback /></xi:include>
   </index>
+  <index id="api-index-2.28" role="2.28">
+    <title>Index of new symbols in 2.28</title>
+    <xi:include href="xml/api-index-2.28.xml"><xi:fallback /></xi:include>
+  </index>
 </book>
diff --git a/docs/reference/calendar/libedata-cal/libedata-cal-docs.sgml b/docs/reference/calendar/libedata-cal/libedata-cal-docs.sgml
index 77dde22..42d6156 100644
--- a/docs/reference/calendar/libedata-cal/libedata-cal-docs.sgml
+++ b/docs/reference/calendar/libedata-cal/libedata-cal-docs.sgml
@@ -14,6 +14,8 @@
     <xi:include href="xml/e-cal-backend-cache.xml"/>
     <xi:include href="xml/e-cal-backend-factory.xml"/>
     <xi:include href="xml/e-cal-backend-sexp.xml"/>
+    <xi:include href="xml/e-cal-backend-store.xml"/>
+    <xi:include href="xml/e-cal-backend-file-store.xml"/>
     <xi:include href="xml/e-cal-backend-sync.xml"/>
     <xi:include href="xml/e-cal-backend-util.xml"/>
     <xi:include href="xml/e-data-cal.xml"/>
@@ -29,4 +31,8 @@
     <title>Index of new symbols in 2.30</title>
     <xi:include href="xml/api-index-2.30.xml"><xi:fallback /></xi:include>
   </index>
+  <index id="api-index-2.28" role="2.28">
+    <title>Index of new symbols in 2.28</title>
+    <xi:include href="xml/api-index-2.28.xml"><xi:fallback /></xi:include>
+  </index>
 </book>
diff --git a/docs/reference/calendar/libedata-cal/libedata-cal-sections.txt b/docs/reference/calendar/libedata-cal/libedata-cal-sections.txt
index db0b908..0959893 100644
--- a/docs/reference/calendar/libedata-cal/libedata-cal-sections.txt
+++ b/docs/reference/calendar/libedata-cal/libedata-cal-sections.txt
@@ -124,6 +124,7 @@ e_cal_backend_sync_get_type
 <SECTION>
 <FILE>e-cal-backend</FILE>
 <TITLE>ECalBackend</TITLE>
+ECalBackend
 e_cal_backend_get_source
 e_cal_backend_get_uri
 e_cal_backend_get_kind
@@ -185,6 +186,7 @@ E_TYPE_CAL_BACKEND
 E_CAL_BACKEND_CLASS
 E_IS_CAL_BACKEND_CLASS
 E_CAL_BACKEND_GET_CLASS
+ECalBackendClass
 <SUBSECTION Private>
 ECalBackendPrivate
 e_cal_backend_get_type
@@ -267,6 +269,7 @@ e_cal_backend_file_store_get_type
 <FILE>e-data-cal</FILE>
 <TITLE>EDataCal</TITLE>
 E_DATA_CAL_ERROR
+EDataCal
 e_data_cal_new
 e_data_cal_get_backend
 e_data_cal_get_source
@@ -308,6 +311,7 @@ E_TYPE_DATA_CAL_MODE
 E_TYPE_DATA_CAL_OBJ_MOD_TYPE
 E_TYPE_DATA_CAL_OBJ_TYPE
 E_TYPE_DATA_CAL_VIEW_LISTENER_SET_MODE_STATUS
+EDataCalClass
 <SUBSECTION Private>
 EDataCalPrivate
 e_data_cal_get_type
@@ -329,12 +333,6 @@ e_cal_backend_user_declined
 
 <SECTION>
 <FILE>e-data-cal-common</FILE>
-ECalBackend
-ECalBackendClass
-EDataCal
-EDataCalClass
-EDataCalView
-EDataCalViewClass
 ECalBackendSExp
 ECalBackendSExpClass
 EServerMethodContext
diff --git a/docs/reference/calendar/libedata-cal/tmpl/e-cal-backend.sgml b/docs/reference/calendar/libedata-cal/tmpl/e-cal-backend.sgml
index c4ba19c..64a8443 100644
--- a/docs/reference/calendar/libedata-cal/tmpl/e-cal-backend.sgml
+++ b/docs/reference/calendar/libedata-cal/tmpl/e-cal-backend.sgml
@@ -17,6 +17,50 @@ Base class for calendar/tasks backend implementations.
 <!-- ##### SECTION Stability_Level ##### -->
 
 
+<!-- ##### STRUCT ECalBackend ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL ECalBackend::last-client-gone ##### -->
+<para>
+
+</para>
+
+ ecalbackend: the object which received the signal.
+
+<!-- ##### SIGNAL ECalBackend::opened ##### -->
+<para>
+
+</para>
+
+ ecalbackend: the object which received the signal.
+ arg1: 
+
+<!-- ##### SIGNAL ECalBackend::removed ##### -->
+<para>
+
+</para>
+
+ ecalbackend: the object which received the signal.
+ arg1: 
+
+<!-- ##### ARG ECalBackend:kind ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG ECalBackend:source ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG ECalBackend:uri ##### -->
+<para>
+
+</para>
+
 <!-- ##### FUNCTION e_cal_backend_get_source ##### -->
 <para>
 
diff --git a/docs/reference/calendar/libedata-cal/tmpl/e-data-cal-common.sgml b/docs/reference/calendar/libedata-cal/tmpl/e-data-cal-common.sgml
index 5a9808a..a4ca07b 100644
--- a/docs/reference/calendar/libedata-cal/tmpl/e-data-cal-common.sgml
+++ b/docs/reference/calendar/libedata-cal/tmpl/e-data-cal-common.sgml
@@ -17,200 +17,6 @@ e-data-cal-common
 <!-- ##### SECTION Stability_Level ##### -->
 
 
-<!-- ##### STRUCT ECalBackend ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SIGNAL ECalBackend::last-client-gone ##### -->
-<para>
-
-</para>
-
- ecalbackend: the object which received the signal.
-
-<!-- ##### SIGNAL ECalBackend::opened ##### -->
-<para>
-
-</para>
-
- ecalbackend: the object which received the signal.
- arg1: 
-
-<!-- ##### SIGNAL ECalBackend::removed ##### -->
-<para>
-
-</para>
-
- ecalbackend: the object which received the signal.
- arg1: 
-
-<!-- ##### ARG ECalBackend:kind ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG ECalBackend:source ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG ECalBackend:uri ##### -->
-<para>
-
-</para>
-
-<!-- ##### STRUCT ECalBackendClass ##### -->
-<para>
-
-</para>
-
- parent_class: 
- last_client_gone: 
- cal_added: 
- is_loaded: 
- opened: 
- removed: 
- obj_updated: 
- is_read_only: 
- get_cal_address: 
- get_alarm_email_address: 
- get_ldap_attribute: 
- get_static_capabilities: 
- open: 
- refresh: 
- remove: 
- create_object: 
- modify_object: 
- remove_object: 
- discard_alarm: 
- receive_objects: 
- send_objects: 
- get_default_object: 
- get_object: 
- get_object_list: 
- get_attachment_list: 
- get_timezone: 
- add_timezone: 
- set_default_zone: 
- set_default_timezone: 
- start_query: 
- get_mode: 
- set_mode: 
- get_free_busy: 
- get_changes: 
- internal_get_default_timezone: 
- internal_get_timezone: 
-
-<!-- ##### STRUCT EDataCal ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SIGNAL EDataCal::auth-required ##### -->
-<para>
-
-</para>
-
- edatacal: the object which received the signal.
-
-<!-- ##### SIGNAL EDataCal::backend-error ##### -->
-<para>
-
-</para>
-
- edatacal: the object which received the signal.
- arg1: 
-
-<!-- ##### SIGNAL EDataCal::mode ##### -->
-<para>
-
-</para>
-
- edatacal: the object which received the signal.
- arg1: 
-
-<!-- ##### SIGNAL EDataCal::readonly ##### -->
-<para>
-
-</para>
-
- edatacal: the object which received the signal.
- arg1: 
-
-<!-- ##### STRUCT EDataCalClass ##### -->
-<para>
-
-</para>
-
- parent_class: 
-
-<!-- ##### STRUCT EDataCalView ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SIGNAL EDataCalView::done ##### -->
-<para>
-
-</para>
-
- edatacalview: the object which received the signal.
- arg1: 
-
-<!-- ##### SIGNAL EDataCalView::objects-added ##### -->
-<para>
-
-</para>
-
- edatacalview: the object which received the signal.
- arg1: 
-
-<!-- ##### SIGNAL EDataCalView::objects-modified ##### -->
-<para>
-
-</para>
-
- edatacalview: the object which received the signal.
- arg1: 
-
-<!-- ##### SIGNAL EDataCalView::objects-removed ##### -->
-<para>
-
-</para>
-
- edatacalview: the object which received the signal.
- arg1: 
-
-<!-- ##### SIGNAL EDataCalView::progress ##### -->
-<para>
-
-</para>
-
- edatacalview: the object which received the signal.
- arg1: 
- arg2: 
-
-<!-- ##### ARG EDataCalView:backend ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG EDataCalView:sexp ##### -->
-<para>
-
-</para>
-
-<!-- ##### STRUCT EDataCalViewClass ##### -->
-<para>
-
-</para>
-
- parent_class: 
-
 <!-- ##### STRUCT ECalBackendSExp ##### -->
 <para>
 
diff --git a/docs/reference/calendar/libedata-cal/tmpl/e-data-cal.sgml b/docs/reference/calendar/libedata-cal/tmpl/e-data-cal.sgml
index 764720f..1cec9c4 100644
--- a/docs/reference/calendar/libedata-cal/tmpl/e-data-cal.sgml
+++ b/docs/reference/calendar/libedata-cal/tmpl/e-data-cal.sgml
@@ -24,6 +24,43 @@ Implementation of the calendar CORBA client interface.
 
 
 
+<!-- ##### STRUCT EDataCal ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL EDataCal::auth-required ##### -->
+<para>
+
+</para>
+
+ edatacal: the object which received the signal.
+
+<!-- ##### SIGNAL EDataCal::backend-error ##### -->
+<para>
+
+</para>
+
+ edatacal: the object which received the signal.
+ arg1: 
+
+<!-- ##### SIGNAL EDataCal::mode ##### -->
+<para>
+
+</para>
+
+ edatacal: the object which received the signal.
+ arg1: 
+
+<!-- ##### SIGNAL EDataCal::readonly ##### -->
+<para>
+
+</para>
+
+ edatacal: the object which received the signal.
+ arg1: 
+
 <!-- ##### FUNCTION e_data_cal_new ##### -->
 <para>
 
diff --git a/docs/reference/camel/camel-docs.sgml b/docs/reference/camel/camel-docs.sgml
index 6d5d168..2e9ee38 100644
--- a/docs/reference/camel/camel-docs.sgml
+++ b/docs/reference/camel/camel-docs.sgml
@@ -334,5 +334,9 @@
       <title>Index of new symbols in 2.30</title>
       <xi:include href="xml/api-index-2.30.xml"><xi:fallback /></xi:include>
     </index>
+    <index id="api-index-2.28" role="2.28">
+      <title>Index of new symbols in 2.28</title>
+      <xi:include href="xml/api-index-2.28.xml"><xi:fallback /></xi:include>
+    </index>
   </part>
 </book>
diff --git a/docs/reference/libebackend/libebackend-docs.xml b/docs/reference/libebackend/libebackend-docs.xml
index 763cfd1..d64dbf4 100644
--- a/docs/reference/libebackend/libebackend-docs.xml
+++ b/docs/reference/libebackend/libebackend-docs.xml
@@ -24,4 +24,8 @@
     <title>Index of new symbols in 2.30</title>
     <xi:include href="xml/api-index-2.30.xml"><xi:fallback /></xi:include>
   </index>
+  <index id="api-index-2.28" role="2.28">
+    <title>Index of new symbols in 2.28</title>
+    <xi:include href="xml/api-index-2.28.xml"><xi:fallback /></xi:include>
+  </index>
 </book>
diff --git a/docs/reference/libedataserver/libedataserver-docs.sgml b/docs/reference/libedataserver/libedataserver-docs.sgml
index 1ffa410..863042a 100644
--- a/docs/reference/libedataserver/libedataserver-docs.sgml
+++ b/docs/reference/libedataserver/libedataserver-docs.sgml
@@ -43,4 +43,8 @@
     <title>Index of new symbols in 2.30</title>
     <xi:include href="xml/api-index-2.30.xml"><xi:fallback /></xi:include>
   </index>
+  <index id="api-index-2.28" role="2.28">
+    <title>Index of new symbols in 2.28</title>
+    <xi:include href="xml/api-index-2.28.xml"><xi:fallback /></xi:include>
+  </index>
 </book>
diff --git a/docs/reference/libedataserverui/libedataserverui-docs.sgml b/docs/reference/libedataserverui/libedataserverui-docs.sgml
index cd119c8..13f2a0c 100644
--- a/docs/reference/libedataserverui/libedataserverui-docs.sgml
+++ b/docs/reference/libedataserverui/libedataserverui-docs.sgml
@@ -38,4 +38,8 @@
     <title>Index of new symbols in 2.30</title>
     <xi:include href="xml/api-index-2.30.xml"><xi:fallback /></xi:include>
   </index>
+  <index id="api-index-2.28" role="2.28">
+    <title>Index of new symbols in 2.28</title>
+    <xi:include href="xml/api-index-2.28.xml"><xi:fallback /></xi:include>
+  </index>
 </book>
diff --git a/libedataserver/e-data-server-util.c b/libedataserver/e-data-server-util.c
index 5fd8eb2..4269343 100644
--- a/libedataserver/e-data-server-util.c
+++ b/libedataserver/e-data-server-util.c
@@ -287,6 +287,8 @@ e_util_utf8_strcasecmp (const gchar *s1, const gchar *s2)
  * e_util_utf8_remove_accents:
  *
  * Returns newly allocates string, copy of 'str', without accents.
+ *
+ * Since: 2.28
  **/
 gchar *
 e_util_utf8_remove_accents (const gchar *str)
diff --git a/libedataserver/e-sexp.c b/libedataserver/e-sexp.c
index c06571a..84440ae 100644
--- a/libedataserver/e-sexp.c
+++ b/libedataserver/e-sexp.c
@@ -901,7 +901,13 @@ parse_values(ESExp *f, gint *len)
 	return terms;
 }
 
-ESExpTerm * e_sexp_parse_value (ESExp *f)
+/**
+ * e_sexp_parse_value:
+ *
+ * Since: 2.28
+ **/
+ESExpTerm *
+e_sexp_parse_value (ESExp *f)
 {
 	return parse_value (f);
 }
diff --git a/libedataserver/e-source-list.c b/libedataserver/e-source-list.c
index 610fe33..4640bd6 100644
--- a/libedataserver/e-source-list.c
+++ b/libedataserver/e-source-list.c
@@ -447,7 +447,10 @@ e_source_list_peek_group_by_name (ESourceList *list,
 
 /**
  * e_source_list_peek_group_by_base_uri:
+ *
  * Returns the first group which base uri begins with a base_uri.
+ *
+ * Since: 2.28
  **/
 ESourceGroup *
 e_source_list_peek_group_by_base_uri (ESourceList *list, const gchar *base_uri)
@@ -493,10 +496,13 @@ check_group_property (const gchar *property_name, const gchar *property_value, s
 
 /**
  * e_source_list_peek_group_by_properties:
+ *
  * Peeks group by its properties. Parameters are pairs of strings
  * property_name, property_value, terminated by NULL! ESourceGroup
  * is returned only if matches all the properties. Values are compared
  * case insensitively.
+ *
+ * Since: 2.28
  **/
 ESourceGroup *
 e_source_list_peek_group_by_properties (ESourceList *list, const gchar *property_name, ...)
@@ -636,9 +642,12 @@ e_source_list_remove_group_by_uid (ESourceList *list,
 
 /**
  * e_source_list_ensure_group:
+ *
  * Ensures group with the @base_uri will exists in the @list and its name will be @name.
  * If ret_it will be TRUE the group will be also returned, in that case caller should
  * g_object_unref the group. Otherwise it returns NULL.
+ *
+ * Since: 2.28
  **/
 ESourceGroup *
 e_source_list_ensure_group (ESourceList *list, const gchar *name, const gchar *base_uri, gboolean ret_it)
@@ -679,8 +688,11 @@ e_source_list_ensure_group (ESourceList *list, const gchar *name, const gchar *b
 
 /**
  * e_source_list_remove_group_by_base_uri:
+ *
  * Removes group with given base_uri.
  * Returns TRUE if group was found.
+ *
+ * Since: 2.28
  **/
 gboolean
 e_source_list_remove_group_by_base_uri (ESourceList *list, const gchar *base_uri)
diff --git a/libedataserverui/e-source-selector-dialog.c b/libedataserverui/e-source-selector-dialog.c
index e301169..fc6f16e 100644
--- a/libedataserverui/e-source-selector-dialog.c
+++ b/libedataserverui/e-source-selector-dialog.c
@@ -235,6 +235,8 @@ e_source_selector_dialog_new (GtkWindow *parent, ESourceList *source_list)
  * Selects default source in the dialog.
  *
  * Return value: Whether found any default source.
+ *
+ * Since: 2.28
  **/
 gboolean
 e_source_selector_dialog_select_default_source (ESourceSelectorDialog *dialog)
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]