GNOME.org
 

[libgda/LIBGDA_4.2] GObject Introspection fixes and automatic Vala bindings generation

commit c9448aaa678141f160583cfd26ba5be2ce650d6c
Author: Vivien Malerba <malerba gnome-db org>
Date:   Wed Sep 21 15:52:24 2011 +0200

    GObject Introspection fixes and automatic Vala bindings generation
    
    thanks to Daniel Espinosa

 configure.ac                                  |   57 +++++++++++++++++++++++++
 libgda/Makefile.am                            |   19 ++++++++-
 libgda/gda-connection.c                       |    2 +-
 libgda/gda-data-model.c                       |    6 +-
 libgda/gda-meta-store.c                       |    2 +-
 libgda/gda-meta-struct.c                      |    2 +-
 libgda/gda-meta-struct.h                      |    8 ++--
 libgda/gda-set.c                              |    4 +-
 libgda/gda-set.h                              |   20 +++++++++
 libgda/gda-sql-builder.c                      |   18 ++++----
 libgda/gda-statement-extra.h                  |   10 ++++
 libgda/gda-transaction-status.h               |    8 ++++
 libgda/gda-tree-manager.c                     |    2 +-
 libgda/gda-types.h                            |    8 ++++
 libgda/gda-util.c                             |    2 +-
 libgda/gda-xa-transaction.c                   |    4 +-
 libgda/providers-support/gda-pstmt.h          |    9 ++++
 libgda/sql-parser/gda-statement-struct-decl.h |   17 +++++++-
 18 files changed, 171 insertions(+), 27 deletions(-)
---
diff --git a/configure.ac b/configure.ac
index 906e778..2cf5c75 100644
--- a/configure.ac
+++ b/configure.ac
@@ -487,6 +487,62 @@ AC_ARG_ENABLE([gi-system-install],
     [enable_gi_system_install=$enableval],[enable_gi_system_install=yes])
 AM_CONDITIONAL(ENABLE_GI_SYSTEM_INSTALL, [test x"$enable_gi_system_install" = "xyes"])
 
+
+dnl ******************************
+dnl Check for Vala Compiler
+dnl ******************************
+
+AC_ARG_ENABLE([vala],
+    AS_HELP_STRING([--enable-vala], [Enable support for Vala bindings generation [default=auto]]),
+    [enable_vala=$enableval],[enable_vala=auto])
+
+have_vala=no
+if test "x$found_introspection" = "xyes"
+then
+    VALA_MODULES="libvala-0.14"
+    PKG_CHECK_MODULES(VALA, $VALA_MODULES,
+	AC_DEFINE(HAVE_VALA, [], [Defined if Vala support is enabled])
+	have_vala=yes
+    )
+    if test "x$have_vala" = "xyes"
+    then
+	    VALA_BINDIR=`pkg-config $VALA_MODULES --variable=bindir`
+	    AC_SUBST(VALA_BINDIR)
+	    VALA_COMPILER="$VALA_BINDIR/valac"
+	    AC_SUBST(VALA_COMPILER)
+	    VALA_VAPIGEN=`pkg-config $VALA_MODULES --variable=vapigen`
+	    AC_SUBST(VALA_VAPIGEN)
+	    VALA_VAPIDIR=`pkg-config $VALA_MODULES --variable=vapidir`
+	    AC_SUBST(VALA_VAPIDIR)
+	    
+        if test "x$enable_vala" = xauto
+        then
+            enable_vala=yes
+        fi
+    else
+        if test "x$enable_vala" = xyes
+        then
+            AC_MSG_ERROR([Vala support was requested but not available])
+        fi
+        if test "x$enable_vala" = xauto
+        then
+            enable_gda_gi=no
+        fi
+    fi
+else
+    if test "x$enable_vala" = xyes
+    then
+	AC_MSG_ERROR([Vala bindings for Libgda are requested but not available])
+    fi
+    if test "x$enable_vala" = xauto
+    then
+    	enable_vala=no
+    fi
+fi
+AM_CONDITIONAL(ENABLE_VALA, [test "$enable_vala" = "yes"])
+
+
+
 dnl ******************************
 dnl Checks for libcrypto
 dnl ******************************
