#include <time.h>
#include <glib.h>
+#define _FM(str) dgettext("hildon-fm",str)
+
/**
* modest_text_utils_derived_subject:
* @subject: a string which contains the original subject
* ie. removes "<...>" and "(...)" parts
* the change is in-place; removes leading/trailing whitespace
*
- * Returns: the new address. The string is *not* newly allocated.
- * NULL in case of error
+ * Returns: the new address of the string; this new string
+ * is _NOT_ newly allocated, so should not be freed. (remember
+ * the old address of the parameter if that one needs to be freed)
+ *
+ * NULL in case of error or if address == NULL
*/
gchar* modest_text_utils_get_display_address (gchar *address);
* Returns: the newly allocated display string for the
* size in bytes. must be freed.
*/
-gchar * modest_text_utils_get_display_size (guint size);
+gchar * modest_text_utils_get_display_size (guint64 size);
/**
**/
GSList *modest_text_utils_split_addresses_list (const gchar *addresses);
+/**
+ * modest_text_utils_get_addresses_indexes:
+ * @addresses: a string
+ * @start_indexes: a #GSList pointer
+ * @end_indexes: a #GSList pointer
+ *
+ * obtains two #GSList of @addresses with the range offsets of the addresses in
+ * the string
+ *
+ * Returns: a GSList of strings
+ **/
+void modest_text_utils_get_addresses_indexes (const gchar *addresses, GSList **start_indexes, GSList **end_indexes);
+
#endif /* __MODEST_TEXT_UTILS_H__ */