diff src/savedstatuses.h @ 12688:473c23442a36

[gaim-migrate @ 15031] Add the notion of "popular" saved statuses. This lets us show 6 recently used/popular statuses in the context menu for the docklet. Eventually I'll add the same list to the status box--but that's a little more work. If someone else wants to tackle it before I have a chance to feel free (and let me know!) Does this look ok to everyone (the docklet menu changes)? Would it be better if it was a submenu? Or if it was labeled? It'd be cool if the icons reflected the status. Oh, and I just remembered that the menu items don't actually work yet... but that's not too hard, I think I can get to that tonight committer: Tailor Script <[e-mail]>

--- a/src/savedstatuses.h	Tue Jan 03 01:19:32 2006 +0000
+++ b/src/savedstatuses.h	Tue Jan 03 01:25:06 2006 +0000
@@ -152,6 +152,21 @@
 const GList *gaim_savedstatuses_get_all(void);
 
 /**
+ * Returns the n most popular saved statuses.  "Popularity" is
+ * determined by when the last time a saved_status was used and
+ * how many times it has been used.
+ *
+ * @param how_many The maximum number of saved statuses
+ *                 to return, or '0' to get all saved
+ *                 statuses sorted by popularity.
+ * @return A linked list containing at most how_many
+ *         GaimSavedStatuses.  This list should be
+ *         g_list_free'd by the caller (but the
+ *         GaimSavedStatuses must not be free'd).
+ */
+GList *gaim_savedstatuses_get_popular(unsigned int how_many);
+
+/**
  * Returns the currently selected saved status.
  *
  * @return A pointer to the in-use GaimSavedStatus.