Move documentation to inline comments: GtkOrientable

3 files changed, 17 insertions, 59 deletions

diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index 85e880b6bb..8b4eaa0db9 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -3,6 +3,7 @@ gtkbox.sgml
 gtkbuilder.sgml
 gtkhbox.sgml
 gtkmessagedialog.sgml
+gtkorientable.sgml
 gtkpagesetupunixdialog.sgml
 gtkseparator.sgml
 gtktesting.sgml
diff --git a/docs/reference/gtk/tmpl/gtkorientable.sgml b/docs/reference/gtk/tmpl/gtkorientable.sgml
deleted file mode 100644
index 4f1a153f5d..0000000000
--- a/docs/reference/gtk/tmpl/gtkorientable.sgml
+++ /dev/null
@@ -1,59 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkOrientable
-
-<!-- ##### SECTION Short_Description ##### -->
-An interface for flippable widgets
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-The #GtkOrientable interface is implemented by all widgets that can be 
-oriented horizontally or vertically. Historically, such widgets have been 
-realized as subclasses of a common base class (e.g #GtkBox/#GtkHBox/#GtkVBox
-and #GtkScale/#GtkHScale/#GtkVScale). GtkOrientable is more flexible in that 
-it allows the orientation to be changed at runtime, allowing the widgets
-to 'flip'.
-</para>
-<para>
-GtkOrientable was introduced in GTK+ 2.16.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkOrientable ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### ARG GtkOrientable:orientation ##### -->
-<para>
-
-</para>
-
-<!-- ##### FUNCTION gtk_orientable_get_orientation ##### -->
-<para>
-
-</para>
-
-@orientable: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_orientable_set_orientation ##### -->
-<para>
-
-</para>
-
-@orientable: 
-@orientation: 
-
-
diff --git a/gtk/gtkorientable.c b/gtk/gtkorientable.c
index 95102cb5d9..636f65da8f 100644
--- a/gtk/gtkorientable.c
+++ b/gtk/gtkorientable.c
@@ -29,6 +29,22 @@
 #include "gtkalias.h"
 
 
+/**
+ * SECTION:gtkorientable
+ * @Short_description: An interface for flippable widgets
+ * @Title: GtkOrientable
+ *
+ * The #GtkOrientable interface is implemented by all widgets that can be
+ * oriented horizontally or vertically. Historically, such widgets have been
+ * realized as subclasses of a common base class (e.g #GtkBox/#GtkHBox/#GtkVBox
+ * or #GtkScale/#GtkHScale/#GtkVScale). #GtkOrientable is more flexible in that
+ * it allows the orientation to be changed at runtime, allowing the widgets
+ * to 'flip'.
+ *
+ * #GtkOrientable was introduced in GTK+ 2.16.
+ */
+
+
 typedef GtkOrientableIface GtkOrientableInterface;
 G_DEFINE_INTERFACE (GtkOrientable, gtk_orientable, G_TYPE_OBJECT)