[docs] GtkCellEditable: Move documentation to inline comments

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

Signed-off-by: Javier Jardón <jjardon@gnome.org>

3 files changed, 13 insertions, 85 deletions

diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index c198043408..0c6b10c9f9 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -3,6 +3,7 @@ gtkbox.sgml
 gtkbuilder.sgml
 gtkbutton.sgml
 gtkcalendar.sgml
+gtkcelleditable.sgml
 gtkhbox.sgml
 gtkiconview.sgml
 gtkmessagedialog.sgml
diff --git a/docs/reference/gtk/tmpl/gtkcelleditable.sgml b/docs/reference/gtk/tmpl/gtkcelleditable.sgml
deleted file mode 100644
index b06721be98..0000000000
--- a/docs/reference/gtk/tmpl/gtkcelleditable.sgml
+++ /dev/null
@@ -1,83 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkCellEditable
-
-<!-- ##### SECTION Short_Description ##### -->
-Interface for widgets which can are used for editing cells
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-The #GtkCellEditable interface must be implemented for widgets
-to be usable when editing the contents of a #GtkTreeView cell.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkCellEditable ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SIGNAL GtkCellEditable::editing-done ##### -->
-<para>
-
-</para>
-
-@celleditable: the object which received the signal.
-
-<!-- ##### SIGNAL GtkCellEditable::remove-widget ##### -->
-<para>
-
-</para>
-
-@celleditable: the object which received the signal.
-
-<!-- ##### ARG GtkCellEditable:editing-canceled ##### -->
-<para>
-
-</para>
-
-<!-- ##### STRUCT GtkCellEditableIface ##### -->
-<para>
-
-</para>
-
-@g_iface: 
-@editing_done: 
-@remove_widget: 
-@start_editing: 
-
-<!-- ##### FUNCTION gtk_cell_editable_start_editing ##### -->
-<para>
-
-</para>
-
-@cell_editable: 
-@event: 
-
-
-<!-- ##### FUNCTION gtk_cell_editable_editing_done ##### -->
-<para>
-
-</para>
-
-@cell_editable: 
-
-
-<!-- ##### FUNCTION gtk_cell_editable_remove_widget ##### -->
-<para>
-
-</para>
-
-@cell_editable: 
-
-
diff --git a/gtk/gtkcelleditable.c b/gtk/gtkcelleditable.c
index 330eac5bbb..55bc63b285 100644
--- a/gtk/gtkcelleditable.c
+++ b/gtk/gtkcelleditable.c
@@ -17,6 +17,16 @@
  * Boston, MA 02111-1307, USA.
  */
 
+/**
+ * SECTION:gtkcelleditable
+ * @Short_description: Interface for widgets which can are used for editing
+ *  cells
+ * @Title: GtkCellEditable
+ * @See_also: #GtkEntry, #GtkCellRenderer
+ *
+ * The #GtkCellEditable interface must be implemented for widgets to be usable
+ * when editing the contents of a #GtkTreeView cell.
+ */
 
 #include "config.h"
 #include "gtkcelleditable.h"
@@ -57,7 +67,7 @@ gtk_cell_editable_default_init (GtkCellEditableInterface *iface)
    * #GtkEntry is emitting it when the user presses Enter.
    *
    * gtk_cell_editable_editing_done() is a convenience method
-   * for emitting GtkCellEditable::editing-done.
+   * for emitting #GtkCellEditable::editing-done.
    */
   g_signal_new (I_("editing-done"),
                 GTK_TYPE_CELL_EDITABLE,
@@ -81,7 +91,7 @@ gtk_cell_editable_default_init (GtkCellEditableInterface *iface)
    * before the widget is removed.
    *
    * gtk_cell_editable_remove_widget() is a convenience method
-   * for emitting GtkCellEditable::remove-widget.
+   * for emitting #GtkCellEditable::remove-widget.
    */
   g_signal_new (I_("remove-widget"),
                 GTK_TYPE_CELL_EDITABLE,