]> Pileus Git - ~andy/gtk/blobdiff - gtk/gtkactionable.c
treeview: Don't emit cursor-changed in destruction
[~andy/gtk] / gtk / gtkactionable.c
index f49cd70318bf0e53194cd11332f18fc701e8e0f9..dfb33d084ede530580520cee2063b243ef94afe4 100644 (file)
@@ -1,7 +1,7 @@
 /*
  * Copyright © 2012 Canonical Limited
  *
- * This program is free software: you can redistribute it and/or modify
+ * This library is free software: you can redistribute it and/or modify
  * it under the terms of the GNU Lesser General Public License as
  * published by the Free Software Foundation; either version 2 of the
  * licence or (at your option) any later version.
@@ -12,9 +12,7 @@
  * Lesser General Public License for more details.
  *
  * You should have received a copy of the GNU Lesser General Public
- * License along with this library; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307,
- * USA.
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
  *
  * Authors: Ryan Lortie <desrt@desrt.ca>
  */
 /**
  * SECTION:gtkactionable
  * @title: GtkActionable
- * @short_description: an interface for widgets that can be associated
- *                     with actions
+ * @short_description: An interface for widgets that can be associated
+ *     with actions
  *
  * This interface provides a convenient way of associating widgets with
  * actions on a #GtkApplicationWindow or #GtkApplication.
  *
- * It primarily consists of two properties: "action-name" and
- * "action-target".  There are also some convenience APIs for setting
- * these properties.
+ * It primarily consists of two properties: #GtkActionable:action-name
+ * and #GtkActionable:action-target. There are also some convenience APIs
+ * for setting these properties.
  *
  * This interface is presently only meaningful if used on a widget that
  * is (or will be) located inside of a #GtkApplicationWindow and can
@@ -55,9 +53,9 @@
 
 /**
  * GtkActionableInterface:
- * @get_action_name: virtual pointer for gtk_actionable_get_action_name
- * @set_action_name: virtual pointer for gtk_actionable_set_action_name
- * @get_action_target_value: virtual pointer for gtk_actionable_get_action_target_value
+ * @get_action_name: virtual pointer for gtk_actionable_get_action_name()
+ * @set_action_name: virtual pointer for gtk_actionable_set_action_name()
+ * @get_action_target_value: virtual pointer for gtk_actionable_get_action_target_value()
  * @set_action_target_value: virtual pointer for gtk_actionable_set_action_target_value
  *
  * The interface vtable for #GtkActionable.
@@ -135,7 +133,7 @@ gtk_actionable_set_action_name (GtkActionable *actionable,
  *
  * Gets the current target value of @actionabe.
  *
- * See gtk_actionable_set_target_value() for more information.
+ * See gtk_actionable_set_action_target_value() for more information.
  *
  * Returns: (transfer none): the current target value
  *
@@ -161,8 +159,8 @@ gtk_actionable_get_action_target_value (GtkActionable *actionable)
  *
  * The target value has two purposes.  First, it is used as the
  * parameter to activation of the action associated with the
- * #GtkActionable widget.  Second, it is used to determine if the widget
- * should be rendered as "active" -- the widget is active if the state
+ * #GtkActionable widget. Second, it is used to determine if the widget
+ * should be rendered as "active" - the widget is active if the state
  * is equal to the given target.
  *
  * Consider the example of associating a set of buttons with a #GAction
@@ -226,8 +224,8 @@ gtk_actionable_set_action_target (GtkActionable *actionable,
  * actionable widget.
  *
  * This allows for the effect of both gtk_actionable_set_action_name()
- * and gtk_actionable_set_target() in the common case that the target is
- * string-valued.
+ * and gtk_actionable_set_action_target_value() in the common case that
+ * the target is string-valued.
  *
  * @detailed_action_name is a string of the form
  * <literal>"action::target"</literal> where <literal>action</literal>