From c00cfda370e8afb0d1f69b8a1091cae7150305d3 Mon Sep 17 00:00:00 2001 From: Murray Cumming Date: Wed, 28 Mar 2012 11:26:22 +0200 Subject: [PATCH] GtkApplication Docs: Add a hint. gtk_application_set_app_menu(), gtk_application_set_menubar(): Mention that you probably want to call this in the startup signal handler. If you do it earlier you will likely get a warning about a missing D-Bus connection, because doing it earlier does not make sense anyway. --- gtk/gtkapplication.c | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/gtk/gtkapplication.c b/gtk/gtkapplication.c index 3513c71199..30c17b550b 100644 --- a/gtk/gtkapplication.c +++ b/gtk/gtkapplication.c @@ -784,8 +784,8 @@ gtk_application_class_init (GtkApplicationClass *class) * as soon as the application gets registered as the primary instance. * * Concretely, gtk_init() is called in the default handler for the - * startup() signal. Therefore, #GtkApplication subclasses should - * chain up in their startup() handler before using any GTK+ API. + * #GApplication:startup signal. Therefore, #GtkApplication subclasses should + * chain up in their #GApplication:startup handler before using any GTK+ API. * * Note that commandline arguments are not passed to gtk_init(). * All GTK+ functionality that is available via commandline arguments @@ -1008,6 +1008,8 @@ gtk_application_remove_accelerator (GtkApplication *application, * If supported, the application menu will be rendered by the desktop * environment. * + * You might call this method in your #GApplication:startup signal handler. + * * Use the base #GActionMap interface to add actions, to respond to the user * selecting these menu items. * @@ -1075,6 +1077,8 @@ gtk_application_get_app_menu (GtkApplication *application) * example, the application menu may be rendered by the desktop shell * while the menubar (if set) remains in each individual window. * + * You might call this method in your #GApplication:startup signal handler. + * * Use the base #GActionMap interface to add actions, to respond to the user * selecting these menu items. *