From b5cc0d8fcd147246f0769eaae2c1ce890be4ad5c Mon Sep 17 00:00:00 2001 From: Daniel Boles Date: Tue, 17 Apr 2018 19:53:33 +0100 Subject: [PATCH] Menu: Document/annotate nullability of 2 API args MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit .set_accel_path(): Use (nullable) instead of (allow-none), and explain what a NULL means (albeit very briefly) .set_title(): Annotate @title as (nullable), and explain NULL’s meaning --- gtk/gtkmenu.c | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/gtk/gtkmenu.c b/gtk/gtkmenu.c index 9f82f129fb..7704ddc65e 100644 --- a/gtk/gtkmenu.c +++ b/gtk/gtkmenu.c @@ -2726,7 +2726,7 @@ gtk_menu_real_can_activate_accel (GtkWidget *widget, /** * gtk_menu_set_accel_path: * @menu: a valid #GtkMenu - * @accel_path: (allow-none): a valid accelerator path + * @accel_path: (nullable): a valid accelerator path, or %NULL to unset the path * * Sets an accelerator path for this menu from which accelerator paths * for its immediate children, its menu items, can be constructed. @@ -3086,7 +3086,8 @@ gtk_menu_get_tearoff_state (GtkMenu *menu) /** * gtk_menu_set_title: * @menu: a #GtkMenu - * @title: a string containing the title for the menu + * @title: (nullable): a string containing the title for the menu, or %NULL to + * inherit the title of the parent menu item, if any * * Sets the title string for the menu. *