[libgda] GdaStatementStruct* adding GI annotations

[Daniel Espinosa Ortiz <despinosa src gnome org>]

commit 4a10467ccf4c0fd51ae48cc0ccf001d8a2559edc
Author: Daniel Espinosa <esodan gmail com>
Date:   Tue Jul 10 09:05:46 2018 -0500

    GdaStatementStruct* adding GI annotations

 libgda/sql-parser/gda-statement-struct-insert.c  |  6 +++---
 libgda/sql-parser/gda-statement-struct-parts.c   | 14 +++++++-------
 libgda/sql-parser/gda-statement-struct-pspec.c   |  2 +-
 libgda/sql-parser/gda-statement-struct-select.c  | 22 +++++++++++-----------
 libgda/sql-parser/gda-statement-struct-unknown.c |  4 ++--
 libgda/sql-parser/gda-statement-struct.c         | 10 +++++-----
 6 files changed, 29 insertions(+), 29 deletions(-)
---
diff --git a/libgda/sql-parser/gda-statement-struct-insert.c b/libgda/sql-parser/gda-statement-struct-insert.c
index 0a25d10c9..adaff71f0 100644
--- a/libgda/sql-parser/gda-statement-struct-insert.c
+++ b/libgda/sql-parser/gda-statement-struct-insert.c
@@ -282,7 +282,7 @@ gda_sql_statement_insert_take_fields_list (GdaSqlStatement *stmt, GSList *list)
 }
 
 /**
- * gda_sql_statement_insert_take_1_values_list
+ * gda_sql_statement_insert_take_1_values_list:
  * @stmt: a #GdaSqlStatement pointer
  * @list: a list of #GdaSqlExpr pointers
  *
@@ -302,9 +302,9 @@ gda_sql_statement_insert_take_1_values_list (GdaSqlStatement *stmt, GSList *list
 }
 
 /**
- * gda_sql_statement_insert_take_1_values_list
+ * gda_sql_statement_insert_take_extra_values_list:
  * @stmt: a #GdaSqlStatement pointer
- * @list: a list of #GSList of #GdaSqlExpr pointers
+ * @list: (element-type GdaSqlExpr): a list of #GSList of #GdaSqlExpr pointers
  *
  * Sets a list of list of values to be inserted by @stmt. @list's 
  * ownership is transferred to
diff --git a/libgda/sql-parser/gda-statement-struct-parts.c b/libgda/sql-parser/gda-statement-struct-parts.c
index 485bc5924..55417f444 100644
--- a/libgda/sql-parser/gda-statement-struct-parts.c
+++ b/libgda/sql-parser/gda-statement-struct-parts.c
@@ -398,13 +398,13 @@ gda_sql_table_copy (GdaSqlTable *table)
 }
 
 /**
- * gda_sql_table_serialize
- * @field: a #GdaSqlTable structure
+ * gda_sql_table_serialize:
+ * @table: a #GdaSqlTable structure
  *
  * Creates a new string representing a table. You need to free the returned string
  * using g_free();
  *
- * Returns: a new string with the name of the field or "null" in case @table is invalid.
+ * Returns: (transfer full): a new string with the name of the field or "null" in case @table is invalid.
  */
 gchar *
 gda_sql_table_serialize (GdaSqlTable *table)
