From e7d6400149e05d6f9643c33292b5e9d18bfb6b53 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Tue, 24 Jan 2012 22:22:08 -0500 Subject: [PATCH] GtkApplication: documentation additions Document that startup() needs to chain up first. --- gtk/gtkapplication.c | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/gtk/gtkapplication.c b/gtk/gtkapplication.c index d2aabc432..110901575 100644 --- a/gtk/gtkapplication.c +++ b/gtk/gtkapplication.c @@ -104,7 +104,7 @@ * * * GtkApplication optionally registers with a session manager - * of the users session (if you set the #GtkApplication::register-session + * of the users session (if you set the #GtkApplication:register-session * property) and offers various functionality related to the session * life-cycle. * @@ -767,7 +767,7 @@ gtk_application_class_init (GtkApplicationClass *class) * applications a chance to object. * * To receive this signal, you need to set the - * #GtkApplication::register-session property + * #GtkApplication:register-session property * when creating the application object. * * Since: 3.4 @@ -778,7 +778,7 @@ gtk_application_class_init (GtkApplicationClass *class) NULL, NULL, g_cclosure_marshal_VOID__VOID, G_TYPE_NONE, 0); /** - * GtkApplication::register-session: + * GtkApplication:register-session: * * Set this property to %TRUE to register with the session manager * and receive the #GtkApplication::quit signal when the session @@ -817,6 +817,10 @@ gtk_application_class_init (GtkApplicationClass *class) * This function calls g_type_init() for you. gtk_init() is called * 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. + * * Note that commandline arguments are not passed to gtk_init(). * All GTK+ functionality that is available via commandline arguments * can also be achieved by setting suitable environment variables -- 2.43.2