gir-repository r231 - in trunk: . gir

[johan svn gnome org]

Author: johan
Date: Tue Nov 25 10:57:00 2008
New Revision: 231
URL: http://svn.gnome.org/viewvc/gir-repository?rev=231&view=rev

Log:
2008-11-25  Johan Dahlin  <jdahlin async com br>

        * gir/Gtk-custom.c:
        Re-organize alphabetically and add a couple of comments.



Modified:
   trunk/ChangeLog
   trunk/gir/Gtk-custom.c

Modified: trunk/gir/Gtk-custom.c
==============================================================================
--- trunk/gir/Gtk-custom.c	(original)
+++ trunk/gir/Gtk-custom.c	Tue Nov 25 10:57:00 2008
@@ -10,6 +10,13 @@
 #include "Gtk-custom.h"
 #include <string.h>
 
+/**************************************************
+ * This section contains convenience API for Gtk+
+ * which makes it easier to access parts of the API
+ * which are not easily wrappable nor completely supported
+ * by gobject-introspection
+ */
+
 #ifdef GDK_WINDOWING_X11
 #include <gdk/gdkx.h>
 
@@ -113,6 +120,13 @@
     return dialog->vbox;
 }
 
+
+
+/****************************************************************
+ * This section contains annotations which should go upstream as
+ * soon as Gtk+ depends on gobject-introspection
+ */
+
 /**
  * gtk_about_dialog_get_name:
  * @about: a #GtkAboutDialog
@@ -200,6 +214,12 @@
  */
 
 /**
+ * gtk_bin_get_child:
+ *
+ * Return value: (transfer none):
+ */
+
+/**
  * gtk_box_pack_start_defaults:
  * @box: a #GtkBox
  * @widget: the #GtkWidget to be added to @box
@@ -777,6 +797,12 @@
  */
 
 /**
+ * gtk_radio_button_get_group:
+ *
+ * Return value: (element-type Widget) (transfer none):
+ */
+
+/**
  * gtk_rc_get_style_by_paths: 
  * @widget_path: (allow-none): 
  * @class_path: (allow-none): 
@@ -1206,14 +1232,6 @@
  * @parent: (allow-none): 
  */
 
-/**
- * gtk_bin_get_child:
- *
- * Return value: (transfer none):
- */
-
-/**
- * gtk_radio_button_get_group:
- *
- * Return value: (element-type Widget) (transfer none):
+/* Do not add annotations here, please keep the order alphabetically, 
+ * as it will make it easier to put these upstream at a later point
  */