@@ -966,6 +1022,7 @@ echo "   Building GTK+ UI extension: `if test x$have_ui != xno; then echo yes; e
 echo "   Building Libxslt extension: `if test x$have_xslt != xno; then echo yes; else echo no; fi`"
 echo "   Building libgda GObject Introspection: `if test x$enable_gda_gi != xno; then echo yes; else echo no; fi`"
 echo "   Building libgda-ui GObject Introspection: `if test x$enable_gdaui_gi != xno; then echo yes; else echo no; fi`"
+echo "   Building Vala Bindings: `if test x$enable_vala != xno; then echo yes; else echo no; fi`"
 echo "   Compiled providers:"
 echo "      Berkeley DB = $bdb_found"
 echo "      Berkeley DB SQL = $bdbsql_found"
diff --git a/libgda/Makefile.am b/libgda/Makefile.am
index a8a8012..61760c6 100644
--- a/libgda/Makefile.am
+++ b/libgda/Makefile.am
@@ -313,7 +313,8 @@ threadwrapper = \
 
 sqlparser = \
 	sql-parser/gda-sql-parser.h \
-	sql-parser/gda-sql-parser.c
+	sql-parser/gda-sql-parser.c \
+	sql-parser/gda-statement-struct-decl.h
 
 handlers = \
 	handlers/gda-handler-bin.h \
@@ -358,3 +359,19 @@ typelibs_DATA = $(INTROSPECTION_GIRS:.gir=.typelib)
 
 CLEANFILES += $(INTROSPECTION_GIRS) $(typelibs_DATA)
 endif
