[gtk+/wip/gmenu: 47/87] GtkApplication: doc improvement

[Ryan Lortie <ryanl src gnome org>]

commit 7a8e31d0c1d2481255b74faa4a35e8ba6f7ce187
Author: Matthias Clasen <mclasen redhat com>
Date:   Wed Nov 30 23:48:59 2011 -0500

    GtkApplication: doc improvement

 gtk/gtkapplication.c |    9 ++++++---
 1 files changed, 6 insertions(+), 3 deletions(-)
---
diff --git a/gtk/gtkapplication.c b/gtk/gtkapplication.c
index ccae8e8..9199c60 100644
--- a/gtk/gtkapplication.c
+++ b/gtk/gtkapplication.c
@@ -50,9 +50,12 @@
  * a one-size-fits-all application model.
  *
  * Currently, GtkApplication handles GTK+ initialization, application
- * uniqueness, provides some basic scriptability by exporting 'actions',
- * and manages a list of toplevel windows whose life-cycle is automatically
- * tied to the life-cycle of your application.
+ * uniqueness, provides some basic scriptability and desktop shell integration
+ * by exporting actions and menus and manages a list of toplevel windows whose
+ * life-cycle is automatically tied to the life-cycle of your application.
+ *
+ * While GtkApplication works fine with plain #GtkWindows, it is recommended
+ * to use it together with #GtkApplicationWindow.
  *
  * <example id="gtkapplication"><title>A simple application</title>
  * <programlisting>