ToolItem: Annotate menu proxy item as nullable
authorDaniel Boles <dboles@src.gnome.org>
Sun, 3 Sep 2017 09:39:58 +0000 (10:39 +0100)
committerDaniel Boles <dboles@src.gnome.org>
Sun, 3 Sep 2017 09:58:58 +0000 (10:58 +0100)
It can be NULL. ::create-menu-proxy gave an example of when a NULL proxy
menu item could be useful, but the accessors did not annotate it as such.

gtk/gtktoolitem.c

index c877985496df4a3d6df1f55bad27ac0b6f451661..9d145918f627dde36d336b56c0e27d400cc18816 100644 (file)
@@ -1299,7 +1299,7 @@ gtk_tool_item_retrieve_proxy_menu_item (GtkToolItem *tool_item)
  * @menu_item_ids must match ensures that a #GtkToolItem
  * will not inadvertently change a menu item that they did not create.
  *
- * Returns: (transfer none): The #GtkMenuItem passed to
+ * Returns: (transfer none) (nullable): The #GtkMenuItem passed to
  *     gtk_tool_item_set_proxy_menu_item(), if the @menu_item_ids
  *     match.
  *
@@ -1349,7 +1349,7 @@ gtk_tool_item_rebuild_menu (GtkToolItem *tool_item)
 
 /**
  * gtk_tool_item_set_proxy_menu_item:
- * @tool_item: a #GtkToolItem
+ * @tool_item: (nullable): a #GtkToolItem
  * @menu_item_id: a string used to identify @menu_item
  * @menu_item: a #GtkMenuItem to be used in the overflow menu
  *