Move documentation to inline comments: GtkRecentAction

diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index d8fbb174c6124d2d578c4ba3a081122c01245c28..c30497604f244e578f9658feb4adb72c1c708a44 100644 (file)
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -6,6 +6,7 @@ gtkmessagedialog.sgml
 gtkobject.sgml
 gtkorientable.sgml
 gtkpagesetupunixdialog.sgml
+gtkrecentaction.sgml
 gtkseparator.sgml
 gtktesting.sgml
 gtktextiter.sgml

diff --git a/docs/reference/gtk/tmpl/gtkrecentaction.sgml b/docs/reference/gtk/tmpl/gtkrecentaction.sgml
deleted file mode 100644 (file)
index d47ea4c..0000000
--- a/docs/reference/gtk/tmpl/gtkrecentaction.sgml
+++ /dev/null
@@ -1,84 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkRecentAction
-
-<!-- ##### SECTION Short_Description ##### -->
-An action of which represents a list of recently used files
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-A GtkRecentAction represents a list of recently used files, which
-can be shown by widgets such as #GtkRecentChooserDialog or 
-#GtkRecentChooserMenu.
-</para>
-<para>
-To construct a submenu showing recently used files, use a GtkRecentAction 
-as the action for a &lt;menuitem&gt;. To construct a menu toolbutton showing 
-the recently used files in the popup menu, use a GtkRecentAction as the 
-action for a &lt;toolitem&gt; element.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkRecentAction ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### ARG GtkRecentAction:show-numbers ##### -->
-<para>
-
-</para>
-
-<!-- ##### FUNCTION gtk_recent_action_new ##### -->
-<para>
-
-</para>
-
-@name: 
-@label: 
-@tooltip: 
-@stock_id: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_recent_action_new_for_manager ##### -->
-<para>
-
-</para>
-
-@name: 
-@label: 
-@tooltip: 
-@stock_id: 
-@manager: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_recent_action_get_show_numbers ##### -->
-<para>
-
-</para>
-
-@action: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_recent_action_set_show_numbers ##### -->
-<para>
-
-</para>
-
-@action: 
-@show_numbers: 
-
-

diff --git a/gtk/gtkrecentaction.c b/gtk/gtkrecentaction.c
index 14acfb426a81f6c87e6bede79b1ea23b8a40d2c2..458d23f01903940cf69db92cc87787fff147198a 100644 (file)
--- a/gtk/gtkrecentaction.c
+++ b/gtk/gtkrecentaction.c
@@ -32,6 +32,23 @@
 #include "gtkprivate.h"
 #include "gtkalias.h"
 
+
+/**
+ * SECTION:gtkrecentaction
+ * @Short_description: An action of which represents a list of recently used files
+ * @Title: GtkRecentAction
+ *
+ * A #GtkRecentAction represents a list of recently used files, which
+ * can be shown by widgets such as #GtkRecentChooserDialog or
+ * #GtkRecentChooserMenu.
+ *
+ * To construct a submenu showing recently used files, use a #GtkRecentAction
+ * as the action for a <menuitem>. To construct a menu toolbutton showing
+ * the recently used files in the popup menu, use a #GtkRecentAction as the
+ * action for a <toolitem> element.
+ */
+
+
 #define FALLBACK_ITEM_LIMIT     10
 
 #define GTK_RECENT_ACTION_GET_PRIVATE(obj)      \