im.pidgin.pidgin.next.minor: 172a59b41412c4630834d66f2e7ec3be970cc36b

[sadrul at pidgin.im]

-----------------------------------------------------------------
Revision: 172a59b41412c4630834d66f2e7ec3be970cc36b
Ancestor: 611e4adf0f1fd845d9ac7c023fc62454d67218bb
Author: sadrul at pidgin.im
Date: 2007-10-16T11:05:59
Branch: im.pidgin.pidgin.next.minor

Modified files:
        ChangeLog ChangeLog.API finch/libgnt/gntmenu.h
        finch/libgnt/gntmenuitem.h finch/libgnt/gntwindow.h

ChangeLog: 

Missing changelog entries and @since tags from 3f567df17490f68b4feb8cf26ad004a34eb7cc9a.

-------------- next part --------------
============================================================
--- ChangeLog	8baf52de7aacf0058bf3dc5634ebec03eaf33606
+++ ChangeLog	9134b2057a1dfb42e9b6fea564694d43d7f8089b
@@ -20,6 +20,8 @@ version 2.3.0:
 	  remove the plugin from the list of saved plugins so it won't load
 	  at the next startup.  Previously, we were ignoring this case, which
 	  could lead to crashes.
+	* It's possible to bind key-strokes to specific menuitems in the windows.
+	  Read the 'Menus' section in the man-page for details.
 
 version 2.2.2:
 	http://developer.pidgin.im/query?status=closed&milestone=2.2.2
============================================================
--- ChangeLog.API	b8a05906963b42ca84e963a565403d5dd055a2c6
+++ ChangeLog.API	f7b5a6570ae0ba270ca65e251e483594318cfdfa
@@ -98,6 +98,12 @@ version 2.3.0 (??/??/????):
 		  attributes in place of colors if the terminal doesn't have color
 		  support. (Bug: #3560) All future code should use gnt_color_pair
 		  instead of COLOR_PAIR.
+		* Added gnt_menuitem_set_id and gnt_menuitem_get_id to set and get the
+		  string id of a menuitem respectively.
+		* Added gnt_window_get_accel_item, which returns a the id of a menuitem
+		  bound to a keystroke.
+		* Added gnt_menu_get_item to activate and return a menuitem of the
+		  given id from a menu.
 
 version 2.2.2 (??/??/????):
 	libpurple:
============================================================
--- finch/libgnt/gntmenu.h	4042008822dbb614779b75acbc98ed65a9275fb7
+++ finch/libgnt/gntmenu.h	25dd6cd572d092f0d3d0641f2984d081a3664238
@@ -108,12 +108,14 @@ void gnt_menu_add_item(GntMenu *menu, Gn
 void gnt_menu_add_item(GntMenu *menu, GntMenuItem *item);
 
 /**
- * Get the GntMenuItem with the given ID.
+ * Activate and return the GntMenuItem with the given ID.
  *
  * @param menu   The menu.
  * @param id     The ID for an item.
  *
  * @return  The menuitem with the given ID, or @c NULL.
+ *
+ * @since 2.3.0
  */
 GntMenuItem *gnt_menu_get_item(GntMenu *menu, const char *id);
 
============================================================
--- finch/libgnt/gntmenuitem.h	fb8f71b4853e6e9782347cf406e0ebd8ecffad93
+++ finch/libgnt/gntmenuitem.h	d9355e4ae960318b710bef839b16ec4fee8d15fc
@@ -123,6 +123,8 @@ void gnt_menuitem_set_submenu(GntMenuIte
  * @param item   The menuitem.
  *
  * @return  The submenu, or @c NULL.
+ *
+ * @since 2.3.0
  */
 GntMenu *gnt_menuitem_get_submenu(GntMenuItem *item);
 
@@ -150,6 +152,8 @@ char gnt_menuitem_get_trigger(GntMenuIte
  *
  * @param item   The menuitem.
  * @param id     The ID for the menuitem.
+ *
+ * @since 2.3.0
  */
 void gnt_menuitem_set_id(GntMenuItem *item, const char *id);
 
@@ -159,6 +163,8 @@ void gnt_menuitem_set_id(GntMenuItem *it
  * @param item   The menuitem.
  *
  * @return  The ID for the menuitem.
+ *
+ * @since 2.3.0
  */
 const char * gnt_menuitem_get_id(GntMenuItem *item);
 
============================================================
--- finch/libgnt/gntwindow.h	057e195dca53dfe273728cc71ff93ae263b4d825
+++ finch/libgnt/gntwindow.h	f3445f58f66037fb1539b11e43f13aea91856bf5
@@ -68,9 +68,7 @@ G_BEGIN_DECLS
 G_BEGIN_DECLS
 
 /**
- * 
- *
- * @return
+ * @return  GType for GntWindow.
  */
 GType gnt_window_get_gtype(void);
 
@@ -78,28 +76,40 @@ GType gnt_window_get_gtype(void);
 #define gnt_hwindow_new(homo) gnt_window_box_new(homo, FALSE)
 
 /**
- * 
+ * Create a new window.
  *
- * @return
+ * @return The newly created window.
  */
 GntWidget * gnt_window_new(void);
 
 /**
- * 
- * @param homo
- * @param vert
+ * Create a new window.
  *
- * @return
+ * @param homo  @c TRUE if the widgets inside the window should have the same dimensions.
+ * @param vert  @c TRUE if the widgets inside the window should be stacked vertically.
+ *
+ * @return  The newly created window.
  */
 GntWidget * gnt_window_box_new(gboolean homo, gboolean vert);
 
 /**
- * 
- * @param window
- * @param menu
+ * Set the menu for a window.
+ *
+ * @param window  The window.
+ * @param menu    The menu for the window.
  */
 void gnt_window_set_menu(GntWindow *window, GntMenu *menu);
 
+/**
+ * Return the id of a menuitem specified to a keystroke.
+ *
+ * @param window    The window.
+ * @param key       The keystroke.
+ *
+ * @return The id of the menuitem bound to the keystroke, or @c NULL.
+ *
+ * @since 2.3.0
+ */
 const char * gnt_window_get_accel_item(GntWindow *window, const char *key);
 
 void gnt_window_workspace_hiding(GntWindow *);