diff options
Diffstat (limited to 'camel')
| -rw-r--r-- | camel/camel-arg.h | 38 | ||||
| -rw-r--r-- | camel/camel-data-cache.c | 2 | ||||
| -rw-r--r-- | camel/camel-db.c | 41 | ||||
| -rw-r--r-- | camel/camel-db.h | 18 | ||||
| -rw-r--r-- | camel/camel-folder-search.c | 2 | ||||
| -rw-r--r-- | camel/camel-folder-summary.c | 23 | ||||
| -rw-r--r-- | camel/camel-folder.c | 11 | ||||
| -rw-r--r-- | camel/camel-search-sql-sexp.c | 5 | ||||
| -rw-r--r-- | camel/camel-session.c | 2 | ||||
| -rw-r--r-- | camel/camel-store.h | 7 | ||||
| -rw-r--r-- | camel/camel-utf8.c | 2 | ||||
| -rw-r--r-- | camel/camel-vee-folder.c | 10 | ||||
| -rw-r--r-- | camel/camel-vee-summary.c | 5 |
13 files changed, 162 insertions, 4 deletions
diff --git a/camel/camel-arg.h b/camel/camel-arg.h index 0c60f1522..be529f662 100644 --- a/camel/camel-arg.h +++ b/camel/camel-arg.h @@ -71,13 +71,49 @@ struct _CamelArgGet { gpointer *ca_ptr; } u; }; + +/** + * ca_object: + * + * Since: 2.26 + **/ #define ca_object u.ca_object + +/** + * ca_int: + * + * Since: 2.26 + **/ #define ca_int u.ca_int + +/** + * ca_double: + * + * Since: 2.26 + **/ #define ca_double u.ca_double + +/** + * ca_str: + * + * Since: 2.26 + **/ #define ca_str u.ca_str + +/** + * ca_ptr: + * + * Since: 2.26 + **/ #define ca_ptr u.ca_ptr -/* maximum no of args processed at any one time, not the max of all args */ +/** + * CAMEL_ARGV_MAX: + * + * Maximum no of args processed at any one time, not the max of all args. + * + * Since: 2.26 + **/ #define CAMEL_ARGV_MAX (20) struct _CamelArgV { diff --git a/camel/camel-data-cache.c b/camel/camel-data-cache.c index 7fbcea32b..799d2d657 100644 --- a/camel/camel-data-cache.c +++ b/camel/camel-data-cache.c @@ -359,6 +359,8 @@ camel_data_cache_get(CamelDataCache *cdc, const gchar *path, const gchar *key, C * Lookup the filename for an item in the cache * * Return value: The filename for a cache item + * + * Since: 2.26 **/ gchar * camel_data_cache_get_filename (CamelDataCache *cdc, const gchar *path, const gchar *key, CamelException *ex) diff --git a/camel/camel-db.c b/camel/camel-db.c index 2b1bc7b3c..262ec38b1 100644 --- a/camel/camel-db.c +++ b/camel/camel-db.c @@ -449,6 +449,11 @@ camel_db_open (const gchar *path, CamelException *ex) return cdb; } +/** + * camel_db_clone: + * + * Since: 2.26 + **/ CamelDB * camel_db_clone (CamelDB *cdb, CamelException *ex) { @@ -600,6 +605,11 @@ count_cb (gpointer data, gint argc, gchar **argv, gchar **azColName) return 0; } +/** + * camel_db_count_message_info: + * + * Since: 2.26 + **/ gint camel_db_count_message_info (CamelDB *cdb, const gchar *query, guint32 *count, CamelException *ex) { @@ -894,6 +904,11 @@ read_uids_flags_callback (gpointer ref, gint ncol, gchar ** cols, gchar ** name) return 0; } +/** + * camel_db_get_folder_uids_flags: + * + * Since: 2.26 + **/ gint camel_db_get_folder_uids_flags (CamelDB *db, const gchar *folder_name, const gchar *sort_by, const gchar *collate, GPtrArray *summary, GHashTable *table, CamelException *ex) { @@ -1362,6 +1377,11 @@ camel_db_prepare_message_info_table (CamelDB *cdb, const gchar *folder_name, Cam return ret; } +/** + * camel_db_write_fresh_message_info_record: + * + * Since: 2.26 + **/ gint camel_db_write_fresh_message_info_record (CamelDB *cdb, const gchar *folder_name, CamelMIRecord *record, CamelException *ex) { @@ -1687,6 +1707,11 @@ camel_db_delete_uids (CamelDB *cdb, const gchar * folder_name, GSList *uids, Cam return cdb_delete_ids (cdb, folder_name, uids, "", "uid", ex); } +/** + * camel_db_delete_vuids: + * + * Since: 2.26 + **/ gint camel_db_delete_vuids (CamelDB *cdb, const gchar * folder_name, const gchar *hash, GSList *uids, CamelException *ex) { @@ -1901,7 +1926,13 @@ camel_db_migrate_vfolders_to_14 (CamelDB *cdb, const gchar *folder, CamelExcepti return ret; } -gint camel_db_start_in_memory_transactions (CamelDB *cdb, CamelException *ex) +/** + * camel_db_start_in_memory_transactions: + * + * Since: 2.26 + **/ +gint +camel_db_start_in_memory_transactions (CamelDB *cdb, CamelException *ex) { gint ret; gchar *cmd = sqlite3_mprintf ("ATTACH DATABASE ':memory:' AS %s", CAMEL_DB_IN_MEMORY_DB); @@ -1918,7 +1949,13 @@ gint camel_db_start_in_memory_transactions (CamelDB *cdb, CamelException *ex) return ret; } -gint camel_db_flush_in_memory_transactions (CamelDB *cdb, const gchar * folder_name, CamelException *ex) +/** + * camel_db_flush_in_memory_transactions: + * + * Since: 2.26 + **/ +gint +camel_db_flush_in_memory_transactions (CamelDB *cdb, const gchar * folder_name, CamelException *ex) { gint ret; gchar *cmd = sqlite3_mprintf ("INSERT INTO %Q SELECT * FROM %Q", folder_name, CAMEL_DB_IN_MEMORY_TABLE); diff --git a/camel/camel-db.h b/camel/camel-db.h index 88510ab2c..3b3f3df35 100644 --- a/camel/camel-db.h +++ b/camel/camel-db.h @@ -8,8 +8,26 @@ #define CAMEL_DB_FILE "folders.db" /* Hopefully no one will create a folder named EVO_IN_meM_hAnDlE */ + +/** + * CAMEL_DB_IN_MEMORY_TABLE: + * + * Since: 2.26 + **/ #define CAMEL_DB_IN_MEMORY_TABLE "EVO_IN_meM_hAnDlE.temp" + +/** + * CAMEL_DB_IN_MEMORY_DB: + * + * Since: 2.26 + **/ #define CAMEL_DB_IN_MEMORY_DB "EVO_IN_meM_hAnDlE" + +/** + * CAMEL_DB_IN_MEMORY_TABLE_LIMIT: + * + * Since: 2.26 + **/ #define CAMEL_DB_IN_MEMORY_TABLE_LIMIT 100000 #include "camel-exception.h" diff --git a/camel/camel-folder-search.c b/camel/camel-folder-search.c index 03c352d70..27af4a6fe 100644 --- a/camel/camel-folder-search.c +++ b/camel/camel-folder-search.c @@ -419,6 +419,8 @@ camel_folder_search_execute_expression(CamelFolderSearch *search, const gchar *e * it must implement summaries. * * Return value: Number of messages that match the query. + * + * Since: 2.26 **/ guint32 diff --git a/camel/camel-folder-summary.c b/camel/camel-folder-summary.c index cca3ef33a..384442894 100644 --- a/camel/camel-folder-summary.c +++ b/camel/camel-folder-summary.c @@ -494,6 +494,8 @@ camel_folder_summary_array(CamelFolderSummary *s) * It must be freed using camel_folder_summary_free_hashtable * * Returns: a #GHashTable of uids + * + * Since: 2.26 **/ GHashTable * camel_folder_summary_get_hashtable(CamelFolderSummary *s) @@ -511,6 +513,11 @@ camel_folder_summary_get_hashtable(CamelFolderSummary *s) return hash; } +/** + * camel_folder_summary_free_hashtable: + * + * Since: 2.26 + **/ void camel_folder_summary_free_hashtable (GHashTable *ht) { @@ -518,6 +525,11 @@ camel_folder_summary_free_hashtable (GHashTable *ht) g_hash_table_destroy (ht); } +/** + * camel_folder_summary_peek_info: + * + * Since: 2.26 + **/ CamelMessageInfo * camel_folder_summary_peek_info (CamelFolderSummary *s, const gchar *uid) { @@ -1061,6 +1073,11 @@ camel_folder_summary_dump (CamelFolderSummary *s) } #endif +/** + * camel_folder_summary_get_flag_cache: + * + * Since: 2.26 + **/ GHashTable * camel_folder_summary_get_flag_cache (CamelFolderSummary *summary) { @@ -4837,11 +4854,17 @@ info_set_flags(CamelMessageInfo *info, guint32 flags, guint32 set) return TRUE; } +/** + * camel_folder_summary_update_flag_cache: + * + * Since: 2.26 + **/ void camel_folder_summary_update_flag_cache (CamelFolderSummary *s, const gchar *uid, guint32 flag) { g_hash_table_replace (_PRIVATE(s)->flag_cache, (gchar *) uid, GUINT_TO_POINTER(flag)); } + /** * camel_message_info_set_flags: * @mi: a #CamelMessageInfo diff --git a/camel/camel-folder.c b/camel/camel-folder.c index 879e18c85..b888ed9da 100644 --- a/camel/camel-folder.c +++ b/camel/camel-folder.c @@ -264,6 +264,11 @@ get_filename (CamelFolder *folder, const gchar *uid, CamelException *ex) return g_strdup ("/dev/null"); } +/** + * camel_folder_get_filename: + * + * Since: 2.26 + **/ gchar * camel_folder_get_filename (CamelFolder *folder, const gchar *uid, CamelException *ex) { @@ -1142,7 +1147,7 @@ camel_folder_get_message (CamelFolder *folder, const gchar *uid, CamelException * Ensure that a message identified by UID has been synced in the folder (so * that camel_folder_get_message on it later will work in offline mode). * - * Returns: void. + * Since: 2.26 **/ void camel_folder_sync_message (CamelFolder *folder, const gchar *uid, CamelException *ex) @@ -1245,6 +1250,8 @@ get_uncached_uids (CamelFolder *folder, GPtrArray * uids, CamelException *ex) * which are locally cached but should never filter out a uid which is not * locally cached. Free the result by called #camel_folder_free_uids. * Frees the array of UIDs returned by #camel_folder_get_uids. + * + * Since: 2.26 **/ GPtrArray * camel_folder_get_uncached_uids (CamelFolder *folder, GPtrArray * uids, CamelException *ex) @@ -1448,6 +1455,8 @@ count_by_expression (CamelFolder *folder, const gchar *expression, * Searches the folder for count of messages matching the given search expression. * * Returns: an interger + * + * Since: 2.26 **/ guint32 camel_folder_count_by_expression (CamelFolder *folder, const gchar *expression, diff --git a/camel/camel-search-sql-sexp.c b/camel/camel-search-sql-sexp.c index fae78dd50..b2785aceb 100644 --- a/camel/camel-search-sql-sexp.c +++ b/camel/camel-search-sql-sexp.c @@ -599,6 +599,11 @@ static struct { /* { "uid", CAMEL_STRUCT_OFFSET(CamelFolderSearchClass, uid), 1 }, */ }; +/** + * camel_sexp_to_sql_sexp: + * + * Since: 2.26 + **/ gchar * camel_sexp_to_sql_sexp (const gchar *sql) { diff --git a/camel/camel-session.c b/camel/camel-session.c index 455fd7e29..e047e2626 100644 --- a/camel/camel-session.c +++ b/camel/camel-session.c @@ -823,6 +823,8 @@ session_forward_to (CamelSession *session, CamelFolder *folder, CamelMimeMessage * @message Message to forward. * @address Where forward to. * @ex Exception. + * + * Since: 2.26 **/ void camel_session_forward_to (CamelSession *session, CamelFolder *folder, CamelMimeMessage *message, const gchar *address, CamelException *ex) diff --git a/camel/camel-store.h b/camel/camel-store.h index 76347bf5f..31e4f07d2 100644 --- a/camel/camel-store.h +++ b/camel/camel-store.h @@ -115,7 +115,14 @@ typedef struct _CamelRenameInfo { #define CAMEL_STORE_FILTER_INBOX (1 << 2) #define CAMEL_STORE_VJUNK (1 << 3) #define CAMEL_STORE_PROXY (1 << 4) + +/** + * CAMEL_STORE_IS_MIGRATING: + * + * Since: 2.26 + **/ #define CAMEL_STORE_IS_MIGRATING (1 << 5) + #define CAMEL_STORE_ASYNC (1 << 6) struct _CamelDB; diff --git a/camel/camel-utf8.c b/camel/camel-utf8.c index 4e6da152f..fcdb268f0 100644 --- a/camel/camel-utf8.c +++ b/camel/camel-utf8.c @@ -405,6 +405,8 @@ gchar *camel_ucs2_utf8(const gchar *ptr) * * Ensures the returned text will be valid UTF-8 string, with incorrect letters * changed to question marks. Returned pointer should be freed with g_free. + * + * Since: 2.26 **/ gchar * camel_utf8_make_valid (const gchar *text) diff --git a/camel/camel-vee-folder.c b/camel/camel-vee-folder.c index e98fe83fb..bed7690df 100644 --- a/camel/camel-vee-folder.c +++ b/camel/camel-vee-folder.c @@ -2194,6 +2194,11 @@ camel_vee_folder_init (CamelVeeFolder *obj) p->unread_vfolder = -1; } +/** + * camel_vee_folder_mask_event_folder_changed: + * + * Since: 2.26 + **/ void camel_vee_folder_mask_event_folder_changed (CamelVeeFolder *vf, CamelFolder *sub) { @@ -2201,6 +2206,11 @@ camel_vee_folder_mask_event_folder_changed (CamelVeeFolder *vf, CamelFolder *sub } +/** + * camel_vee_folder_unmask_event_folder_changed: + * + * Since: 2.26 + **/ void camel_vee_folder_unmask_event_folder_changed (CamelVeeFolder *vf, CamelFolder *sub) { diff --git a/camel/camel-vee-summary.c b/camel/camel-vee-summary.c index 20e88f8cf..6303a7635 100644 --- a/camel/camel-vee-summary.c +++ b/camel/camel-vee-summary.c @@ -196,6 +196,11 @@ vee_info_set_user_tag(CamelMessageInfo *mi, const gchar *name, const gchar *valu return res; } +/** + * camel_vee_summary_load_check_unread_vfolder: + * + * Since: 2.26 + **/ void camel_vee_summary_load_check_unread_vfolder (CamelVeeSummary *vs) { |