From: Daniel Boles <dboles@src.gnome.org>
Date: Sun, 3 Sep 2017 09:39:58 +0000 (+0100)
Subject: ToolItem: Annotate menu proxy item as nullable
X-Git-Tag: archive/raspbian/3.24.39-1+rpi1~1^2~65^2~39^2~236
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=ea73e0e0bd19daec8eaccdab1fb1d46adfa6a69f;p=gtk%2B3.0.git

ToolItem: Annotate menu proxy item as nullable

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.
---

diff --git a/gtk/gtktoolitem.c b/gtk/gtktoolitem.c
index c877985496..9d145918f6 100644
--- a/gtk/gtktoolitem.c
+++ b/gtk/gtktoolitem.c
@@ -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
  *