/**
* e_book_cancel_async_op:
+ *
* Similar to above e_book_cancel function, only cancels last, still running,
* asynchronous operation.
+ *
+ * Since: 2.24
**/
gboolean
e_book_cancel_async_op (EBook *book, GError **error)
/**
* e_cal_match_tzid:
- * matches a TZID against the system timezone definitions
- * and returns the matching TZID, or NULL if none found
+ * @tzid: a timezone ID
+ *
+ * Matches @tzid against the system timezone definitions
+ * and returns the matching TZID, or %NULL if none found
+ *
+ * Since: 2.24
*/
-const gchar *e_cal_match_tzid(const gchar *tzid)
+const gchar *
+e_cal_match_tzid(const gchar *tzid)
{
const gchar *location;
const gchar *systzid = NULL;
* accordingly.
*
* Return value: TRUE if successful, FALSE otherwise.
+ *
+ * Since: 2.24
*/
-gboolean e_cal_check_timezones(icalcomponent *comp,
- GList *comps,
- icaltimezone *(*tzlookup)(const gchar *tzid,
- gconstpointer custom,
- GError **error),
- gconstpointer custom,
- GError **error)
+gboolean
+e_cal_check_timezones (icalcomponent *comp,
+ GList *comps,
+ icaltimezone *(*tzlookup)(const gchar *tzid,
+ gconstpointer custom,
+ GError **error),
+ gconstpointer custom,
+ GError **error)
{
gboolean success = TRUE;
icalcomponent *subcomp = NULL;
*
* An implementation of the tzlookup callback which clients
* can use. Calls #e_cal_get_timezone.
+ *
+ * Since: 2.24
*/
-icaltimezone *e_cal_tzlookup_ecal(const gchar *tzid,
- gconstpointer custom,
- GError **error)
+icaltimezone *
+e_cal_tzlookup_ecal (const gchar *tzid,
+ gconstpointer custom,
+ GError **error)
{
ECal *ecal = (ECal *)custom;
icaltimezone *zone = NULL;
* An implementation of the tzlookup callback which backends
* like the file backend can use. Searches for the timezone
* in the component list.
+ *
+ * Since: 2.24
*/
-icaltimezone *e_cal_tzlookup_icomp(const gchar *tzid,
- gconstpointer custom,
- GError **error)
+icaltimezone *
+e_cal_tzlookup_icomp (const gchar *tzid,
+ gconstpointer custom,
+ GError **error)
{
icalcomponent *icomp = (icalcomponent *)custom;
typedef struct _ECalBackendLoaderFactoryPrivate ECalBackendLoaderFactoryPrivate;
+/**
+ * ECalBackendLoaderFactory:
+ *
+ * Since: 2.24
+ **/
typedef struct {
ECalBackendFactory parent_object;
} ECalBackendLoaderFactory;
* e_cal_backend_status_to_string:
*
* Converts status code to string.
+ *
+ * Since: 2.24
**/
const gchar *
e_cal_backend_status_to_string (GNOME_Evolution_Calendar_CallStatus status)
* @query: An #EDataCalView object, previously added with @ref e_cal_backend_add_query.
*
* Removes query from the list of live queries for the backend.
+ *
+ * Since: 2.24
**/
void
e_cal_backend_remove_query (ECalBackend *backend, EDataCalView *query)
*
* This methods has to be used before e_cal_backend_notify_view_progress.
* Sets last notified percent value to 0.
+ *
+ * Since: 2.24
**/
void
e_cal_backend_notify_view_progress_start (ECalBackend *backend)
g_object_unref (iter);
}
+/**
+ * e_cal_backend_notify_objects_added:
+ *
+ * Since: 2.24
+ **/
void
e_cal_backend_notify_objects_added (ECalBackend *backend, EDataCalView *query, const GList *objects)
{
e_data_cal_view_notify_objects_added (query, objects);
}
+/**
+ * e_cal_backend_notify_objects_removed:
+ *
+ * Since: 2.24
+ **/
void
e_cal_backend_notify_objects_removed (ECalBackend *backend, EDataCalView *query, const GList *ids)
{
e_data_cal_view_notify_objects_removed (query, ids);
}
+/**
+ * e_cal_backend_notify_objects_modified:
+ *
+ * Since: 2.24
+ **/
void
e_cal_backend_notify_objects_modified (ECalBackend *backend, EDataCalView *query, const GList *objects)
{
return 0;
}
+/**
+ * camel_db_open:
+ *
+ * Since: 2.24
+ **/
CamelDB *
camel_db_open (const gchar *path, CamelException *ex)
{
return camel_db_open(cdb->priv->file_name, ex);
}
+/**
+ * camel_db_close:
+ *
+ * Since: 2.24
+ **/
void
camel_db_close (CamelDB *cdb)
{
}
}
+/**
+ * camel_db_set_collate:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_set_collate (CamelDB *cdb, const gchar *col, const gchar *collate, CamelDBCollate func)
{
return ret;
}
-/* Should this be really exposed ? */
+/**
+ * camel_db_command:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_command (CamelDB *cdb, const gchar *stmt, CamelException *ex)
{
- gint ret;
+ gint ret;
- if (!cdb)
- return TRUE;
- g_mutex_lock (cdb->lock);
+ /* XXX Should this be really exposed ? */
- START(stmt);
- ret = cdb_sql_exec (cdb->db, stmt, ex);
- END;
- g_mutex_unlock (cdb->lock);
+ if (!cdb)
+ return TRUE;
+ g_mutex_lock (cdb->lock);
- return ret;
+ START(stmt);
+ ret = cdb_sql_exec (cdb->db, stmt, ex);
+ END;
+ g_mutex_unlock (cdb->lock);
+
+ return ret;
}
+/**
+ * camel_db_begin_transaction:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_begin_transaction (CamelDB *cdb, CamelException *ex)
{
return (cdb_sql_exec (cdb->db, "BEGIN", ex));
}
+/**
+ * camel_db_end_transaction:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_end_transaction (CamelDB *cdb, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_abort_transaction:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_abort_transaction (CamelDB *cdb, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_add_to_transaction:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_add_to_transaction (CamelDB *cdb, const gchar *stmt, CamelException *ex)
{
return (cdb_sql_exec (cdb->db, stmt, ex));
}
+/**
+ * camel_db_transaction_command:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_transaction_command (CamelDB *cdb, GSList *qry_list, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_count_junk_message_info:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_count_junk_message_info (CamelDB *cdb, const gchar *table_name, guint32 *count, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_count_unread_message_info:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_count_unread_message_info (CamelDB *cdb, const gchar *table_name, guint32 *count, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_count_visible_unread_message_info:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_count_visible_unread_message_info (CamelDB *cdb, const gchar *table_name, guint32 *count, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_count_visible_message_info:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_count_visible_message_info (CamelDB *cdb, const gchar *table_name, guint32 *count, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_count_junk_not-deleted_message_info:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_count_junk_not_deleted_message_info (CamelDB *cdb, const gchar *table_name, guint32 *count, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_count_deleted_message_info:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_count_deleted_message_info (CamelDB *cdb, const gchar *table_name, guint32 *count, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_count_total_message_info:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_count_total_message_info (CamelDB *cdb, const gchar *table_name, guint32 *count, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_select:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_select (CamelDB *cdb, const gchar * stmt, CamelDBSelectCB callback, gpointer data, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_create_vfolder:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_create_vfolder (CamelDB *db, const gchar *folder_name, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_recreate_vfolder:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_recreate_vfolder (CamelDB *db, const gchar *folder_name, CamelException *ex)
{
return camel_db_create_vfolder (db, folder_name, ex);
}
+/**
+ * camel_db_delete_uid_from_vfolder:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_delete_uid_from_vfolder (CamelDB *db, gchar *folder_name, gchar *vuid, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_delete_uid_from_vfolder_transaction:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_delete_uid_from_vfolder_transaction (CamelDB *db, const gchar *folder_name, const gchar *vuid, CamelException *ex)
{
return 0;
}
+/**
+ * camel_db_get_folder_uids:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_get_folder_uids (CamelDB *db, const gchar *folder_name, const gchar *sort_by, const gchar *collate, GPtrArray *array, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_get_folder_junk_uids:
+ *
+ * Since: 2.24
+ **/
GPtrArray *
camel_db_get_folder_junk_uids (CamelDB *db, gchar *folder_name, CamelException *ex)
{
return array;
}
+/**
+ * camel_db_get_folder_deleted_uids:
+ *
+ * Since: 2.24
+ **/
GPtrArray *
camel_db_get_folder_deleted_uids (CamelDB *db, gchar *folder_name, CamelException *ex)
{
return 0;
}
+/**
+ * camel_db_get_vuids_from_vfolder:
+ *
+ * Since: 2.24
+ **/
GPtrArray *
camel_db_get_vuids_from_vfolder (CamelDB *db, gchar *folder_name, gchar *filter, CamelException *ex)
{
return array;
}
+/**
+ * camel_db_add_to_vfolder:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_add_to_vfolder (CamelDB *db, gchar *folder_name, gchar *vuid, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_add_to_vfolder_transaction:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_add_to_vfolder_transaction (CamelDB *db, const gchar *folder_name, const gchar *vuid, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_create_folders_table:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_create_folders_table (CamelDB *cdb, CamelException *ex)
{
return version;
}
+/**
+ * camel_db_prepare_message_info_table:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_prepare_message_info_table (CamelDB *cdb, const gchar *folder_name, CamelException *ex)
{
return write_mir (cdb, folder_name, record, ex, FALSE);
}
+/**
+ * camel_db_write_message_info_record:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_write_message_info_record (CamelDB *cdb, const gchar *folder_name, CamelMIRecord *record, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_write_folder_info_record:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_write_folder_info_record (CamelDB *cdb, CamelFIRecord *record, CamelException *ex)
{
return 0;
}
+/**
+ * camel_db_read_folder_info_record:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_read_folder_info_record (CamelDB *cdb, const gchar *folder_name, CamelFIRecord **record, CamelException *ex)
{
return (ret);
}
+/**
+ * camel_db_read_message_info_record_with_uid:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_read_message_info_record_with_uid (CamelDB *cdb, const gchar *folder_name, const gchar *uid, gpointer p, CamelDBSelectCB read_mir_callback, CamelException *ex)
{
return (ret);
}
+/**
+ * camel_db_read_message_info_records:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_read_message_info_records (CamelDB *cdb, const gchar *folder_name, gpointer p, CamelDBSelectCB read_mir_callback, CamelException *ex)
{
return (ret);
}
+/**
+ * camel_db_create_deleted_table:
+ *
+ * Since: 2.24
+ **/
static gint
camel_db_create_deleted_table (CamelDB *cdb, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_delete_uid:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_delete_uid (CamelDB *cdb, const gchar *folder, const gchar *uid, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_delete_uids:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_delete_uids (CamelDB *cdb, const gchar * folder_name, GSList *uids, CamelException *ex)
{
return cdb_delete_ids (cdb, folder_name, uids, hash, "vuid", ex);
}
+/**
+ * camel_db_clear_folder_summary:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_clear_folder_summary (CamelDB *cdb, gchar *folder, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_delete_folder:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_delete_folder (CamelDB *cdb, const gchar *folder, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_rename_folder:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_rename_folder (CamelDB *cdb, const gchar *old_folder, const gchar *new_folder, CamelException *ex)
{
return ret;
}
+/**
+ * camel_db_camel_mir_free:
+ *
+ * Since: 2.24
+ **/
void
camel_db_camel_mir_free (CamelMIRecord *record)
{
}
}
+/**
+ * camel_db_sqlize_string:
+ *
+ * Since: 2.24
+ **/
gchar *
camel_db_sqlize_string (const gchar *string)
{
return sqlite3_mprintf ("%Q", string);
}
+/**
+ * camel_db_free_sqlized_string:
+ *
+ * Since: 2.24
+ **/
void
camel_db_free_sqlized_string (gchar *string)
{
followup_completed_on TEXT ,
followup_due_by TEXT ," */
+/**
+ * camel_db_get_column_name:
+ *
+ * Since: 2.24
+ **/
gchar *
camel_db_get_column_name (const gchar *raw_name)
{
}
+/**
+ * camel_db_migrate_vfolders_to_14:
+ *
+ * Since: 2.24
+ **/
gint
camel_db_migrate_vfolders_to_14 (CamelDB *cdb, const gchar *folder, CamelException *ex)
{
#include <sqlite3.h>
#include <glib.h>
+/**
+ * CAMEL_DB_FILE:
+ *
+ * Since: 2.24
+ **/
#define CAMEL_DB_FILE "folders.db"
/* Hopefully no one will create a folder named EVO_IN_meM_hAnDlE */
typedef struct _CamelDBPrivate CamelDBPrivate;
+/**
+ * CamelDBCollate:
+ *
+ * Since: 2.24
+ **/
typedef gint(*CamelDBCollate)(gpointer ,int,gconstpointer ,int,gconstpointer );
+/**
+ * CamelDB:
+ *
+ * Since: 2.24
+ **/
struct _CamelDB {
sqlite3 *db;
GMutex *lock;
CamelDBPrivate *priv;
};
+/**
+ * CAMEL_DB_FREE_CACHE_SIZE:
+ *
+ * Since: 2.24
+ **/
#define CAMEL_DB_FREE_CACHE_SIZE 2 * 1024 * 1024
+
+/**
+ * CAMEL_DB_SLEEP_INTERVAL:
+ *
+ * Since: 2.24
+ **/
#define CAMEL_DB_SLEEP_INTERVAL 1*10*10
+
+/**
+ * CAMEL_DB_RELEASE_SQLITE_MEMORY:
+ *
+ * Since: 2.24
+ **/
#define CAMEL_DB_RELEASE_SQLITE_MEMORY if(!g_getenv("CAMEL_SQLITE_FREE_CACHE")) sqlite3_release_memory(CAMEL_DB_FREE_CACHE_SIZE);
-#define CAMEL_DB_USE_SHARED_CACHE if(g_getenv("CAMEL_SQLITE_SHARED_CACHE")) sqlite3_enable_shared_cache(TRUE);
-/* The extensive DB format, supporting basic searching and sorting
- uid, - Message UID
- flags, - Camel Message info flags
- unread/read, - boolean read/unread status
- deleted, - boolean deleted status
- replied, - boolean replied status
- imp, - boolean important status
- junk, - boolean junk status
- size, - size of the mail
- attachment, boolean attachment status
- dsent, - sent date
- dreceived, - received date
- subject, - subject of the mail
- from, - sender
- to, - recipient
- cc, - CC members
- mlist, - message list headers
- follow-up-flag, - followup flag / also can be queried to see for followup or not
- completed-on-set, - completed date, can be used to see if completed
- due-by, - to see the due by date
- Location - This can be derived from the database location/name. No need to store.
- label, - labels of mails also called as userflags
- usertags, composite string of user tags
- cinfo, content info string - composite string
- bdata, provider specific data
- part, part/references/thread id
-*/
+/**
+ * CAMEL_DB_USE_SHARED_CACHE:
+ *
+ * Since: 2.24
+ **/
+#define CAMEL_DB_USE_SHARED_CACHE if(g_getenv("CAMEL_SQLITE_SHARED_CACHE")) sqlite3_enable_shared_cache(TRUE);
+/**
+ * CamelMIRecord:
+ * @uid:
+ * Message UID
+ * @flags:
+ * Camel Message info flags
+ * @msg_type:
+ * @dirty:
+ * @read:
+ * boolean read status
+ * @deleted:
+ * boolean deleted status
+ * @replied:
+ * boolean replied status
+ * @important:
+ * boolean important status
+ * @junk:
+ * boolean junk status
+ * @attachment:
+ * boolean attachment status
+ * @size:
+ * size of the mail
+ * @dsent:
+ * date sent
+ * @dreceived:
+ * date received
+ * @subject:
+ * subject of the mail
+ * @from:
+ * sender
+ * @to:
+ * recipient
+ * @cc:
+ * CC members
+ * @mlist:
+ * message list headers
+ * @followup_flag:
+ * followup flag / also can be queried to see for followup or not
+ * @followup_completed_on:
+ * completed date, can be used to see if completed
+ * @followup_due_by:
+ * to see the due by date
+ * @part:
+ * part / references / thread id
+ * @labels:
+ * labels of mails also called as userflags
+ * @usertags:
+ * composite string of user tags
+ * @cinfo:
+ * content info string - composite string
+ * @bdata:
+ * provider specific data
+ * @bodystructure:
+ *
+ * The extensive DB format, supporting basic searching and sorting.
+ *
+ * Since: 2.24
+ **/
typedef struct _CamelMIRecord {
gchar *uid;
guint32 flags;
gchar *bodystructure;
} CamelMIRecord;
+/**
+ * CamelFIRecord:
+ *
+ * Since: 2.24
+ **/
typedef struct _CamelFIRecord {
gchar *folder_name;
guint32 version;
} CamelFIRecord;
typedef struct _CamelDB CamelDB;
+
+/**
+ * CamelDBSelectCB:
+ *
+ * Since: 2.24
+ **/
typedef gint (*CamelDBSelectCB) (gpointer data, gint ncol, gchar **colvalues, gchar **colnames);
CamelDB * camel_db_open (const gchar *path, CamelException *ex);
gint camel_filter_driver_filter_folder (CamelFilterDriver *driver, CamelFolder *folder, CamelUIDCache *cache,
GPtrArray *uids, gboolean remove, CamelException *ex);
-#if 0
-/* generate the search query/action string for a filter option */
-void camel_filter_driver_expand_option (CamelFilterDriver *d, GString *s, GString *action, struct filter_option *op);
-
-/* get info about rules (options) */
-gint camel_filter_driver_rule_count (CamelFilterDriver *d);
-struct filter_option *camel_filter_driver_rule_get (CamelFilterDriver *d, gint n);
-#endif
-
G_END_DECLS
#endif /* _CAMEL_FILTER_DRIVER_H */
* free'd as appropriate.
*
* Returns: the summary item's uid , or %NULL if @index is out of range
+ *
+ * Since: 2.24
**/
gchar *
camel_folder_summary_uid_from_index (CamelFolderSummary *s, gint i)
*
*
* Returns: if the uid is present in the summary or not (%TRUE or %FALSE)
+ *
+ * Since: 2.24
**/
gboolean
camel_folder_summary_check_uid (CamelFolderSummary *s, const gchar *uid)
g_ptr_array_add (array, (gpointer)camel_pstring_strdup((camel_message_info_uid(info))));
}
-/* FIXME[disk-summary] sucks, this function returns from memory. We need to
- * have collate or something to get the modified ones from DB and merge */
+/**
+ * camel_folder_summary_get_changed:
+ *
+ * Since: 2.24
+ **/
GPtrArray *
camel_folder_summary_get_changed (CamelFolderSummary *s)
{
GPtrArray *res = g_ptr_array_new();
+ /* FIXME[disk-summary] sucks, this function returns from memory.
+ * We need to have collate or something to get the modified ones
+ * from DB and merge */
+
CAMEL_SUMMARY_LOCK (s, summary_lock);
g_hash_table_foreach (s->loaded_infos, (GHFunc) append_changed_uids, res);
CAMEL_SUMMARY_UNLOCK (s, summary_lock);
return TRUE;
}
+/**
+ * camel_folder_summary_cache_size:
+ *
+ * Since: 2.24
+ **/
gint
camel_folder_summary_cache_size (CamelFolderSummary *s)
{
};
/* end */
+
+/**
+ * camel_folder_summary_reload_from_db:
+ *
+ * Since: 2.24
+ **/
gint
camel_folder_summary_reload_from_db (CamelFolderSummary *s, CamelException *ex)
{
return p->flag_cache;
}
+/**
+ * camel_folder_summary_load_from_db:
+ *
+ * Since: 2.24
+ **/
gint
camel_folder_summary_load_from_db (CamelFolderSummary *s, CamelException *ex)
{
}
+/**
+ * camel_folder_summary_migrate_infos:
+ *
+ * Since: 2.24
+ **/
gint
camel_folder_summary_migrate_infos(CamelFolderSummary *s)
{
camel_db_write_preview_record (folder->parent_store->cdb_w, folder->full_name, uid, (gchar *)value, NULL);
}
+/**
+ * camel_folder_summary_save_to_db:
+ *
+ * Since: 2.24
+ **/
gint
camel_folder_summary_save_to_db (CamelFolderSummary *s, CamelException *ex)
{
return ret;
}
+/**
+ * camel_folder_summary_header_save_to_db:
+ *
+ * Since: 2.24
+ **/
gint
camel_folder_summary_header_save_to_db (CamelFolderSummary *s, CamelException *ex)
{
return -1;
}
+/**
+ * camel_folder_summary_header_load_from_db:
+ *
+ * Since: 2.24
+ **/
gint
camel_folder_summary_header_load_from_db (CamelFolderSummary *s, CamelStore *store, const gchar *folder_name, CamelException *ex)
{
CAMEL_SUMMARY_UNLOCK(s, summary_lock);
}
+/**
+ * camel_folder_summary_insert:
+ *
+ * Since: 2.24
+ **/
void
camel_folder_summary_insert (CamelFolderSummary *s, CamelMessageInfo *info, gboolean load)
{
CAMEL_SUMMARY_UNLOCK(s, summary_lock);
}
-/* FIXME: This is non-sense. Neither an exception is passed,
-nor a value returned. How is the caller supposed to know,
-whether the operation is succesful */
-
+/**
+ * camel_folder_summary_clear_db:
+ *
+ * Since: 2.24
+ **/
void
camel_folder_summary_clear_db (CamelFolderSummary *s)
{
CamelDB *cdb;
gchar *folder_name;
+ /* FIXME: This is non-sense. Neither an exception is passed,
+ nor a value returned. How is the caller supposed to know,
+ whether the operation is succesful */
+
d(printf ("\ncamel_folder_summary_load_from_db called \n"));
s->flags &= ~CAMEL_SUMMARY_DIRTY;
}
/* _fast doesn't deal with db and leaves it to the caller. */
+
+/**
+ * camel_folder_summary_remove_uid_fast:
+ *
+ * Since: 2.24
+ **/
void
camel_folder_summary_remove_uid_fast (CamelFolderSummary *s, const gchar *uid)
{
}
}
+/**
+ * camel_folder_summary_remove_index_fast:
+ *
+ * Since: 2.24
+ **/
void
camel_folder_summary_remove_index_fast (CamelFolderSummary *s, gint index)
{
/**
* camel_message_info_preview:
+ * @mi: a #CamelMessageInfo
+ *
+ * FIXME Document me!
*
* Since: 2.28
**/
#define camel_message_info_user_flags(mi) ((const CamelFlag *)camel_message_info_ptr((const CamelMessageInfo *)mi, CAMEL_MESSAGE_INFO_USER_FLAGS))
#define camel_message_info_user_tags(mi) ((const CamelTag *)camel_message_info_ptr((const CamelMessageInfo *)mi, CAMEL_MESSAGE_INFO_USER_TAGS))
+/**
+ * camel_message_info_headers:
+ * @mi: a #CamelMessageInfo
+ *
+ * FIXME Document me!
+ *
+ * Since: 2.24
+ **/
#define camel_message_info_headers(mi) ((const struct _camel_header_param *)camel_message_info_ptr((const CamelMessageInfo *)mi, CAMEL_MESSAGE_INFO_HEADERS))
/**
* @uids: array of uids
*
* Sorts the array of UIDs.
+ *
+ * Since: 2.24
**/
void
camel_folder_sort_uids (CamelFolder *folder, GPtrArray *uids)
* @folder: a #CamelFolder object
*
* Returns: list of known quota(s) for the folder.
+ *
+ * Since: 2.24
**/
CamelFolderQuotaInfo *
camel_folder_get_quota_info (CamelFolder *folder)
*
* Returns: newly allocated #CamelFolderQuotaInfo structure with
* initialized values based on the parameters, with next member set to NULL.
+ *
+ * Since: 2.24
**/
CamelFolderQuotaInfo *
camel_folder_quota_info_new (const gchar *name, guint64 used, guint64 total)
* @info: a #CamelFolderQuotaInfo object to clone.
*
* Makes a copy of the given info and all next-s.
+ *
+ * Since: 2.24
**/
CamelFolderQuotaInfo *
camel_folder_quota_info_clone (const CamelFolderQuotaInfo *info)
* @info: a #CamelFolderQuotaInfo object to free.
*
* Frees this and all next objects.
+ *
+ * Since: 2.24
**/
void
camel_folder_quota_info_free (CamelFolderQuotaInfo *info)
typedef struct _CamelFolderQuotaInfo CamelFolderQuotaInfo;
+/**
+ * CamelFolderQuotaInfo:
+ *
+ * Since: 2.24
+ **/
struct _CamelFolderQuotaInfo {
gchar *name;
guint64 used;
* streaming progress.
*
* Returns: a new #CamelMimeFilter object
+ *
+ * Since: 2.24
**/
CamelMimeFilter *
camel_mime_filter_progress_new (CamelOperation *operation, gsize total)
typedef struct _CamelMimeFilterProgressClass CamelMimeFilterProgressClass;
typedef struct _CamelMimeFilterProgress CamelMimeFilterProgress;
+/**
+ * CamelMimeFilterProgress:
+ *
+ * Since: 2.24
+ **/
struct _CamelMimeFilterProgress {
CamelMimeFilter parent;
camel_object_unref (mem);
}
-/* This replaces the data wrapper repository ... and/or could be replaced by it? */
+/**
+ * camel_mime_part_construct_content_from_parser:
+ *
+ * Since: 2.24
+ **/
void
camel_mime_part_construct_content_from_parser (CamelMimePart *dw, CamelMimeParser *mp)
{
CamelContentType *ct;
gchar *encoding;
+ /* This replaces the data wrapper repository ... and/or could be
+ * replaced by it? */
+
if (!dw)
return;
}
#endif
+/**
+ * camel_msgport_new:
+ *
+ * Since: 2.24
+ **/
CamelMsgPort *
camel_msgport_new (void)
{
return msgport;
}
+/**
+ * camel_msgport_destroy:
+ *
+ * Since: 2.24
+ **/
void
camel_msgport_destroy (CamelMsgPort *msgport)
{
g_slice_free (CamelMsgPort, msgport);
}
+/**
+ * camel_msgport_fd:
+ *
+ * Since: 2.24
+ **/
gint
camel_msgport_fd (CamelMsgPort *msgport)
{
}
#ifdef HAVE_NSS
+/**
+ * camel_msgport_prfd:
+ *
+ * Since: 2.24
+ **/
PRFileDesc *
camel_msgport_prfd (CamelMsgPort *msgport)
{
}
#endif
+/**
+ * camel_msgport_push:
+ *
+ * Since: 2.24
+ **/
void
camel_msgport_push (CamelMsgPort *msgport, CamelMsg *msg)
{
g_async_queue_unlock (msgport->queue);
}
+/**
+ * camel_msgport_pop:
+ *
+ * Since: 2.24
+ **/
CamelMsg *
camel_msgport_pop (CamelMsgPort *msgport)
{
return msg;
}
+/**
+ * camel_msgport_try_pop:
+ *
+ * Since: 2.24
+ **/
CamelMsg *
camel_msgport_try_pop (CamelMsgPort *msgport)
{
* @msgport: a #CamelMsgPort
* @end_time: a #GTimeVal
*
- * FIXME Document me!
- *
* Since: 2.30
**/
CamelMsg *
return msg;
}
+/**
+ * camel_msgport_reply:
+ *
+ * Since: 2.24
+ **/
void
camel_msgport_reply (CamelMsg *msg)
{
G_BEGIN_DECLS
+/**
+ * CamelMsgPort:
+ *
+ * Since: 2.24
+ **/
+
typedef struct _CamelMsg CamelMsg;
typedef struct _CamelMsgPort CamelMsgPort;
+/**
+ * CamelMsg:
+ *
+ * Since: 2.24
+ **/
struct _CamelMsg {
CamelDListNode ln;
CamelMsgPort *reply_port;
*
* Return the network state either #CAMEL_OFFLINE_STORE_NETWORK_AVAIL
* or #CAMEL_OFFLINE_STORE_NETWORK_UNAVAIL.
+ *
+ * Since: 2.24
**/
gint
camel_offline_store_get_network_state (CamelOfflineStore *store, CamelException *ex)
}
/**
- * camel_search_sexp_to_sql:
+ * camel_sexp_to_sql:
* @txt: A valid sexp expression
*
* Converts a valid sexp expression to a sql statement with table fields converted into it.
* This is very specific to Evolution. It might crash is the sexp is invalid. The callers must ensure that the sexp is valid
+ *
+ * Since: 2.24
**/
-
gchar *
camel_sexp_to_sql (const gchar *txt)
{
* will be closed. This will not increase reference counter on the stream.
*
* Returns: a new #CamelStreamVFS
+ *
+ * Since: 2.24
**/
CamelStream *
camel_stream_vfs_new_with_stream (GObject *stream)
* @stream_vfs: a #CamelStreamVFS instance
*
* Returns: whether is the underlying stream writable or not.
+ *
+ * Since: 2.24
**/
gboolean
camel_stream_vfs_is_writable (CamelStreamVFS *stream_vfs)
/* Standard Camel function */
CamelType camel_stream_vfs_get_type (void);
+/**
+ * CamelStreamVFSOpenMethod:
+ * CAMEL_STREAM_VFS_CREATE:
+ * Writable, creates new file or replaces old file.
+ * CAMEL_STREAM_VFS_APPEND:
+ * Writable, creates new file or appends at the end of the old file.
+ * CAMEL_STREAM_VFS_READ:
+ * Readable, opens existing file for reading.
+ *
+ * Since: 2.24
+ **/
typedef enum {
- CAMEL_STREAM_VFS_CREATE, /* writable, creates new file or replaces old file */
- CAMEL_STREAM_VFS_APPEND, /* writable, creates new file or appends at the end of the old file */
- CAMEL_STREAM_VFS_READ /* readable, opens existing file for reading */
+ CAMEL_STREAM_VFS_CREATE,
+ CAMEL_STREAM_VFS_APPEND,
+ CAMEL_STREAM_VFS_READ
} CamelStreamVFSOpenMethod;
/* public methods */
*
* Return value: A pointer to an equivalent string of @s. Use
* camel_pstring_free() when it is no longer needed.
+ *
+ * Since: 2.24
**/
const gchar *
camel_pstring_peek (const gchar *str)
* CamelTrie:
*
* A trie data structure.
+ *
+ * Since: 2.24
**/
struct _CamelTrie {
struct _trie_state root;
* done by the CamelTrie will be case insensitive.
*
* Returns: The newly-created #CamelTrie.
+ *
+ * Since: 2.24
**/
CamelTrie *
camel_trie_new (gboolean icase)
* @trie: The #CamelTrie to free.
*
* Frees the memory associated with the #CamelTrie @trie.
+ *
+ * Since: 2.24
**/
void
camel_trie_free (CamelTrie *trie)
* @pattern_id: The id to use for the pattern.
*
* Add a new pattern to the #CamelTrie @trie.
+ *
+ * Since: 2.24
**/
void
camel_trie_add (CamelTrie *trie, const gchar *pattern, gint pattern_id)
* Try to match the string @buffer with a pattern in @trie.
*
* Returns: The matched pattern, or %NULL if no pattern is matched.
+ *
+ * Since: 2.24
**/
const gchar *
camel_trie_search (CamelTrie *trie, const gchar *buffer, gsize buflen,
camel_object_unref((CamelObject *)sub);
}
+/**
+ * camel_vee_folder_sync_headers:
+ *
+ * Since: 2.24
+ **/
void
camel_vee_folder_sync_headers (CamelFolder *vf, CamelException *ex)
{
/* open mode for folder, vee folder auto-update */
#define CAMEL_STORE_VEE_FOLDER_AUTO (1<<16)
+
+/**
+ * CAMEL_STORE_VEE_FOLDER_SPECIAL:
+ *
+ * Since: 2.24
+ **/
#define CAMEL_STORE_VEE_FOLDER_SPECIAL (1<<17)
struct _CamelVeeStore {
return &s->summary;
}
+/**
+ * camel_vee_summary_get_ids:
+ *
+ * Since: 2.24
+ **/
GPtrArray *
camel_vee_summary_get_ids (CamelVeeSummary *summary, gchar hash[8])
{
return 0;
}
+/**
+ * camel_shutdown:
+ *
+ * Since: 2.24
+ **/
void
camel_shutdown (void)
{
<title>Index of new symbols in 2.26</title>
<xi:include href="xml/api-index-2.26.xml"><xi:fallback /></xi:include>
</index>
+ <index id="api-index-2.24" role="2.24">
+ <title>Index of new symbols in 2.24</title>
+ <xi:include href="xml/api-index-2.24.xml"><xi:fallback /></xi:include>
+ </index>
</book>
<title>Index of new symbols in 2.26</title>
<xi:include href="xml/api-index-2.26.xml"><xi:fallback /></xi:include>
</index>
+ <index id="api-index-2.24" role="2.24">
+ <title>Index of new symbols in 2.24</title>
+ <xi:include href="xml/api-index-2.24.xml"><xi:fallback /></xi:include>
+ </index>
</book>
<title>Index of new symbols in 2.26</title>
<xi:include href="xml/api-index-2.26.xml"><xi:fallback /></xi:include>
</index>
+ <index id="api-index-2.24" role="2.24">
+ <title>Index of new symbols in 2.24</title>
+ <xi:include href="xml/api-index-2.24.xml"><xi:fallback /></xi:include>
+ </index>
</book>
<xi:include href="xml/e-cal-backend.xml"/>
<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-loader-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"/>
<title>Index of new symbols in 2.26</title>
<xi:include href="xml/api-index-2.26.xml"><xi:fallback /></xi:include>
</index>
+ <index id="api-index-2.24" role="2.24">
+ <title>Index of new symbols in 2.24</title>
+ <xi:include href="xml/api-index-2.24.xml"><xi:fallback /></xi:include>
+ </index>
</book>
<chapter id="Fundamentals">
<title>Fundamentals</title>
+ &CamelInit;
&CamelArg;
&CamelDebug;
&CamelException;
<title>Index of new symbols in 2.26</title>
<xi:include href="xml/api-index-2.26.xml"><xi:fallback /></xi:include>
</index>
+ <index id="api-index-2.24" role="2.24">
+ <title>Index of new symbols in 2.24</title>
+ <xi:include href="xml/api-index-2.24.xml"><xi:fallback /></xi:include>
+ </index>
</part>
</book>
@Returns:
-<!-- ##### FUNCTION camel_filter_driver_expand_option ##### -->
-<para>
-
-</para>
-
-@d:
-@s:
-@action:
-@op:
-
-
-<!-- ##### FUNCTION camel_filter_driver_rule_count ##### -->
-<para>
-
-</para>
-
-@d:
-@Returns:
-
-
-<!-- ##### FUNCTION camel_filter_driver_rule_get ##### -->
-<para>
-
-</para>
-
-@d:
-@n:
-@Returns:
-
-
@value:
@Returns:
+<!-- ##### FUNCTION camel_filter_driver_expand_option ##### -->
+<para>
+
+</para>
+
+@d:
+@s:
+@action:
+@op:
+
+<!-- ##### FUNCTION camel_filter_driver_rule_count ##### -->
+<para>
+
+</para>
+
+@d:
+@Returns:
+
+<!-- ##### FUNCTION camel_filter_driver_rule_get ##### -->
+<para>
+
+</para>
+
+@d:
+@n:
+@Returns:
+
<!-- ##### FUNCTION camel_folder_summary_array_free ##### -->
<para>
<title>Index of new symbols in 2.26</title>
<xi:include href="xml/api-index-2.26.xml"><xi:fallback /></xi:include>
</index>
+ <index id="api-index-2.24" role="2.24">
+ <title>Index of new symbols in 2.24</title>
+ <xi:include href="xml/api-index-2.24.xml"><xi:fallback /></xi:include>
+ </index>
</book>
<title>Index of new symbols in 2.26</title>
<xi:include href="xml/api-index-2.26.xml"><xi:fallback /></xi:include>
</index>
+ <index id="api-index-2.24" role="2.24">
+ <title>Index of new symbols in 2.24</title>
+ <xi:include href="xml/api-index-2.24.xml"><xi:fallback /></xi:include>
+ </index>
</book>
<title>Index of new symbols in 2.26</title>
<xi:include href="xml/api-index-2.26.xml"><xi:fallback /></xi:include>
</index>
+ <index id="api-index-2.24" role="2.24">
+ <title>Index of new symbols in 2.24</title>
+ <xi:include href="xml/api-index-2.24.xml"><xi:fallback /></xi:include>
+ </index>
</book>
* Registers callback to be called on change of any category.
* Pair listener and user_data is used to distinguish between listeners.
* Listeners can be unregistered with @e_categories_unregister_change_listener.
+ *
+ * Since: 2.24
**/
void
e_categories_register_change_listener (GCallback listener, gpointer user_data)
*
* Removes previously registered callback from the list of listeners on changes.
* If it was not registered, then does nothing.
+ *
+ * Since: 2.24
**/
void
e_categories_unregister_change_listener (GCallback listener, gpointer user_data)
}
}
+/**
+ * e_proxy_new:
+ *
+ * Since: 2.24
+ **/
EProxy*
e_proxy_new (void)
{
return proxy;
}
+/**
+ * e_proxxy_setup_proxy:
+ *
+ * Since: 2.24
+ **/
void
e_proxy_setup_proxy (EProxy* proxy)
{
return proxy->priv->uri_http;
}
+/**
+ * e_proxy_require_proxy_for_uri:
+ *
+ * Since: 2.24
+ **/
gboolean
e_proxy_require_proxy_for_uri (EProxy* proxy, const gchar * uri)
{
typedef struct _EProxyClass EProxyClass;
typedef struct _EProxyPrivate EProxyPrivate;
+/**
+ * EProxy:
+ *
+ * Since: 2.24
+ **/
struct _EProxy {
GObject parent;
EProxyPrivate *priv;
*
* Return value: %TRUE if @a is equivalent to @b,
* %FALSE otherwise.
+ *
+ * Since: 2.24
**/
gboolean
e_source_group_equal (ESourceGroup *a, ESourceGroup *b)
*
* Return value: %TRUE if @a is equivalent to @b,
* %FALSE otherwise.
+ *
+ * Since: 2.24
**/
gboolean
e_source_group_xmlstr_equal (const gchar *a, const gchar *b)
*
* Return value: %TRUE if @a is equivalent to @b,
* %FALSE otherwise.
+ *
+ * Since: 2.24
**/
gboolean
e_source_equal (ESource *a, ESource *b)
*
* Return value: %TRUE if @a is equivalent to @b,
* %FALSE otherwise.
+ *
+ * Since: 2.24
**/
gboolean
e_source_xmlstr_equal (const gchar *a, const gchar *b)
/**
* ens_util_populate_user_query_fields:
+ *
* Populates list of user query fields to string usable in query string.
* Returned pointer is either newly allocated string, supposed to be freed with g_free,
* or NULL if no fields defined.
+ *
+ * Since: 2.24
**/
gchar *
ens_util_populate_user_query_fields (GSList *user_query_fields, const gchar *cue_str, const gchar *encoded_cue_str)
((obj), E_TYPE_NAME_SELECTOR_ENTRY, ENameSelectorEntryClass))
#define MINIMUM_QUERY_LENGTH "/apps/evolution/addressbook/completion/minimum_query_length"
+
+/**
+ * FORCE_SHOW_ADDRESS:
+ *
+ * Since: 2.24
+ **/
#define FORCE_SHOW_ADDRESS "/apps/evolution/addressbook/completion/show_address"
+
+/**
+ * USER_QUERY_FIELDS:
+ *
+ * Since: 2.24
+ **/
#define USER_QUERY_FIELDS "/apps/evolution/addressbook/completion/user_query_fields"
G_BEGIN_DECLS
* Returns the #ESourceList that @selector is rendering.
*
* Returns: an #ESourceList
+ *
+ * Since: 2.24
**/
ESourceList *
e_source_selector_get_source_list (ESourceSelector *selector)