+
+if ENABLE_VALA
+
+vapi: libgda-4.0.vapi
+
+libgda-4.0.vapi:
+	$(VALA_VAPIGEN) --library libgda-4.0 --pkg libxml-2.0 Gda-4.0.gir 
+
+vapidir = $(VALA_VAPIDIR)
+vapi_DATA=libgda-4.0.vapi
+
+EXTRA_DIST += \
+        $(vapi_DATA)
+
+CLEANFILES += libgda-4.0.vapi
+endif
diff --git a/libgda/gda-connection.c b/libgda/gda-connection.c
index 6de10ca..e0434fa 100644
--- a/libgda/gda-connection.c
+++ b/libgda/gda-connection.c
@@ -5506,7 +5506,7 @@ gda_connection_get_meta_store_data_v (GdaConnection *cnc, GdaConnectionMetaType
  *
  * Warning: the @cnc object may change the list if connection events occur
  *
- * Returns: (transfer none): a #GList of #GdaConnectionEvent objects (the list should not be modified)
+ * Returns: (transfer none) (element-type Gda.ConnectionEvent): a #GList of #GdaConnectionEvent objects (the list should not be modified)
  */
 const GList *
 gda_connection_get_events (GdaConnection *cnc)
diff --git a/libgda/gda-data-model.c b/libgda/gda-data-model.c
index 7c13940..5e7d3ca 100644
--- a/libgda/gda-data-model.c
+++ b/libgda/gda-data-model.c
@@ -772,7 +772,7 @@ gda_data_model_set_value_at (GdaDataModel *model, gint col, gint row, const GVal
  * gda_data_model_set_values:
  * @model: a #GdaDataModel object.
  * @row: row number.
- * @values: (element-type GObject.Value) (transfer none) (allow-none): a list of #GValue (or %NULL), one for at most the number of columns of @model
+ * @values: (element-type GLib.Value) (transfer none) (allow-none): a list of #GValue (or %NULL), one for at most the number of columns of @model
  * @error: a place to store errors, or %NULL
  *
  * In a similar way to gda_data_model_set_value_at(), this method modifies a data model's contents
@@ -867,7 +867,7 @@ gda_data_model_create_iter (GdaDataModel *model)
 /**
  * gda_data_model_append_values:
  * @model: a #GdaDataModel object.
- * @values: (element-type GObject.Value) (allow-none): #GList of #GValue* representing the row to add.  The
+ * @values: (element-type GLib.Value) (allow-none): #GList of #GValue* representing the row to add.  The
  *          length must match model's column count.  These #GValue
  *	    are value-copied (the user is still responsible for freeing them).
  * @error: a place to store errors, or %NULL
@@ -967,7 +967,7 @@ gda_data_model_remove_row (GdaDataModel *model, gint row, GError **error)
 /**
  * gda_data_model_get_row_from_values:
  * @model: a #GdaDataModel object.
- * @values: (element-type GObject.Value): a list of #GValue values (no %NULL is allowed)
+ * @values: (element-type GLib.Value): a list of #GValue values (no %NULL is allowed)
  * @cols_index: (array): an array of #gint containing the column number to match each value of @values
  *
  * Returns the first row where all the values in @values at the columns identified at
diff --git a/libgda/gda-meta-store.c b/libgda/gda-meta-store.c
index 1f7e692..8f53599 100644
--- a/libgda/gda-meta-store.c
+++ b/libgda/gda-meta-store.c
@@ -397,7 +397,7 @@ gda_meta_store_class_init (GdaMetaStoreClass *klass)
 	/**
 	 * GdaMetaStore::meta-changed
 	 * @store: the #GdaMetaStore instance that emitted the signal
-	 * @changes: a list of changes made, as a #GSList of pointers to #GdaMetaStoreChange (which must not be modified)
+	 * @changes: (element-type Gda.MetaStoreChange): a list of changes made, as a #GSList of pointers to #GdaMetaStoreChange (which must not be modified)
 	 *
 	 * This signal is emitted when the @store's contents have changed (the changes are in the @changes list)
 	 */
diff --git a/libgda/gda-meta-struct.c b/libgda/gda-meta-struct.c
index e4a10e5..dbf4c7f 100644
--- a/libgda/gda-meta-struct.c
+++ b/libgda/gda-meta-struct.c
@@ -1835,7 +1835,7 @@ _meta_struct_get_db_object (GdaMetaStruct *mstruct, const GValue *catalog, const
  * Get a list of all the #GdaMetaDbObject structures representing database objects in @mstruct. Note that
  * no #GdaMetaDbObject structure must not be modified.
  *
- * Returns: (transfer container): a new #GSList list of pointers to #GdaMetaDbObject structures which must be destroyed after usage using g_slist_free(). The individual #GdaMetaDbObject must not be modified.
+ * Returns: (transfer container) (element-type Gda.MetaObject): a new #GSList list of pointers to #GdaMetaDbObject structures which must be destroyed after usage using g_slist_free(). The individual #GdaMetaDbObject must not be modified.
  */
 GSList *
 gda_meta_struct_get_all_db_objects (GdaMetaStruct *mstruct)
diff --git a/libgda/gda-meta-struct.h b/libgda/gda-meta-struct.h
index 4d8bdad..4a7d7f7 100644
--- a/libgda/gda-meta-struct.h
+++ b/libgda/gda-meta-struct.h
@@ -104,12 +104,12 @@ typedef enum {
 
 /**
  * GdaMetaTable:
- * @columns: list of #GdaMetaTableColumn structures, one for each column in the table
+ * @columns: (element-type Gda.MetaTableColumn): list of #GdaMetaTableColumn structures, one for each column in the table
  * @pk_cols_array: index of the columns part of the primary key for the table (WARNING: columns numbering
  *                 here start at 0)
  * @pk_cols_nb: size of the @pk_cols_array array
- * @reverse_fk_list: list of #GdaMetaTableForeignKey where the referenced table is this table
- * @fk_list: list of #GdaMetaTableForeignKey for this table
+ * @reverse_fk_list: (element-type Gda.MetaTableForeignKey): list of #GdaMetaTableForeignKey where the referenced table is this table
+ * @fk_list: (element-type Gda.MetaTableForeignKey): list of #GdaMetaTableForeignKey for this table
  *
  * This structure specifies a #GdaMetaDbObject to represent a table's specific attributes,
  * its contents must not be modified.
@@ -168,7 +168,7 @@ typedef struct {
  * @obj_short_name: the shortest way to name the object
  * @obj_full_name: the full name of the object (in the &lt;schema&gt;.&lt;nameagt; notation
  * @obj_owner: object's owner
- * @depend_list: list of #GdaMetaDbObject pointers on which this object depends (through foreign keys
+ * @depend_list: (element-type Gda.MetaDbObject): list of #GdaMetaDbObject pointers on which this object depends (through foreign keys
  *               or tables used for views)
  *
  * Struture to hold information about each database object (tables, views, ...),
diff --git a/libgda/gda-set.c b/libgda/gda-set.c
index d39a1c8..c142d4f 100644
--- a/libgda/gda-set.c
+++ b/libgda/gda-set.c
@@ -402,7 +402,7 @@ gda_set_init (GdaSet *set)
 
 /**
  * gda_set_new:
- * @holders: (element-type GdaHolder) (transfer:none): a list of #GdaHolder objects
+ * @holders: (element-type Gda.Holder) (transfer none): a list of #GdaHolder objects
  *
  * Creates a new #GdaSet object, and populates it with the list given as argument.
  * The list can then be freed as it is copied. All the value holders in @holders are referenced counted
@@ -425,7 +425,7 @@ gda_set_new (GSList *holders)
 
 /**
  * gda_set_new_read_only:
- * @holders: (element-type GdaHolder) (transfer:none): a list of #GdaHolder objects
+ * @holders: (element-type Gda.Holder) (transfer none): a list of #GdaHolder objects
  *
  * Creates a new #GdaSet like gda_set_new(), but does not allow modifications to any of the #GdaHolder
  * object in @holders. This function is used for Libgda's database providers' implementation.
diff --git a/libgda/gda-set.h b/libgda/gda-set.h
index f116c84..1ae450a 100644
--- a/libgda/gda-set.h
+++ b/libgda/gda-set.h
@@ -55,6 +55,11 @@ struct _GdaSetNode {
 	gpointer      _gda_reserved2;
 };
 
+/**
+ * GdaSetGroup:
+ * @nodes: (element-type Gda.SetNode): list of GdaSetNode, at least one entry
+ * @nodes_source: (allow-none):  if NULL, then @nodes contains exactly one entry 
+ */
 struct _GdaSetGroup {
 	GSList       *nodes;       /* list of GdaSetNode, at least one entry */
 	GdaSetSource *nodes_source; /* if NULL, then @nodes contains exactly one entry */
@@ -65,6 +70,12 @@ struct _GdaSetGroup {
 	gpointer      _gda_reserved2;
 };
 
+/**
+ * GdaSetSource:
+ * @data_model: Can't be NULL
+ * @nodes: (element-type Gda.SetNode): list of #GdaSetNode for which source_model == @data_model
+ *
+ **/
 struct _GdaSetSource {
 	GdaDataModel   *data_model;   /* Can't be NULL */
 	GSList         *nodes;        /* list of #GdaSetNode for which source_model == @data_model */
@@ -82,6 +93,15 @@ struct _GdaSetSource {
 #define GDA_SET_GROUP(x) ((GdaSetGroup *)(x))
 
 /* struct for the object's data */
+
+/**
+ * GdaSet:
+ * @holders: (element-type Gda.Holder): list of GdaHolder objects
+ * @nodes_list: (element-type Gda.SetNode): list of GdaSetNode
+ * @sources_list: (element-type Gda.SetSource): list of GdaSetSource 
+ * @groups_list: (element-type Gda.SetGroup): list of GdaSetGroup
+ *
+ */
 struct _GdaSet
 {
 	GObject         object;
diff --git a/libgda/gda-sql-builder.c b/libgda/gda-sql-builder.c
index 32cc592..9593379 100644
--- a/libgda/gda-sql-builder.c
+++ b/libgda/gda-sql-builder.c
@@ -352,7 +352,7 @@ gda_sql_builder_get_statement (GdaSqlBuilder *builder, GError **error)
 }
 
 /**
- * gda_sql_builder_get_sql_statement:
+ * gda_sql_builder_get_sql_statement: (skip)
  * @builder: a #GdaSqlBuilder object
  *
  * Creates a new #GdaSqlStatement structure from @builder's contents.
@@ -1039,7 +1039,7 @@ gda_sql_builder_add_param (GdaSqlBuilder *builder, const gchar *param_name, GTyp
 }
 
 /**
- * gda_sql_builder_add_cond:
+ * gda_sql_builder_add_cond: (skip)
  * @builder: a #GdaSqlBuilder object
  * @op: type of condition
  * @op1: the ID of the 1st argument (not 0)
@@ -1083,7 +1083,7 @@ gda_sql_builder_add_cond (GdaSqlBuilder *builder, GdaSqlOperatorType op, GdaSqlB
 }
 
 /**
- * gda_sql_builder_add_cond_v:
+ * gda_sql_builder_add_cond_v: (skip)
  * @builder: a #GdaSqlBuilder object
  * @op: type of condition
  * @op_ids: (array length=op_ids_size): an array of ID for the arguments (not %0)
@@ -1725,7 +1725,7 @@ gda_sql_builder_add_function_v (GdaSqlBuilder *builder, const gchar *func_name,
 }
 
 /**
- * gda_sql_builder_add_sub_select:
+ * gda_sql_builder_add_sub_select: (skip)
  * @builder: a #GdaSqlBuilder object
  * @sqlst: a pointer to a #GdaSqlStatement, which has to be a SELECT or compound SELECT. This will be copied.
  *
@@ -1764,7 +1764,7 @@ gda_sql_builder_add_sub_select (GdaSqlBuilder *builder, GdaSqlStatement *sqlst)
 }
 
 /**
- * gda_sql_builder_compound_set_type:
+ * gda_sql_builder_compound_set_type: (skip)
  * @builder: a #GdaSqlBuilder object
  * @compound_type: a type of compound
  *
@@ -1788,7 +1788,7 @@ gda_sql_builder_compound_set_type (GdaSqlBuilder *builder, GdaSqlStatementCompou
 }
 
 /**
- * gda_sql_builder_compound_add_sub_select:
+ * gda_sql_builder_compound_add_sub_select: (skip)
  * @builder: a #GdaSqlBuilder object
  * @sqlst: a pointer to a #GdaSqlStatement, which has to be a SELECT or compound SELECT. This will be copied.
  *
@@ -1946,7 +1946,7 @@ gda_sql_builder_add_case_v (GdaSqlBuilder *builder,
 }
 
 /**
- * gda_sql_builder_export_expression:
+ * gda_sql_builder_export_expression: (skip)
  * @builder: a #GdaSqlBuilder object
  * @id: the ID of the expression to be exported, (must be a valid ID in @builder, not %0)
  *
@@ -1973,8 +1973,8 @@ gda_sql_builder_export_expression (GdaSqlBuilder *builder, GdaSqlBuilderId id)
 }
 
 /**
- * gda_sql_builder_import_expression:
- * @builder: a #GdaSqlBuilder object
+ * gda_sql_builder_import_expression: (skip)
+ * @builder: a #GdaSqlBuilder object 
  * @expr: a #GdaSqlExpr obtained using gda_sql_builder_export_expression()
  *
  * Imports the @expr into @builder.
diff --git a/libgda/gda-statement-extra.h b/libgda/gda-statement-extra.h
index 9a83321..7b2744b 100644
--- a/libgda/gda-statement-extra.h
+++ b/libgda/gda-statement-extra.h
@@ -52,6 +52,16 @@ typedef gchar *(*GdaSqlRenderingPSpecFunc) (GdaSqlParamSpec *pspec, GdaSqlExpr *
 					    GError **error);
 typedef gchar *(*GdaSqlRenderingValue)     (const GValue *value, GdaSqlRenderingContext *context, GError **error);
 
+/**
+ * GdaSqlRenderingContext:
+ * @flags:
+ * @params:
+ * @params_used: (element-type Gda.Holder):
+ * @provider: (allow-none):
+ * @cnc: (allow-none):
+ *
+ * Specifies the context in which a #GdaSqlStatement is being converted to SQL.
+ */
 struct _GdaSqlRenderingContext {
 	GdaStatementSqlFlag      flags;
 	GdaSet                  *params;
diff --git a/libgda/gda-transaction-status.h b/libgda/gda-transaction-status.h
index 7d683a3..e4ca0a1 100644
--- a/libgda/gda-transaction-status.h
+++ b/libgda/gda-transaction-status.h
@@ -63,6 +63,14 @@ struct _GdaTransactionStatusEvent {
 	gpointer  _gda_reserved2;
 };
 
+/**
+ * GdaTransactionStatus:
+ * @name:
+ * @isolation_level:
+ * @state:
+ * @events: (element-type Gda.TransactionStatusEvent):
+ *
+ */
 struct _GdaTransactionStatus {
 	GObject                    object;
 	
diff --git a/libgda/gda-tree-manager.c b/libgda/gda-tree-manager.c
index dd6afb1..20af905 100644
--- a/libgda/gda-tree-manager.c
+++ b/libgda/gda-tree-manager.c
@@ -458,7 +458,7 @@ gda_tree_manager_add_manager (GdaTreeManager *manager, GdaTreeManager *sub)
  *
  * Get the list of sub managers which have already been added using gda_tree_manager_add_manager()
  *
- * Returns: (transfer none): a list of #GdaTreeMenager which should not be modified.
+ * Returns: (transfer none) (element-type Gda.TreeManager): a list of #GdaTreeMenager which should not be modified.
  *
  * Since: 4.2
  */
diff --git a/libgda/gda-types.h b/libgda/gda-types.h
index b546a05..e677f8b 100644
--- a/libgda/gda-types.h
+++ b/libgda/gda-types.h
@@ -29,11 +29,19 @@ G_BEGIN_DECLS
 
 /* Boxed type for GError will not be done in GLib see bug #300610 */
 #define GDA_TYPE_ERROR (_gda_error_get_type())
+/**
+ * GdaError: (skip)
+ *
+ */
 typedef GError GdaError;
 GType   _gda_error_get_type (void) G_GNUC_CONST;
 
 /* Pointer type for GSList (not a boxed type!) */
 #define GDA_TYPE_SLIST (_gda_slist_get_type())
+/**
+ * GdaSList: (skip)
+ *
+ */
 typedef GSList GdaSList;
 GType   _gda_slist_get_type (void) G_GNUC_CONST;
 
diff --git a/libgda/gda-util.c b/libgda/gda-util.c
index 47ed89d..c726e49 100644
--- a/libgda/gda-util.c
+++ b/libgda/gda-util.c
@@ -594,7 +594,7 @@ gda_utility_data_model_find_column_description (GdaDataSelect *model, const gcha
  * gda_utility_holder_load_attributes:
  * @holder: a #GdaHolder
  * @node: an xmlNodePtr with a &lt;parameter&gt; tag
- * @sources: a list of #GdaDataModel
+ * @sources: (element-type Gda.DataModel): a list of #GdaDataModel
  * @error: a place to store errors, or %NULL
  *
  * Note: this method may set the "source" custom string property
diff --git a/libgda/gda-xa-transaction.c b/libgda/gda-xa-transaction.c
index 66b0aff..6942325 100644
--- a/libgda/gda-xa-transaction.c
+++ b/libgda/gda-xa-transaction.c
@@ -439,7 +439,7 @@ gda_xa_transaction_begin  (GdaXaTransaction *xa_trans, GError **error)
 /**
  * gda_xa_transaction_commit:
  * @xa_trans: a #GdaXaTransaction object
- * @cnc_to_recover: (allow-none): a place to store the list of connections for which the commit phase failed, or %NULL
+ * @cnc_to_recover: (allow-none) (element-type Gda.Connection) (out callee-allocates): a place to store the list of connections for which the commit phase failed, or %NULL
  * @error: a place to store errors, or %NULL
  *
  * Commits a distributed transaction (managed by @xa_trans). The commit is composed of two phases:
@@ -619,7 +619,7 @@ gda_xa_transaction_rollback (GdaXaTransaction *xa_trans, GError **error)
 /**
  * gda_xa_transaction_commit_recovered:
  * @xa_trans: a #GdaXaTransaction object
- * @cnc_to_recover: (allow-none): a place to store the list of connections for which the there were data to recover and which failed to be actually committed, or %NULL
+ * @cnc_to_recover: (allow-none) (element-type Gda.Connection) (out callee-allocates): a place to store the list of connections for which the there were data to recover and which failed to be actually committed, or %NULL
  * @error: (allow-none): a place to store errors, or %NULL
  *
  * Tries to commit the data prepared but which failed to commit (see gda_xa_transaction_commit()). This
diff --git a/libgda/providers-support/gda-pstmt.h b/libgda/providers-support/gda-pstmt.h
index 211f2c6..3caedeb 100644
--- a/libgda/providers-support/gda-pstmt.h
+++ b/libgda/providers-support/gda-pstmt.h
@@ -35,6 +35,15 @@ typedef struct _GdaPStmt        GdaPStmt;
 typedef struct _GdaPStmtPrivate GdaPStmtPrivate;
 typedef struct _GdaPStmtClass   GdaPStmtClass;
 
+/**
+ * GdaPStmt:
+ * @sql: actual SQL code used for this prepared statement, mem freed by GdaPStmt
+ * @param_ids: (element-type string): list of parameters' IDs (as gchar *), mem freed by GdaPStmt
+ * @ncols: number of types in array
+ * @types: (array length=ncols) (element-type GLib.Type): array of ncols types
+ * @tmpl_columns: (element-type Gda.Colum): list of #GdaColumn objects which data models created from this prep. statement can copy
+ *
+ */
 struct _GdaPStmt {
 	GObject       object;
 
diff --git a/libgda/sql-parser/gda-statement-struct-decl.h b/libgda/sql-parser/gda-statement-struct-decl.h
index 6f5f54f..99a419c 100644
--- a/libgda/sql-parser/gda-statement-struct-decl.h
+++ b/libgda/sql-parser/gda-statement-struct-decl.h
@@ -80,6 +80,10 @@ typedef enum {
 /*
  * Structures identification
  */
+/**
+ * GdaSqlAnyPartType: (skip)
+ *
+ */
 typedef enum {
 	/* complete statements */
 	GDA_SQL_ANY_STMT_SELECT = GDA_SQL_STATEMENT_SELECT,
@@ -109,6 +113,10 @@ typedef enum {
 	GDA_SQL_ANY_SQL_SELECT_ORDER
 } GdaSqlAnyPartType;
 
+/**
+ * GdaSqlAnyPart: (skip)
+ *
+ */
 struct _GdaSqlAnyPart {
 	GdaSqlAnyPartType  type;
 	GdaSqlAnyPart     *parent;
@@ -135,6 +143,10 @@ gboolean gda_sql_any_part_check_structure (GdaSqlAnyPart *node, GError **error);
 /*
  * Contents' infos
  */
+/**
+ * GdaSqlStatementContentsInfo: (skip)
+ *
+ */
 typedef struct {
 	GdaSqlStatementType  type;
 	gchar               *name;
@@ -157,7 +169,10 @@ typedef struct {
 /*
  * Validation against a dictionary
  */
-
+/**
+ * GdaSqlStatementCheckValidityData: (skip)
+ *
+ */
 typedef struct {
 	GdaConnection *cnc;
 	GdaMetaStore  *store;
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]