@@ -416,8 +416,8 @@ gda_sql_table_serialize (GdaSqlTable *table)
 }
 
 /**
- * gda_sql_table_take_name
- * @field: a #GdaSqlTable structure
+ * gda_sql_table_take_name:
+ * @table: a #GdaSqlTable structure
  * @value: a #GValue holding a string to take from
  *
  * Sets the table's name using the string held by @value. When call, @value is freed using
@@ -1294,7 +1294,7 @@ gda_sql_select_target_serialize (GdaSqlSelectTarget *target)
 }
 
 /**
- * gda_sql_select_target_take_table_name
+ * gda_sql_select_target_take_table_name:
  * @target: a #GdaSqlSelectTarget structure
  * @value: a #GValue to take from
  *
@@ -1313,7 +1313,7 @@ gda_sql_select_target_take_table_name (GdaSqlSelectTarget *target, GValue *value
 }
 
 /**
- * gda_sql_select_target_take_table_name
+ * gda_sql_select_target_take_select:
  * @target: a #GdaSqlSelectTarget structure
  * @stmt: a #GValue to take from
  *
diff --git a/libgda/sql-parser/gda-statement-struct-pspec.c b/libgda/sql-parser/gda-statement-struct-pspec.c
index 9733561b6..f37dfb65b 100644
--- a/libgda/sql-parser/gda-statement-struct-pspec.c
+++ b/libgda/sql-parser/gda-statement-struct-pspec.c
@@ -127,7 +127,7 @@ gda_sql_param_spec_take_type (GdaSqlParamSpec *pspec, GValue *value)
  *
  * @value is destroyed by this function.
  *
- * Returns: a new #GdaSqlParamSpec
+ * Returns: (transfer full): a new #GdaSqlParamSpec
  */
 GdaSqlParamSpec *
 gda_sql_param_spec_new (GValue *value)
