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

---
 docs/reference/gdk/tmpl/.gitignore     |   1 +
 docs/reference/gdk/tmpl/gdkscreen.sgml | 397 -------------------------
 gdk/gdkscreen.c                        |  16 +
 gdk/gdkscreen.h                        |   9 +
 4 files changed, 26 insertions(+), 397 deletions(-)
 delete mode 100644 docs/reference/gdk/tmpl/gdkscreen.sgml

diff --git a/docs/reference/gdk/tmpl/.gitignore b/docs/reference/gdk/tmpl/.gitignore
index ba7656b246..902309a258 100644
--- a/docs/reference/gdk/tmpl/.gitignore
+++ b/docs/reference/gdk/tmpl/.gitignore
@@ -4,6 +4,7 @@ dnd.sgml
 gdkapplaunchcontext.sgml
 gdkdisplay.sgml
 gdkdisplaymanager.sgml
+gdkscreen.sgml
 pixbufs.sgml
 regions.sgml
 windows.sgml
diff --git a/docs/reference/gdk/tmpl/gdkscreen.sgml b/docs/reference/gdk/tmpl/gdkscreen.sgml
deleted file mode 100644
index a847db9170..0000000000
--- a/docs/reference/gdk/tmpl/gdkscreen.sgml
+++ /dev/null
@@ -1,397 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GdkScreen
-
-<!-- ##### SECTION Short_Description ##### -->
-Object representing a physical screen
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-  #GdkScreen objects are the GDK representation of a physical screen. It is used 
-  throughout GDK and GTK+ to specify which screen the top level windows
-  are to be displayed on. 
-  It is also used to query the screen specification and default settings such as 
-  the default colormap (gdk_screen_get_default_colormap()),
-  the screen width (gdk_screen_get_width()), etc.
-</para>
-<para>Note that a screen may consist of multiple monitors which are merged to
-form a large screen area. 
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GdkScreen ##### -->
-<para>
-This is a currently just a placeholder typedef for the first argument of 
-the @window_at_pointer function in #GdkPointerHooks. It will be used
-when GDK gets multihead support. 
-</para>
-
-@Since: 2.2
-
-<!-- ##### SIGNAL GdkScreen::composited-changed ##### -->
-<para>
-
-</para>
-
-@gdkscreen: the object which received the signal.
-
-<!-- ##### SIGNAL GdkScreen::monitors-changed ##### -->
-<para>
-
-</para>
-
-@gdkscreen: the object which received the signal.
-
-<!-- ##### SIGNAL GdkScreen::size-changed ##### -->
-<para>
-
-</para>
-
-@gdkscreen: the object which received the signal.
-
-<!-- ##### ARG GdkScreen:font-options ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GdkScreen:resolution ##### -->
-<para>
-
-</para>
-
-<!-- ##### FUNCTION gdk_screen_get_default ##### -->
-<para>
-
-</para>
-
-@void: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_system_visual ##### -->
-<para>
-
-</para>
-
-@screen: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_rgba_visual ##### -->
-<para>
-
-</para>
-
-@screen: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_is_composited ##### -->
-<para>
-
-</para>
-
-@screen: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_root_window ##### -->
-<para>
-
-</para>
-
-@screen: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_display ##### -->
-<para>
-
-</para>
-
-@screen: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_number ##### -->
-<para>
-
-</para>
-
-@screen: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_width ##### -->
-<para>
-
-</para>
-
-@screen: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_height ##### -->
-<para>
-
-</para>
-
-@screen: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_width_mm ##### -->
-<para>
-
-</para>
-
-@screen: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_height_mm ##### -->
-<para>
-
-</para>
-
-@screen: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_list_visuals ##### -->
-<para>
-
-</para>
-
-@screen: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_toplevel_windows ##### -->
-<para>
-
-</para>
-
-@screen: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_make_display_name ##### -->
-<para>
-
-</para>
-
-@screen: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_n_monitors ##### -->
-<para>
-
-</para>
-
-@screen: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_primary_monitor ##### -->
-<para>
-
-</para>
-
-@screen: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_monitor_geometry ##### -->
-<para>
-
-</para>
-
-@screen: 
-@monitor_num: 
-@dest: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_monitor_at_point ##### -->
-<para>
-
-</para>
-
-@screen: 
-@x: 
-@y: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_monitor_at_window ##### -->
-<para>
-
-</para>
-
-@screen: 
-@window: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_monitor_height_mm ##### -->
-<para>
-
-</para>
-
-@screen: 
-@monitor_num: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_monitor_width_mm ##### -->
-<para>
-
-</para>
-
-@screen: 
-@monitor_num: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_monitor_plug_name ##### -->
-<para>
-
-</para>
-
-@screen: 
-@monitor_num: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_broadcast_client_message ##### -->
-<para>
-
-</para>
-
-@screen: 
-@event: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_setting ##### -->
-<para>
-
-</para>
-
-@screen: 
-@name: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_font_options ##### -->
-<para>
-
-</para>
-
-@screen: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_set_font_options ##### -->
-<para>
-
-</para>
-
-@screen: 
-@options: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_resolution ##### -->
-<para>
-
-</para>
-
-@screen: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_set_resolution ##### -->
-<para>
-
-</para>
-
-@screen: 
-@dpi: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_active_window ##### -->
-<para>
-
-</para>
-
-@screen: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_screen_get_window_stack ##### -->
-<para>
-
-</para>
-
-@screen: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_spawn_on_screen ##### -->
-<para>
-
-</para>
-
-@screen: 
-@working_directory: 
-@argv: 
-@envp: 
-@flags: 
-@child_setup: 
-@user_data: 
-@child_pid: 
-@error: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_spawn_on_screen_with_pipes ##### -->
-<para>
-
-</para>
-
-@screen: 
-@working_directory: 
-@argv: 
-@envp: 
-@flags: 
-@child_setup: 
-@user_data: 
-@child_pid: 
-@standard_input: 
-@standard_output: 
-@standard_error: 
-@error: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_spawn_command_line_on_screen ##### -->
-<para>
-
-</para>
-
-@screen: 
-@command_line: 
-@error: 
-@Returns: 
-
-
diff --git a/gdk/gdkscreen.c b/gdk/gdkscreen.c
index 25b22d8aef..57b17ff880 100644
--- a/gdk/gdkscreen.c
+++ b/gdk/gdkscreen.c
@@ -30,6 +30,22 @@
 #include "gdkintl.h"
 
 
