GtkToolItem tooltips problem

[Jeff Franks <adsln7hl tpg com au>]

The gtk_tool_item_set_tooltip() function doesn't seem like a good API 
choice for setting tooltips on tool items in a toolbar. This function 
just rearranges the arguments and calls gtk_tooltips_set_tip() to set 
the tooltip.

The problem is that for the gtk_toolbar_set_tooltips() function to work 
the tooltips object has to be GtkToolbar::tooltips in _GtkToolbar. This 
is because gtk_toolbar_set_tooltips() enables and disables the 
GtkToolbar::tooltips object. If the tooltips argument to 
gtk_tool_item_set_tooltip() is a different tooltips object 
gtk_toolbar_set_tooltips() wont work. The documentation doesn't state 
this anywhere.

Wouldn't something like this function have been a better choice:

void
gtk_toolbar_set_tooltip(GtkToolbar *toolbar,
                        GtkToolItem *tool_item,
                        const gchar *tip_text,
                        const gchar *tip_private);


Regards,
Jeff Franks.