diff --git a/libgda/sql-parser/gda-statement-struct-select.c b/libgda/sql-parser/gda-statement-struct-select.c
index e48d00714..4b0c5d011 100644
--- a/libgda/sql-parser/gda-statement-struct-select.c
+++ b/libgda/sql-parser/gda-statement-struct-select.c
@@ -244,7 +244,7 @@ _gda_sql_statement_select_serialize (gpointer stmt)
 }
 
 /**
- * gda_sql_statement_select_take_distinct
+ * gda_sql_statement_select_take_distinct:
  * @stmt: a #GdaSqlStatement pointer
  * @distinct: a TRUE/FALSE value
  * @distinct_expr: (allow-none): a #GdaSqlExpr pointer representing what the DISTINCT is on, or %NULL
@@ -264,9 +264,9 @@ gda_sql_statement_select_take_distinct (GdaSqlStatement *stmt, gboolean distinct
 }
 
 /**
- * gda_sql_statement_select_take_expr_list
+ * gda_sql_statement_select_take_expr_list:
  * @stmt: a #GdaSqlStatement pointer
- * @expr_list: a list of #GdaSqlSelectField pointers
+ * @expr_list: (element-type GdaSqlSelectField): a list of #GdaSqlSelectField pointers
  *
  * Sets list of expressions selected by @stmt
  *
@@ -284,7 +284,7 @@ gda_sql_statement_select_take_expr_list (GdaSqlStatement *stmt, GSList *expr_lis
 }
 
 /**
- * gda_sql_statement_select_take_from
+ * gda_sql_statement_select_take_from:
  * @stmt: a #GdaSqlStatement pointer
  * @from: a #GdaSqlSelectFrom pointer
  *
@@ -302,7 +302,7 @@ gda_sql_statement_select_take_from (GdaSqlStatement *stmt, GdaSqlSelectFrom *fro
 }
 
 /**
- * gda_sql_statement_select_take_where_cond
+ * gda_sql_statement_select_take_where_cond:
  * @stmt: a #GdaSqlStatement pointer
  * @expr: a #GdaSqlExpr pointer
  *
@@ -320,9 +320,9 @@ gda_sql_statement_select_take_where_cond (GdaSqlStatement *stmt, GdaSqlExpr *exp
 }
 
 /**
- * gda_sql_statement_select_take_group_by
+ * gda_sql_statement_select_take_group_by:
  * @stmt: a #GdaSqlStatement pointer
- * @group_by: a list of #GdaSqlExpr pointer
+ * @group_by: (element-type GdaSqlExpr): a list of #GdaSqlExpr pointer
  *
  * Sets the GROUP BY clause of @stmt
  *
@@ -340,7 +340,7 @@ gda_sql_statement_select_take_group_by (GdaSqlStatement *stmt, GSList *group_by)
 }
 
 /**
- * gda_sql_statement_select_take_having_cond
+ * gda_sql_statement_select_take_having_cond:
  * @stmt: a #GdaSqlStatement pointer
  * @expr: a #GdaSqlExpr pointer
  *
@@ -358,9 +358,9 @@ gda_sql_statement_select_take_having_cond (GdaSqlStatement *stmt, GdaSqlExpr *ex
 }
 
 /**
- * gda_sql_statement_select_take_order_by
+ * gda_sql_statement_select_take_order_by:
  * @stmt: a #GdaSqlStatement pointer
- * @order_by: a list of #GdaSqlSelectOrder pointer
+ * @order_by: (element-type GdaSqlSelectOrder): a list of #GdaSqlSelectOrder pointer
  *
  * Sets the ORDER BY clause of @stmt
  *
@@ -378,7 +378,7 @@ gda_sql_statement_select_take_order_by (GdaSqlStatement *stmt, GSList *order_by)
 }
 
 /**
- * gda_sql_statement_select_take_limits
+ * gda_sql_statement_select_take_limits:
  * @stmt: a #GdaSqlStatement pointer
  * @count: a #GdaSqlExpr pointer
  * @offset: a #GdaSqlExpr pointer
diff --git a/libgda/sql-parser/gda-statement-struct-unknown.c 
b/libgda/sql-parser/gda-statement-struct-unknown.c
index 003b42247..6b6e83b5a 100644
--- a/libgda/sql-parser/gda-statement-struct-unknown.c
+++ b/libgda/sql-parser/gda-statement-struct-unknown.c
@@ -112,9 +112,9 @@ gda_sql_statement_unknown_serialize (gpointer stmt)
 }
 
 /**
- * gda_sql_statement_unknown_take_expressions
+ * gda_sql_statement_unknown_take_expressions:
  * @stmt: a #GdaSqlStatement pointer
- * @expressions: a list of #GdaSqlExpr pointers
+ * @expressions: (element-type GdaSqlExpr): a list of #GdaSqlExpr pointers
  *
  * Sets @stmt's list of expressions
  *
diff --git a/libgda/sql-parser/gda-statement-struct.c b/libgda/sql-parser/gda-statement-struct.c
index f3c422ad3..715bb43d1 100644
--- a/libgda/sql-parser/gda-statement-struct.c
+++ b/libgda/sql-parser/gda-statement-struct.c
@@ -308,9 +308,9 @@ static gboolean gda_sql_select_field_check_validity (GdaSqlSelectField *field, G
 static gboolean gda_sql_select_target_check_validity (GdaSqlSelectTarget *target, 
GdaSqlStatementCheckValidityData *data, GError **error);
 
 /**
- * gda_sql_statement_check_validity
+ * gda_sql_statement_check_validity:
  * @stmt: a #GdaSqlStatement pointer
- * @cnc: (allow-none): a #GdaConnection object, or %NULL
+ * @cnc: (nullable): a #GdaConnection object, or %NULL
  * @error: a place to store errors, or %NULL
  *
  * If @cnc is not %NULL, then checks that all the database objects referenced in the statement actually
@@ -360,7 +360,7 @@ gda_sql_statement_check_validity (GdaSqlStatement *stmt, GdaConnection *cnc, GEr
 /**
  * gda_sql_statement_check_validity_m
  * @stmt: a #GdaSqlStatement pointer
- * @mstruct: (allow-none): a #GdaMetaStruct object, or %NULL
+ * @mstruct: (nullable): a #GdaMetaStruct object, or %NULL
  * @error: a place to store errors, or %NULL
  *
  * If @mstruct is not %NULL, then checks that all the database objects referenced in the statement i
@@ -1390,9 +1390,9 @@ gda_sql_any_part_foreach (GdaSqlAnyPart *node, GdaSqlForeachFunc func, gpointer
 static gboolean foreach_normalize (GdaSqlAnyPart *node, GdaConnection *cnc, GError **error);
 
 /**
- * gda_sql_statement_normalize
+ * gda_sql_statement_normalize:
  * @stmt: a pointer to a #GdaSqlStatement structure
- * @cnc: (allow-none): a #GdaConnection object, or %NULL
+ * @cnc: (nullable): a #GdaConnection object, or %NULL
  * @error: a place to store errors, or %NULL
  *
  * "Normalizes" (in place) some parts of @stmt, which means @stmt may be modified.