[libgda/LIBGDA_4.2] Introspection improvements



commit 415e49cb2ce2f66090e2e3cba6d7bf9d6b59329e
Author: Vivien Malerba <malerba gnome-db org>
Date:   Wed Sep 21 16:12:06 2011 +0200

    Introspection improvements

 libgda/gda-data-model-bdb.c                   |    2 +-
 libgda/gda-data-model-ldap.c                  |    2 +-
 libgda/gda-data-select.c                      |    2 +-
 libgda/gda-sql-builder.c                      |    4 +-
 libgda/gda-util.c                             |    8 +++---
 libgda/handlers/gda-handler-time.c            |    6 ++--
 libgda/sql-parser/gda-statement-struct-decl.h |   36 ++++++++++++++++++++++++-
 7 files changed, 47 insertions(+), 13 deletions(-)
---
diff --git a/libgda/gda-data-model-bdb.c b/libgda/gda-data-model-bdb.c
index 22658b4..e43e027 100644
--- a/libgda/gda-data-model-bdb.c
+++ b/libgda/gda-data-model-bdb.c
@@ -468,7 +468,7 @@ gda_data_model_bdb_get_property (GObject *object,
  * Creates a new #GdaDataModel object to access the contents of the Berkeley DB file @file,
  * for the database @db_name if not %NULL
  *
- * Returns: a new #GdaDataModel
+ * Returns: (transfer full): a new #GdaDataModel
  */
 GdaDataModel *
 gda_data_model_bdb_new (const gchar *filename, const gchar *db_name)
diff --git a/libgda/gda-data-model-ldap.c b/libgda/gda-data-model-ldap.c
index 792534a..074cd05 100644
--- a/libgda/gda-data-model-ldap.c
+++ b/libgda/gda-data-model-ldap.c
@@ -197,7 +197,7 @@ gda_data_model_ldap_get_type (void)
  * In case of multi valued attributes, an error will be returned when trying to read the attribute:
  * gda_data_model_iter_get_value_at() will return %NULL when using an iterator.
  *
- * Returns: a new #GdaDataModel
+ * Returns: (transfer full): a new #GdaDataModel
  *
  * Since: 4.2.8
  */
diff --git a/libgda/gda-data-select.c b/libgda/gda-data-select.c
index 9e6481d..df4a359 100644
--- a/libgda/gda-data-select.c
+++ b/libgda/gda-data-select.c
@@ -1483,7 +1483,7 @@ row_selection_condition_foreach_func (GdaSqlAnyPart *part, G_GNUC_UNUSED gpointe
 }
 
 /**
- * gda_data_select_set_row_selection_condition:
+ * gda_data_select_set_row_selection_condition: (skip)
  * @model: a #GdaDataSelect data model
  * @expr: (transfer none): a #GdaSqlExpr expression
  * @error: a place to store errors, or %NULL
diff --git a/libgda/gda-sql-builder.c b/libgda/gda-sql-builder.c
index 9593379..3c06eb3 100644
--- a/libgda/gda-sql-builder.c
+++ b/libgda/gda-sql-builder.c
@@ -1267,7 +1267,7 @@ typedef struct {
 } BuilderJoin;
 
 /**
- * gda_sql_builder_select_join_targets:
+ * gda_sql_builder_select_join_targets: (skip)
  * @builder: a #GdaSqlBuilder object
  * @left_target_id: the ID of the left target to use (not %0)
  * @right_target_id: the ID of the right target to use (not %0)
@@ -1974,7 +1974,7 @@ gda_sql_builder_export_expression (GdaSqlBuilder *builder, GdaSqlBuilderId id)
 
 /**
  * gda_sql_builder_import_expression: (skip)
- * @builder: a #GdaSqlBuilder object 
+ * @builder: a #GdaSqlBuilder object
  * @expr: a #GdaSqlExpr obtained using gda_sql_builder_export_expression()
  *
  * Imports the @expr into @builder.
diff --git a/libgda/gda-util.c b/libgda/gda-util.c
index c726e49..0ff81ad 100644
--- a/libgda/gda-util.c
+++ b/libgda/gda-util.c
@@ -890,7 +890,7 @@ dml_statements_check_select_structure (GdaConnection *cnc, GdaSqlStatement *sel_
 }
 
 /**
- * gda_compute_unique_table_row_condition_with_cnc:
+ * gda_compute_unique_table_row_condition_with_cnc:  (skip)
  * @cnc: (allow-none): a #GdaConnection, or %NULL
  * @stsel: a #GdaSqlSelectStatement
  * @mtable: a #GdaMetaTable
@@ -1068,7 +1068,7 @@ gda_compute_unique_table_row_condition_with_cnc (GdaConnection *cnc, GdaSqlState
 }
 
 /**
- * gda_compute_unique_table_row_condition:
+ * gda_compute_unique_table_row_condition: (skip)
  * @stsel: a #GdaSqlSelectStatement
  * @mtable: a #GdaMetaTable
  * @require_pk: set to TRUE if a primary key ir required
@@ -1309,7 +1309,7 @@ gda_compute_dml_statements (GdaConnection *cnc, GdaStatement *select_stmt, gbool
 }
 
 /**
- * gda_compute_select_statement_from_update:
+ * gda_compute_select_statement_from_update: (skip)
  * @update_stmt: an UPDATE statement
  * @error: a place to store errors, or %NULL
  *
@@ -1643,7 +1643,7 @@ static gboolean stmt_rewrite_update_default_keyword (GdaSqlStatementUpdate *upd,
 
 
 /**
- * gda_statement_rewrite_for_default_values:
+ * gda_statement_rewrite_for_default_values: (skip)
  * @stmt: a #GdaStatement object
  * @params: a #GdaSet containing the variable's values to be bound when executing @stmt
  * @remove: set to %TRUE if DEFAULT fields are removed, of %FALSE if the "DEFAULT" keyword is used
diff --git a/libgda/handlers/gda-handler-time.c b/libgda/handlers/gda-handler-time.c
index 1cb1da9..5db014e 100644
--- a/libgda/handlers/gda-handler-time.c
+++ b/libgda/handlers/gda-handler-time.c
@@ -426,10 +426,10 @@ handler_compute_locale (GdaHandlerTime *hdl)
 /**
  * gda_handler_time_get_no_locale_str_from_value:
  * @hdl: a #GdaHandlerTime object
- * @value: a GValue value
+ * @value: a #GValue value
  *
- * Retunrs: a new string representing @value without taking the current
- * locele into account
+ * Returns: a new string representing @value without taking the current
+ * locale into account
  */
 gchar *
 gda_handler_time_get_no_locale_str_from_value (GdaHandlerTime *hdl, const GValue *value)
diff --git a/libgda/sql-parser/gda-statement-struct-decl.h b/libgda/sql-parser/gda-statement-struct-decl.h
index 99a419c..81457a0 100644
--- a/libgda/sql-parser/gda-statement-struct-decl.h
+++ b/libgda/sql-parser/gda-statement-struct-decl.h
@@ -82,6 +82,29 @@ typedef enum {
  */
 /**
  * GdaSqlAnyPartType: (skip)
+ * @GDA_SQL_ANY_STMT_SELECT: structure is a #GdaSqlStatementSelect
+ * @GDA_SQL_ANY_STMT_INSERT: structure is a #GdaSqlStatementInsert
+ * @GDA_SQL_ANY_STMT_UPDATE: structure is a #GdaSqlStatementUpdate
+ * @GDA_SQL_ANY_STMT_DELETE: structure is a #GdaSqlStatementDelete
+ * @GDA_SQL_ANY_STMT_COMPOUND: structure is a #GdaSqlStatementCompound
+ * @GDA_SQL_ANY_STMT_BEGIN: structure is a #GdaSqlStatementTransaction
+ * @GDA_SQL_ANY_STMT_ROLLBACK: structure is a #GdaSqlStatementTransaction
+ * @GDA_SQL_ANY_STMT_COMMIT: structure is a #GdaSqlStatementTransaction
+ * @GDA_SQL_ANY_STMT_SAVEPOINT: structure is a #GdaSqlStatementTransaction
+ * @GDA_SQL_ANY_STMT_ROLLBACK_SAVEPOINT: structure is a #GdaSqlStatementTransaction
+ * @GDA_SQL_ANY_STMT_DELETE_SAVEPOINT: structure is a #GdaSqlStatementTransaction
+ * @GDA_SQL_ANY_STMT_UNKNOWN: structure is a #GdaSqlStatementUnknown
+ * @GDA_SQL_ANY_EXPR: structure is a #GdaSqlExpr
+ * @GDA_SQL_ANY_SQL_FIELD: structure is a #GdaSqlField
+ * @GDA_SQL_ANY_SQL_TABLE: structure is a #GdaSqlTable
+ * @GDA_SQL_ANY_SQL_FUNCTION: structure is a #GdaSqlFunction
+ * @GDA_SQL_ANY_SQL_OPERATION: structure is a #GdaSqlOperation
+ * @GDA_SQL_ANY_SQL_CASE: structure is a #GdaSqlCase
+ * @GDA_SQL_ANY_SQL_SELECT_FIELD: structure is a #GdaSqlSelectField
+ * @GDA_SQL_ANY_SQL_SELECT_TARGET: structure is a #GdaSqlSelectTarget
+ * @GDA_SQL_ANY_SQL_SELECT_JOIN: structure is a #GdaSqlSelectJoin
+ * @GDA_SQL_ANY_SQL_SELECT_FROM: structure is a #GdaSqlSelectFrom
+ * @GDA_SQL_ANY_SQL_SELECT_ORDER: structure is a #GdaSqlSelectOrder
  *
  */
 typedef enum {
@@ -115,6 +138,8 @@ typedef enum {
 
 /**
  * GdaSqlAnyPart: (skip)
+ * @type: type of structure, as a #GdaSqlAnyPartType enum.
+ * @parent: pointer to the parent #GdaSqlAnyPart structure
  *
  */
 struct _GdaSqlAnyPart {
@@ -131,7 +156,16 @@ struct _GdaSqlAnyPart {
  */
 
 /* returns FALSE if a recursive walking should be stopped (mandatory is @error is set) */
-typedef gboolean (*GdaSqlForeachFunc) (GdaSqlAnyPart *, gpointer, GError **);
+/**
+ * GdaSqlForeachFunc: (skip)
+ * @part: the current #GdaSqlAnyPart node
+ * @data: user data passed to gda_sql_any_part_foreach().
+ * @error: pointer to a place to store errors
+ * @Returns: FALSE if the gda_sql_any_part_foreach() should stop at this point and fail
+ *
+ * Specifies the type of functions passed to gda_sql_any_part_foreach().
+ */
+typedef gboolean (*GdaSqlForeachFunc) (GdaSqlAnyPart *part, gpointer data, GError **error);
 
 gboolean gda_sql_any_part_foreach (GdaSqlAnyPart *node, GdaSqlForeachFunc func, gpointer data, GError **error);
 



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]