* po/:
[modest] / src / modest-text-utils.h
index e294442..cd693cc 100644 (file)
@@ -193,15 +193,25 @@ gint modest_text_utils_utf8_strcmp (const gchar* s1, const gchar *s2, gboolean i
  *
  * 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 (gint size);
+
+
+/**
  * modest_text_utils_validate_email_address:
  * @email_address: a string
  *