From 8e8d302d106e38d9b23db1afb22d80fc05b06194 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tadej=20Borov=C5=A1ak?= <tadeboro@gmail.com>
Date: Tue, 9 Mar 2010 23:32:53 +0100
Subject: [PATCH] [docs] Move documentation to inline comments: GtkBin
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Fixes https://bugzilla.gnome.org/show_bug.cgi?id=612351

Signed-off-by: Javier Jardón <jjardon@gnome.org>
---
 docs/reference/gtk/tmpl/gtkbin.sgml | 54 -----------------------------
 gtk/gtkbin.c                        | 13 +++++++
 2 files changed, 13 insertions(+), 54 deletions(-)
 delete mode 100644 docs/reference/gtk/tmpl/gtkbin.sgml

diff --git a/docs/reference/gtk/tmpl/gtkbin.sgml b/docs/reference/gtk/tmpl/gtkbin.sgml
deleted file mode 100644
index d806d4701e..0000000000
--- a/docs/reference/gtk/tmpl/gtkbin.sgml
+++ /dev/null
@@ -1,54 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkBin
-
-<!-- ##### SECTION Short_Description ##### -->
-A container with just one child
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-The #GtkBin widget is a container with just one child.
-It is not very useful itself, but it is useful for deriving subclasses,
-since it provides common code needed for handling a single child widget.
-</para>
-<para>
-Many GTK+ widgets are subclasses of #GtkBin, including #GtkWindow, #GtkButton,
-#GtkFrame, #GtkHandleBox, and #GtkScrolledWindow.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### STRUCT GtkBin ##### -->
-<para>
-The #GtkBin-struct struct contains the following fields.
-(These fields should be considered read-only. They should never be set by
-an application.)
-
-<informaltable pgwide="1" frame="none" role="struct">
-<tgroup cols="2"><colspec colwidth="2*"/><colspec colwidth="8*"/>
-<tbody>
-
-<row>
-<entry>#GtkWidget *child;</entry>
-<entry>the child widget.</entry>
-</row>
-
-</tbody></tgroup></informaltable>
-
-</para>
-
-
-<!-- ##### FUNCTION gtk_bin_get_child ##### -->
-<para>
-
-</para>
-
-@bin: 
-@Returns: 
-
-
diff --git a/gtk/gtkbin.c b/gtk/gtkbin.c
index 16f13794ee..3d533b2de2 100644
--- a/gtk/gtkbin.c
+++ b/gtk/gtkbin.c
@@ -24,6 +24,19 @@
  * GTK+ at ftp://ftp.gtk.org/pub/gtk/. 
  */
 
+/**
+ * SECTION:gtkbin
+ * @Short_description: A container with just one child
+ * @Title: GtkBin
+ *
+ * The #GtkBin widget is a container with just one child.
+ * It is not very useful itself, but it is useful for deriving subclasses,
+ * since it provides common code needed for handling a single child widget.
+ *
+ * Many GTK+ widgets are subclasses of #GtkBin, including #GtkWindow,
+ * #GtkButton, #GtkFrame, #GtkHandleBox or #GtkScrolledWindow.
+ */
+
 #include "config.h"
 #include "gtkbin.h"
 #include "gtkintl.h"