Update the documentation to mark the optional constructors parameters. The

2007-09-09  Matthias Clasen  <mclasen@redhat.com>

        * gtk/gtkaction.c:
        * gtk/gtkradioaction.c:
        * gtk/gtkrecentaction.c:
        * gtk/gtktoggleaction.c: Update the documentation to mark
        the optional constructors parameters. The GtkAction::name
        property is required, instead, as it is used by GtkUIManager
        to find the action object from the XML. (#450032, Murray Cumming,
        patch by Emmanuele Bassi)



svn path=/trunk/; revision=18773
This commit is contained in:
Matthias Clasen 2007-09-09 20:18:24 +00:00 committed by Matthias Clasen
parent c87cfa8afd
commit 8fb6c039bb
5 changed files with 62 additions and 46 deletions

View File

@ -1,3 +1,14 @@
2007-09-09 Matthias Clasen <mclasen@redhat.com>
* gtk/gtkaction.c:
* gtk/gtkradioaction.c:
* gtk/gtkrecentaction.c:
* gtk/gtktoggleaction.c: Update the documentation to mark
the optional constructors parameters. The GtkAction::name
property is required, instead, as it is used by GtkUIManager
to find the action object from the XML. (#450032, Murray Cumming,
patch by Emmanuele Bassi)
2007-09-09 Matthias Clasen <mclasen@redhat.com>
* modules/printbackends/lpr/gtkprintbackendlpr.c:

View File

@ -414,9 +414,10 @@ gtk_action_buildable_get_name (GtkBuildable *buildable)
/**
* gtk_action_new:
* @name: A unique name for the action
* @label: the label displayed in menu items and on buttons
* @tooltip: a tooltip for the action
* @stock_id: the stock icon to display in widgets representing the action
* @label: the label displayed in menu items and on buttons, or %NULL
* @tooltip: a tooltip for the action, or %NULL
* @stock_id: the stock icon to display in widgets representing the
* action, or %NULL
*
* Creates a new #GtkAction object. To add the action to a
* #GtkActionGroup and set the accelerator for the action,
@ -434,16 +435,14 @@ gtk_action_new (const gchar *name,
const gchar *tooltip,
const gchar *stock_id)
{
GtkAction *action;
g_return_val_if_fail (name != NULL, NULL);
action = g_object_new (GTK_TYPE_ACTION,
"name", name,
"label", label,
"tooltip", tooltip,
"stock-id", stock_id,
NULL);
return action;
return g_object_new (GTK_TYPE_ACTION,
"name", name,
"label", label,
"tooltip", tooltip,
"stock-id", stock_id,
NULL);
}
static void

View File

@ -181,11 +181,12 @@ gtk_radio_action_init (GtkRadioAction *action)
/**
* gtk_radio_action_new:
* @name: A unique name for the action
* @label: The label displayed in menu items and on buttons
* @tooltip: A tooltip for this action
* @stock_id: The stock icon to display in widgets representing this action
* @value: The value which gtk_radio_action_get_current_value() should return
* if this action is selected.
* @label: The label displayed in menu items and on buttons, or %NULL
* @tooltip: A tooltip for this action, or %NULL
* @stock_id: The stock icon to display in widgets representing this
* action, or %NULL
* @value: The value which gtk_radio_action_get_current_value() should
* return if this action is selected.
*
* Creates a new #GtkRadioAction object. To add the action to
* a #GtkActionGroup and set the accelerator for the action,
@ -202,17 +203,15 @@ gtk_radio_action_new (const gchar *name,
const gchar *stock_id,
gint value)
{
GtkRadioAction *action;
g_return_val_if_fail (name != NULL, NULL);
action = g_object_new (GTK_TYPE_RADIO_ACTION,
"name", name,
"label", label,
"tooltip", tooltip,
"stock-id", stock_id,
"value", value,
NULL);
return action;
return g_object_new (GTK_TYPE_RADIO_ACTION,
"name", name,
"label", label,
"tooltip", tooltip,
"stock-id", stock_id,
"value", value,
NULL);
}
static void

View File

@ -688,9 +688,10 @@ gtk_recent_action_init (GtkRecentAction *action)
/**
* gtk_recent_action_new:
* @name: a unique name for the action
* @label: the label displayed in menu items and on buttons
* @tooltip: a tooltip for the action
* @stock_id: the stock icon to display in widgets representing the action
* @label: the label displayed in menu items and on buttons, or %NULL
* @tooltip: a tooltip for the action, or %NULL
* @stock_id: the stock icon to display in widgets representing the
* action, or %NULL
*
* Creates a new #GtkRecentAction object. To add the action to
* a #GtkActionGroup and set the accelerator for the action,
@ -706,6 +707,8 @@ gtk_recent_action_new (const gchar *name,
const gchar *tooltip,
const gchar *stock_id)
{
g_return_val_if_fail (name != NULL, NULL);
return g_object_new (GTK_TYPE_RECENT_ACTION,
"name", name,
"label", label,
@ -717,10 +720,12 @@ gtk_recent_action_new (const gchar *name,
/**
* gtk_recent_action_new_for_manager:
* @name: a unique name for the action
* @label: the label displayed in menu items and on buttons
* @tooltip: a tooltip for the action
* @stock_id: the stock icon to display in widgets representing the action
* @manager: a #GtkRecentManager or %NULL
* @label: the label displayed in menu items and on buttons, or %NULL
* @tooltip: a tooltip for the action, or %NULL
* @stock_id: the stock icon to display in widgets representing the
* action, or %NULL
* @manager: a #GtkRecentManager, or %NULL for using the default
* #GtkRecentManager
*
* Creates a new #GtkRecentAction object. To add the action to
* a #GtkActionGroup and set the accelerator for the action,
@ -737,6 +742,9 @@ gtk_recent_action_new_for_manager (const gchar *name,
const gchar *stock_id,
GtkRecentManager *manager)
{
g_return_val_if_fail (name != NULL, NULL);
g_return_val_if_fail (manager == NULL || GTK_IS_RECENT_MANAGER (manager), NULL);
return g_object_new (GTK_TYPE_RECENT_ACTION,
"name", name,
"label", label,

View File

@ -143,9 +143,10 @@ gtk_toggle_action_init (GtkToggleAction *action)
/**
* gtk_toggle_action_new:
* @name: A unique name for the action
* @label: The label displayed in menu items and on buttons
* @tooltip: A tooltip for the action
* @stock_id: The stock icon to display in widgets representing the action
* @label: The label displayed in menu items and on buttons, or %NULL
* @tooltip: A tooltip for the action, or %NULL
* @stock_id: The stock icon to display in widgets representing the
* action, or %NULL
*
* Creates a new #GtkToggleAction object. To add the action to
* a #GtkActionGroup and set the accelerator for the action,
@ -161,16 +162,14 @@ gtk_toggle_action_new (const gchar *name,
const gchar *tooltip,
const gchar *stock_id)
{
GtkToggleAction *action;
g_return_val_if_fail (name != NULL, NULL);
action = g_object_new (GTK_TYPE_TOGGLE_ACTION,
"name", name,
"label", label,
"tooltip", tooltip,
"stock-id", stock_id,
NULL);
return action;
return g_object_new (GTK_TYPE_TOGGLE_ACTION,
"name", name,
"label", label,
"tooltip", tooltip,
"stock-id", stock_id,
NULL);
}
static void