* @s:
* @max:
* @fmt:
- * @tm
+ * @timet:
*
* this is just an alias for strftime(3), so we can use that without
* getting warning from gcc
*
* Returns: a formatted string of max length @max in @s
*/
-size_t modest_text_utils_strftime(char *s, size_t max, const char *fmt, const struct tm *tm);
+size_t modest_text_utils_strftime(char *s, size_t max, const char *fmt, time_t timet);
*
* Returns: the length of the prefix, or 0 if there is none
*/
-gint modest_text_utils_get_subject_prefix_len (const gchar *sub);
+gint modest_text_utils_get_subject_prefix_len (const gchar *subject);
/**
*
* get a string representation for a date.
*
- *
- * Returns: the new display date. The string is *not* newly allocated,
- * but is a static buffer (for optimization reasons). Therefore, when
- * you call this function, you will loose the data.
+ * Returns: the new display date, as a constant string.
+ * must NOT be freed
*/
const gchar* modest_text_utils_get_display_date (time_t date);
+
+/**
+ * modest_text_utils_get_display_size:
+ * @size: size in bytes
+ *
+ * get a string representation for a size in bytes.
+ *
+ * Returns: the newly allocated display string for the
+ * size in bytes. must be freed.
+ */
+gchar * modest_text_utils_get_display_size (guint size);
+
+
+/**
+ * modest_text_utils_validate_email_address:
+ * @email_address: a string
+ *
+ * validates the email address passed as argument
+ *
+ * Returns: TRUE if the address is valid, FALSE otherwise
+ **/
+gboolean modest_text_utils_validate_email_address (const gchar *email_address);
+
#endif /* __MODEST_TEXT_UTILS_H__ */