+/**
+ * SECTION:gdkscreen
+ * @Short_description: Object representing a physical screen
+ * @Title: GdkScreen
+ *
+ * #GdkScreen objects are the GDK representation of a physical screen. It is used
+ * throughout GDK and GTK+ to specify which screen the top level windows
+ * are to be displayed on.
+ * It is also used to query the screen specification and default settings such as
+ * the screen width (gdk_screen_get_width()), etc.
+ *
+ * Note that a screen may consist of multiple monitors which are merged to
+ * form a large screen area.
+ */
+
+
 static void gdk_screen_finalize     (GObject        *object);
 static void gdk_screen_set_property (GObject        *object,
 				     guint           prop_id,
diff --git a/gdk/gdkscreen.h b/gdk/gdkscreen.h
index 4b27e6034f..208c4cdc89 100644
--- a/gdk/gdkscreen.h
+++ b/gdk/gdkscreen.h
@@ -43,6 +43,15 @@ typedef struct _GdkScreenClass GdkScreenClass;
 #define GDK_IS_SCREEN_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_SCREEN))
 #define GDK_SCREEN_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_SCREEN, GdkScreenClass))
 
+/**
+ * GdkScreen:
+ *
+ * This is a currently just a placeholder typedef for the first argument of
+ * the #GdkPointerHooks.window_at_pointer function in #GdkPointerHooks.
+ * It will be used  when GDK gets multihead support.
+ *
+ * Since: 2.2
+ */
 struct _GdkScreen
 {
   GObject parent_instance;