diff src/savedstatuses.h @ 12690:d03afaccd41c

[gaim-migrate @ 15033] Make the popular status docklet menu items actually do something. Strip html and newlines from the titles of saved-statuses when displaying them in the docklet menu. Add a 'gaim_savedstatus_find_by_creation_time()' function. Sadrul: you'll probably want to use this when you add popular statuses to the status box. committer: Tailor Script <[e-mail]>

--- a/src/savedstatuses.h	Tue Jan 03 04:44:08 2006 +0000
+++ b/src/savedstatuses.h	Tue Jan 03 05:23:01 2006 +0000
@@ -191,6 +191,16 @@
 GaimSavedStatus *gaim_savedstatus_find(const char *title);
 
 /**
+ * Finds a saved status with the specified creation time.
+ *
+ * @param creation_time The timestamp when the saved
+ *        status was created.
+ *
+ * @return The saved status if found, or NULL.
+ */
+GaimSavedStatus *gaim_savedstatus_find_by_creation_time(time_t creation_time);
+
+/**
  * Determines if a given saved status is "transient."
  * A transient saved status is one that was not
  * explicitly added by the user.  Transient statuses
@@ -214,7 +224,10 @@
  *
  * @param saved_status The saved status.
  *
- * @return The title.
+ * @return The title.  This value may be a static buffer which may
+ *         be overwritten on subsequent calls to this function.  If
+ *         you need a reference to the title for prolonged use then
+ *         you should make a copy of it.
  */
 const char *gaim_savedstatus_get_title(const GaimSavedStatus *saved_status);