[gtk+] Move documentation to inline comments: GtkOrientable

[Javier Jardón <jjardon src gnome org>]

commit 95bb12ee66436654d9cd99b35315bd917357a528
Author: Javier Jardón <jjardon gnome org>
Date:   Thu May 13 03:35:02 2010 +0200

    Move documentation to inline comments: GtkOrientable

 docs/reference/gtk/tmpl/.gitignore         |    1 +
 docs/reference/gtk/tmpl/gtkorientable.sgml |   59 ----------------------------
 gtk/gtkorientable.c                        |   16 +++++++
 3 files changed, 17 insertions(+), 59 deletions(-)
---
diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index 85e880b..8b4eaa0 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/gtk/gtkorientable.c b/gtk/gtkorientable.c
index 95102cb..636f65d 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)