[gtkmm] gtkmm: Avoid most Documentation warnings from gmmproc.

[Murray Cumming <murrayc src gnome org>]

commit b1d3ce4c2d62e96db2b7fe99d09c11e1585580a2
Author: Murray Cumming <murrayc murrayc com>
Date:   Fri Sep 3 23:49:13 2010 +0200

    gtkmm: Avoid most Documentation warnings from gmmproc.
    
    * gtk/src/filelist.am:
    * gtk/src/gdk.defs:
    * gtk/src/gdk_extra_objects.defs: Added this *extra_objects.defs file,
    with hand-coded define-object sections, for objects that hide their *Class
    or *Iface struct declarations, which stops h2defs.py from generating
    define-object sections.
    These allows DocsParser.pm to know how to split mentions of C functions into
    the object and the method, so it can guess the C++ method name to mention
    instead.

 ChangeLog                      |   14 +++++++
 gtk/src/filelist.am            |    1 +
 gtk/src/gtk.defs               |    1 +
 gtk/src/gtk_extra_objects.defs |   79 ++++++++++++++++++++++++++++++++++++++++
 4 files changed, 95 insertions(+), 0 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index 1dbce26..647095b 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,19 @@
 2010-09-03  Murray Cumming  <murrayc murrayc com>
 
+	gtkmm: Avoid most Documentation warnings from gmmproc.
+
+	* gtk/src/filelist.am:
+	* gtk/src/gdk.defs:
+	* gtk/src/gdk_extra_objects.defs: Added this *extra_objects.defs file, 
+	with hand-coded define-object sections, for objects that hide their *Class
+	or *Iface struct declarations, which stops h2defs.py from generating 
+	define-object sections.
+	These allows DocsParser.pm to know how to split mentions of C functions into 
+	the object and the method, so it can guess the C++ method name to mention 
+	instead.
+	
+2010-09-03  Murray Cumming  <murrayc murrayc com>
+
 	gdkmm: Avoid most Documentation warnings from gmmproc.
 
 	* gdk/src/filelist.am:
diff --git a/gtk/src/filelist.am b/gtk/src/filelist.am
index 935dd17..38f08f8 100644
--- a/gtk/src/filelist.am
+++ b/gtk/src/filelist.am
@@ -6,6 +6,7 @@ gtkmm_files_defs =		\
 	gtk_enums_maemo.defs	\
 	gtk_methods.defs	\
 	gtk_methods_maemo.defs	\
+	gtk_extra_objects.defs	\
 	gtk_other.defs		\
 	gtk_signals.defs	\
 	gtk_vfuncs.defs		\
diff --git a/gtk/src/gtk.defs b/gtk/src/gtk.defs
index b2ebd0a..4f5bf85 100644
--- a/gtk/src/gtk.defs
+++ b/gtk/src/gtk.defs
@@ -1,5 +1,6 @@
 (include gtk_methods.defs)
 (include gtk_methods_maemo.defs)
+(include gtk_extra_objects.defs)
 (include gtk_signals.defs)
 (include gtk_vfuncs.defs)
 (include gtk_enums.defs)
diff --git a/gtk/src/gtk_extra_objects.defs b/gtk/src/gtk_extra_objects.defs
new file mode 100644
index 0000000..95b40fe
--- /dev/null
+++ b/gtk/src/gtk_extra_objects.defs
@@ -0,0 +1,79 @@
+; These define-object declarations were not generated by h2defs.py
+; because it looks for the SomethingClass declaration too, but that is often 
+; hidden.
+; However, it is needed by the documentation generation, which needs to 
+; know what objects exist, so it can guess how to break apart C function names 
+; that are mentioned in documentation text.
+; (DocsParser.pm:substitute_function(), which uses GtkDefs.pm:lookup_object().)
+
+(define-object AccelMap
+  (in-module "Gtk")
+  (c-name "GtkAccelMap")
+  (gtype-id "GTK_TYPE_ACCEL_MAP")
+)
+
+(define-object Clipboard
+  (in-module "Gtk")
+  (c-name "GtkClipboard")
+  (gtype-id "GTK_TYPE_CLIPBOARD")
+)
+
+(define-object FileChooser
+  (in-module "Gtk")
+  (c-name "GtkFileChooser")
+  (gtype-id "GTK_TYPE_FILE_CHOOSER")
+)
+
+(define-object IconInfo
+  (in-module "Gtk")
+  (c-name "GtkIconInfo")
+  (gtype-id "GTK_TYPE_ICON_INFO)
+)
+
+(define-object IconSource
+  (in-module "Gtk")
+  (c-name "IconSource")
+  (gtype-id "GTK_TYPE_ICON_SOURCE")
+)
+
+(define-object PageSetup
+  (in-module "Gtk")
+  (c-name "GtkPageSetup")
+  (gtype-id "GTK_TYPE_PAGE_SETUP")
+)
+
+(define-object RecentFilter
+  (in-module "Gtk")
+  (c-name "GtkRecentFilter")
+  (gtype-id "GTK_TYPE_RECENT_FILTER")
+)
+
+(define-object RecentInfo
+  (in-module "Gtk")
+  (c-name "GtkRecentInfo")
+  (gtype-id "GTK_TYPE_RECENT_INFO")
+)
+
+(define-object TargetList
+  (in-module "Gtk")
+  (c-name "GtkTargetList")
+  (gtype-id "GTK_TYPE_TARGET_LIST")
+)
+
+(define-object TextIter
+  (in-module "Gtk")
+  (c-name "GtkTextIter")
+  (gtype-id "GTK_TYPE_TEXT_ITER")
+)
+
+(define-object Tooltip
+  (in-module "Gtk")
+  (c-name "GtkTooltip")
+  (gtype-id "GTK_TYPE_TOOLTIP")
+)
+
+(define-object TreeRowReference
+  (in-module "Gtk")
+  (c-name "GtkTreeRowReference")
+  (gtype-id "GTK_TYPE_TREE_ROW_REFERENCE")
+)