add new "is_important" property

Fri Aug  1 15:26:46 2003  Soeren Sandmann  <sandmann@daimi.au.dk>

	* gtk/gtktoolbar.c, gtk/toolitem.c: add new "is_important"
	property

	* gtk/gtkradiotoolbutton.c
	(gtk_radio_tool_button_new_from_widget): Don't take a stock id

	* gtk/gtkradiotoolbutton.c
	(gtk_radio_tool_button_new_with_stock_from_widget): make this
	function take a stock_id.

	* gtk/toolbar: documentation

1 files changed, 70 insertions, 5 deletions

diff --git a/gtk/gtkradiotoolbutton.c b/gtk/gtkradiotoolbutton.c
index 8f7471a598..8f9d4e94e8 100644
--- a/gtk/gtkradiotoolbutton.c
+++ b/gtk/gtkradiotoolbutton.c
@@ -71,6 +71,16 @@ gtk_radio_tool_button_init (GtkRadioToolButton *button)
   gtk_toggle_button_set_mode (GTK_TOGGLE_BUTTON (_gtk_tool_button_get_button (tool_button)), FALSE);
 }
 
+/**
+ * gtk_radio_tool_button_new:
+ * @group: An existing radio button group, or %NULL if you are creating a new group
+ * 
+ * Creates a new #GtkRadioToolButton, adding it to @group.
+ * 
+ * Return value: The new #GtkRadioToolButton
+ * 
+ * Since: 2.4
+ **/
 GtkToolItem *
 gtk_radio_tool_button_new (GSList *group)
 {
@@ -84,6 +94,19 @@ gtk_radio_tool_button_new (GSList *group)
   return GTK_TOOL_ITEM (button);
 }
 
+/**
+ * gtk_radio_tool_button_new_from_stock:
+ * @group: an existing radio button group, or %NULL if you are creating a new group
+ * @stock_id: the name of a stock item
+ * 
+ * Creates a new #GtkRadioToolButton, adding it to @group. 
+ * The new #GtkRadioToolButton will contain an icon and label from the
+ * stock item indicated by @stock_id.
+ * 
+ * Return value: The new #GtkRadioToolItem
+ * 
+ * Since: 2.4
+ **/
 GtkToolItem *
 gtk_radio_tool_button_new_from_stock (GSList      *group,
 				      const gchar *stock_id)
@@ -102,9 +125,18 @@ gtk_radio_tool_button_new_from_stock (GSList      *group,
   return GTK_TOOL_ITEM (button);
 }
 
+/**
+ * gtk_radio_tool_button_new_from_widget:
+ * @group: An existing #GtkRadioToolButton
+ * 
+ * Creates a new #GtkRadioToolButton adding it to the same group as @gruup
+ * 
+ * Return value: The new #GtkRadioToolButton
+ * 
+ * Since: 2.4
+ **/
 GtkToolItem *
-gtk_radio_tool_button_new_from_widget (GtkWidget   *group,
-				       const gchar *stock_id)
+gtk_radio_tool_button_new_from_widget (GtkWidget   *group)
 {
   GSList *list = NULL;
   
@@ -113,11 +145,25 @@ gtk_radio_tool_button_new_from_widget (GtkWidget   *group,
   if (group)
     list = gtk_radio_tool_button_get_group (GTK_RADIO_TOOL_BUTTON (group));
   
-  return gtk_radio_tool_button_new_from_stock (list, stock_id);
+  return gtk_radio_tool_button_new (list);
 }
 
+/**
+ * gtk_radio_tool_button_new_with_stock_from_widget:
+ * @group: An existing #GtkRadioToolButton.
+ * @stock_id: the name of a stock item 
+ * 
+ * Creates a new #GtkRadioToolButton adding it to the same group as @group.
+ * The new #GtkRadioToolButton will contain an icon and label from the
+ * stock item indicated by @stock_id.
+ * 
+ * Return value: A new #GtkRadioToolButton
+ * 
+ * Since: 2.4
+ **/
 GtkToolItem *
-gtk_radio_tool_button_new_with_stock_from_widget (GtkWidget *group)
+gtk_radio_tool_button_new_with_stock_from_widget (GtkWidget   *group,
+						  const gchar *stock_id)
 {
   GSList *list = NULL;
   
@@ -126,7 +172,7 @@ gtk_radio_tool_button_new_with_stock_from_widget (GtkWidget *group)
   if (group)
     list = gtk_radio_tool_button_get_group (GTK_RADIO_TOOL_BUTTON (group));
   
-  return gtk_radio_tool_button_new (list);
+  return gtk_radio_tool_button_new_from_stock (list, stock_id);
 }
 
 static GtkRadioButton *
@@ -135,6 +181,16 @@ get_radio_button (GtkRadioToolButton *button)
   return GTK_RADIO_BUTTON (_gtk_tool_button_get_button (GTK_TOOL_BUTTON (button)));
 }
 
+/**
+ * gtk_radio_tool_button_get_group:
+ * @button: a #GtkRadioToolButton
+ *
+ * Returns the radio button group @button belongs to.
+ * 
+ * Return value: The group @button belongs to.
+ * 
+ * Since: 2.4
+ **/
 GSList *
 gtk_radio_tool_button_get_group (GtkRadioToolButton *button)
 {
@@ -143,6 +199,15 @@ gtk_radio_tool_button_get_group (GtkRadioToolButton *button)
   return gtk_radio_button_get_group (get_radio_button (button));
 }
 
+/**
+ * gtk_radio_tool_button_set_group:
+ * @button: a #GtkRadioToolButton
+ * @group: an existing radio button group
+ * 
+ * Adds @button to @group, removing it from the group it belonged to before.
+ * 
+ * Since: 2.4
+ **/
 void
 gtk_radio_tool_button_set_group (GtkRadioToolButton *button,
 				 GSList             *group)