[gtk+/wip/gmenu] Document that gtk_init is called without argv

[Matthias Clasen <matthiasc src gnome org>]

commit 41f4a146df3a6486a0b575709a235419ef308261
Author: Matthias Clasen <mclasen redhat com>
Date:   Sat Dec 17 00:22:06 2011 -0500

    Document that gtk_init is called without argv
    
    This answers a question in bug 661823.

 gtk/gtkapplication.c |    8 ++++++++
 1 files changed, 8 insertions(+), 0 deletions(-)
---
diff --git a/gtk/gtkapplication.c b/gtk/gtkapplication.c
index 7663dd8..5cc5272 100644
--- a/gtk/gtkapplication.c
+++ b/gtk/gtkapplication.c
@@ -580,6 +580,14 @@ 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.
  *
+ * 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
+ * such as <envvar>G_DEBUG</envvar>, so this should not be a big
+ * problem. If you absolutely must support GTK+ commandline arguments,
+ * you can explicitly call gtk_init() before creating the application
+ * instance.
+ *
  * The application id must be valid. See g_application_id_is_valid().
  *
  * Returns: a new #GtkApplication instance