From bb218b08e993b839864a47cbcc776da0e53b075f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Javier=20Jard=C3=B3n?= <jjardon@gnome.org>
Date: Mon, 15 Nov 2010 03:18:45 +0100
Subject: [PATCH] docs: Move documentation to inline comments:
 gdkapplaunchcontext

---
 docs/reference/gdk/tmpl/.gitignore            |   1 +
 .../gdk/tmpl/gdkapplaunchcontext.sgml         | 110 ------------------
 gdk/gdkapplaunchcontext.c                     |  28 +++++
 3 files changed, 29 insertions(+), 110 deletions(-)
 delete mode 100644 docs/reference/gdk/tmpl/gdkapplaunchcontext.sgml

diff --git a/docs/reference/gdk/tmpl/.gitignore b/docs/reference/gdk/tmpl/.gitignore
index 9c314b9911..a05bd1c699 100644
--- a/docs/reference/gdk/tmpl/.gitignore
+++ b/docs/reference/gdk/tmpl/.gitignore
@@ -1,6 +1,7 @@
 cairo_interaction.sgml
 colors.sgml
 dnd.sgml
+gdkapplaunchcontext.sgml
 pixbufs.sgml
 regions.sgml
 windows.sgml
diff --git a/docs/reference/gdk/tmpl/gdkapplaunchcontext.sgml b/docs/reference/gdk/tmpl/gdkapplaunchcontext.sgml
deleted file mode 100644
index 78928a4ebe..0000000000
--- a/docs/reference/gdk/tmpl/gdkapplaunchcontext.sgml
+++ /dev/null
@@ -1,110 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-Application launching
-
-<!-- ##### SECTION Short_Description ##### -->
-Startup notification for applications
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-GdkAppLaunchContext is an implementation of #GAppLaunchContext that
-handles launching an application in a graphical context. It provides
-startup notification and allows to launch applications on a specific
-screen or workspace.
-</para>
-<example>
-<title>Launching an application</title>
-<programlisting>
-GdkAppLaunchContext *context;
-
-context = gdk_app_launch_context_new (<!-- -->);
-
-gdk_app_launch_context_set_screen (my_screen);
-gdk_app_launch_context_set_timestamp (event-&gt;time);
-
-if (!g_app_info_launch_default_for_uri ("http://www.gtk.org", context, &amp;error))
-  g_warning ("Launching failed: %s\n", error-&gt;message);
-
-g_object_unref (context);
-</programlisting>
-</example>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### TYPEDEF GdkAppLaunchContext ##### -->
-<para>
-An opaque structure representing an application launch context.
-</para>
-
-
-<!-- ##### FUNCTION gdk_app_launch_context_new ##### -->
-<para>
-
-</para>
-
-@void: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_app_launch_context_set_display ##### -->
-<para>
-
-</para>
-
-@context: 
-@display: 
-
-
-<!-- ##### FUNCTION gdk_app_launch_context_set_screen ##### -->
-<para>
-
-</para>
-
-@context: 
-@screen: 
-
-
-<!-- ##### FUNCTION gdk_app_launch_context_set_desktop ##### -->
-<para>
-
-</para>
-
-@context: 
-@desktop: 
-
-
-<!-- ##### FUNCTION gdk_app_launch_context_set_timestamp ##### -->
-<para>
-
-</para>
-
-@context: 
-@timestamp: 
-
-
-<!-- ##### FUNCTION gdk_app_launch_context_set_icon ##### -->
-<para>
-
-</para>
-
-@context: 
-@icon: 
-
-
-<!-- ##### FUNCTION gdk_app_launch_context_set_icon_name ##### -->
-<para>
-
-</para>
-
-@context: 
-@icon_name: 
-
-
diff --git a/gdk/gdkapplaunchcontext.c b/gdk/gdkapplaunchcontext.c
index 46fd99a4fd..1bd4dbbf29 100644
--- a/gdk/gdkapplaunchcontext.c
+++ b/gdk/gdkapplaunchcontext.c
@@ -29,6 +29,34 @@
 #include "gdkintl.h"
 
 
+/**
+ * SECTION:gdkapplaunchcontext
+ * @Short_description: Startup notification for applications
+ * @Title: Application launching
+ *
+ * GdkAppLaunchContext is an implementation of #GAppLaunchContext that
+ * handles launching an application in a graphical context. It provides
+ * startup notification and allows to launch applications on a specific
+ * screen or workspace.
+ * <example>
+ * <title>Launching an application</title>
+ * <programlisting>
+ * GdkAppLaunchContext *context;
+ *
+ * context = gdk_app_launch_context_new (<!-- -->);
+ *
+ * gdk_app_launch_context_set_screen (my_screen);
+ * gdk_app_launch_context_set_timestamp (event->time);
+ *
+ * if (!g_app_info_launch_default_for_uri ("http://www.gtk.org", context, &error))
+ *   g_warning ("Launching failed: %s\n", error->message);
+ *
+ * g_object_unref (context);
+ * </programlisting>
+ * </example>
+ */
+
+
 static void    gdk_app_launch_context_finalize    (GObject           *object);
 static gchar * gdk_app_launch_context_get_display (GAppLaunchContext *context,
                                                    GAppInfo          *info,