[gtk+] GtkApplication Docs: Add a hint.



commit c00cfda370e8afb0d1f69b8a1091cae7150305d3
Author: Murray Cumming <murrayc murrayc com>
Date:   Wed Mar 28 11:26:22 2012 +0200

    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 files changed, 6 insertions(+), 2 deletions(-)
---
diff --git a/gtk/gtkapplication.c b/gtk/gtkapplication.c
index 3513c71..30c17b5 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.
  *



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]