[libgda] Improved documentation syntax

From: Vivien Malerba <vivien src gnome org>
To: commits-list gnome org
Cc:
Subject: [libgda] Improved documentation syntax
Date: Sun, 3 Jun 2012 16:03:33 +0000 (UTC)
commit 35f5a54ede4c75b7afb43b477ec49120ce832a31
Author: Vivien Malerba <malerba gnome-db org>
Date:   Sun Jun 3 18:00:36 2012 +0200

    Improved documentation syntax

 libgda/gda-batch.c                         |    2 +-
 libgda/gda-column.c                        |    4 +-
 libgda/gda-connection.c                    |   16 +++---
 libgda/gda-connection.h                    |    2 +-
 libgda/gda-data-meta-wrapper.c             |    6 +-
 libgda/gda-data-model-iter.c               |    4 +-
 libgda/gda-data-model.c                    |   12 ++--
 libgda/gda-data-pivot.c                    |    2 +-
 libgda/gda-data-proxy.c                    |   12 ++--
 libgda/gda-data-select.c                   |    2 +-
 libgda/gda-enums.h                         |    2 +-
 libgda/gda-holder.c                        |    8 ++--
 libgda/gda-holder.h                        |    8 ++--
 libgda/gda-meta-struct.h                   |    6 +-
 libgda/gda-quark-list.c                    |    8 ++--
 libgda/gda-server-operation.c              |    4 +-
 libgda/gda-set.c                           |   14 +++---
 libgda/gda-statement-extra.h               |   12 +----
 libgda/gda-statement.c                     |    4 +-
 libgda/gda-tree-manager.h                  |    2 +-
 libgda/gda-tree-mgr-ldap.c                 |    2 +-
 libgda/gda-tree-mgr-tables.c               |    2 +-
 libgda/gda-tree-node.c                     |    8 ++--
 libgda/gda-tree.c                          |   10 ++--
 libgda/gda-util.c                          |    2 +-
 libgda/gda-value.c                         |   72 ++++++++++++++--------------
 libgda/gda-value.h                         |    4 +-
 libgda/providers-support/gda-pstmt.c       |    6 +-
 libgda/thread-wrapper/gda-thread-wrapper.c |   14 +++---
 29 files changed, 121 insertions(+), 129 deletions(-)
---
diff --git a/libgda/gda-batch.c b/libgda/gda-batch.c
index 62a6972..4f2a2f1 100644
--- a/libgda/gda-batch.c
+++ b/libgda/gda-batch.c
@@ -111,7 +111,7 @@ gda_batch_class_init (GdaBatchClass * klass)
 	parent_class = g_type_class_peek_parent (klass);
 
 	/**
-	 * GdaBatch::changed
+	 * GdaBatch::changed:
 	 * @batch: the #GdaBatch object
 	 * @changed_stmt: the statement which has been changed
 	 *
diff --git a/libgda/gda-column.c b/libgda/gda-column.c
index 1d810f7..82822e9 100644
--- a/libgda/gda-column.c
+++ b/libgda/gda-column.c
@@ -89,7 +89,7 @@ gda_column_class_init (GdaColumnClass *klass)
 	
 	/* signals */
 	/**
-	 * GdaColumn::name-changed
+	 * GdaColumn::name-changed:
 	 * @column: the #GdaColumn object
 	 * @old_name: the column's previous name
 	 *
@@ -105,7 +105,7 @@ gda_column_class_init (GdaColumnClass *klass)
 			      G_TYPE_NONE,
 			      1, G_TYPE_STRING);
 	/**
-	 * GdaColumn::g-type-changed
+	 * GdaColumn::g-type-changed:
 	 * @column: the #GdaColumn object
 	 * @old_type: the column's previous type
 	 * @new_type: the column's new type
diff --git a/libgda/gda-connection.c b/libgda/gda-connection.c
index be5ec42..f0a4d1e 100644
--- a/libgda/gda-connection.c
+++ b/libgda/gda-connection.c
@@ -255,7 +255,7 @@ gda_connection_class_init (GdaConnectionClass *klass)
 	parent_class = g_type_class_peek_parent (klass);
 
 	/**
-	 * GdaConnection::error
+	 * GdaConnection::error:
 	 * @cnc: the #GdaConnection
 	 * @event: a #GdaConnectionEvent object
 	 *
@@ -271,7 +271,7 @@ gda_connection_class_init (GdaConnectionClass *klass)
 			      g_cclosure_marshal_VOID__OBJECT,
 			      G_TYPE_NONE, 1, GDA_TYPE_CONNECTION_EVENT);
 	/**
-	 * GdaConnection::conn-opened
+	 * GdaConnection::conn-opened:
 	 * @cnc: the #GdaConnection
 	 *
 	 * Gets emitted when the connection has been opened to the database
@@ -285,7 +285,7 @@ gda_connection_class_init (GdaConnectionClass *klass)
                               _gda_marshal_VOID__VOID,
                               G_TYPE_NONE, 0);
 	/**
-	 * GdaConnection::conn-to-close
+	 * GdaConnection::conn-to-close:
 	 * @cnc: the #GdaConnection
 	 *
 	 * Gets emitted when the connection to the database is about to be closed
@@ -299,7 +299,7 @@ gda_connection_class_init (GdaConnectionClass *klass)
                               _gda_marshal_VOID__VOID,
                               G_TYPE_NONE, 0);
 	/**
-	 * GdaConnection::conn-closed
+	 * GdaConnection::conn-closed:
 	 * @cnc: the #GdaConnection
 	 *
 	 * Gets emitted when the connection to the database has been closed
@@ -313,7 +313,7 @@ gda_connection_class_init (GdaConnectionClass *klass)
                               _gda_marshal_VOID__VOID,
                               G_TYPE_NONE, 0);
 	/**
-	 * GdaConnection::dsn-changed
+	 * GdaConnection::dsn-changed:
 	 * @cnc: the #GdaConnection
 	 *
 	 * Gets emitted when the DSN used by @cnc has been changed
@@ -327,7 +327,7 @@ gda_connection_class_init (GdaConnectionClass *klass)
 			      g_cclosure_marshal_VOID__VOID,
 			      G_TYPE_NONE, 0);
 	/**
-	 * GdaConnection::transaction-status-changed
+	 * GdaConnection::transaction-status-changed:
 	 * @cnc: the #GdaConnection
 	 *
 	 * Gets emitted when the transaction status of @cnc has changed (a transaction has been 
@@ -1106,7 +1106,7 @@ cnc_task_free (CncTask *task)
 }
 
 /**
- * _gda_connection_get_internal_thread_provider
+ * _gda_connection_get_internal_thread_provider:
  */ 
 GdaServerProvider *
 _gda_connection_get_internal_thread_provider (void)
@@ -5822,7 +5822,7 @@ gda_connection_get_events (GdaConnection *cnc)
 }
 
 /**
- * gda_connection_value_to_sql_string
+ * gda_connection_value_to_sql_string:
  * @cnc: a #GdaConnection object.
  * @from: #GValue to convert from
  *
diff --git a/libgda/gda-connection.h b/libgda/gda-connection.h
index e854c9c..67f48d1 100644
--- a/libgda/gda-connection.h
+++ b/libgda/gda-connection.h
@@ -200,7 +200,7 @@ typedef enum {
 
 
 /**
- * GdaConnectionFeature
+ * GdaConnectionFeature:
  * @GDA_CONNECTION_FEATURE_AGGREGATES: test for aggregates support
  * @GDA_CONNECTION_FEATURE_BLOBS: test for BLOBS (binary large objects) support
  * @GDA_CONNECTION_FEATURE_INDEXES: test for indexes support
diff --git a/libgda/gda-data-meta-wrapper.c b/libgda/gda-data-meta-wrapper.c
index 6ba2060..06a2496 100644
--- a/libgda/gda-data-meta-wrapper.c
+++ b/libgda/gda-data-meta-wrapper.c
@@ -110,7 +110,7 @@ static const GValue        *gda_data_meta_wrapper_get_value_at    (GdaDataModel
 static GObjectClass *parent_class = NULL;
 
 /**
- * gda_data_meta_wrapper_get_type
+ * gda_data_meta_wrapper_get_type:
  *
  * Returns: the #GType of GdaDataMetaWrapper.
  */
@@ -328,7 +328,7 @@ gda_data_meta_wrapper_get_property (GObject *object,
 }
 
 /**
- * gda_data_meta_wrapper_new
+ * gda_data_meta_wrapper_new:
  * @model: a #GdaDataModel
  *
  * Creates a new #GdaDataModel object which buffers the rows of @model. This object is useful
@@ -468,7 +468,7 @@ to_lower (gchar *str)
 }
 
 /**
- * _gda_data_meta_wrapper_compute_value
+ * _gda_data_meta_wrapper_compute_value:
  *
  * Returns:
  *  - NULL if no changes are necessary from the current value
diff --git a/libgda/gda-data-model-iter.c b/libgda/gda-data-model-iter.c
index c6195f8..af020ba 100644
--- a/libgda/gda-data-model-iter.c
+++ b/libgda/gda-data-model-iter.c
@@ -140,7 +140,7 @@ gda_data_model_iter_class_init (GdaDataModelIterClass *class)
 	parent_class = g_type_class_peek_parent (class);
 
 	/**
-	 * GdaDataModelIter::row-changed
+	 * GdaDataModelIter::row-changed:
 	 * @iter: the #GdaDataModelIter
 	 * @row: the new iter's row
 	 *
@@ -154,7 +154,7 @@ gda_data_model_iter_class_init (GdaDataModelIterClass *class)
                               NULL, NULL,
                               g_cclosure_marshal_VOID__INT, G_TYPE_NONE, 1, G_TYPE_INT);
 	/**
-	 * GdaDataModelIter::end-of-data
+	 * GdaDataModelIter::end-of-data:
 	 * @iter: the #GdaDataModelIter
 	 *
 	 * Gets emitted when @iter has reached the end of available data (which means the previous
diff --git a/libgda/gda-data-model.c b/libgda/gda-data-model.c
index 8c65cf1..cac2f6d 100644
--- a/libgda/gda-data-model.c
+++ b/libgda/gda-data-model.c
@@ -133,7 +133,7 @@ gda_data_model_class_init (G_GNUC_UNUSED gpointer g_class)
 	MUTEX_LOCK();
 	if (! initialized) {
 		/**
-		 * GdaDataModel::changed
+		 * GdaDataModel::changed:
 		 * @model: the #GdaDataModel
 		 *
 		 * Gets emitted when any value in @model has been changed
@@ -147,7 +147,7 @@ gda_data_model_class_init (G_GNUC_UNUSED gpointer g_class)
 				      g_cclosure_marshal_VOID__VOID,
 				      G_TYPE_NONE, 0);
 		/**
-		 * GdaDataModel::row-inserted
+		 * GdaDataModel::row-inserted:
 		 * @model: the #GdaDataModel
 		 * @row: the row number
 		 *
@@ -162,7 +162,7 @@ gda_data_model_class_init (G_GNUC_UNUSED gpointer g_class)
 				      g_cclosure_marshal_VOID__INT,
 				      G_TYPE_NONE, 1, G_TYPE_INT);
 		/**
-		 * GdaDataModel::row-updated
+		 * GdaDataModel::row-updated:
 		 * @model: the #GdaDataModel
 		 * @row: the row number
 		 *
@@ -177,7 +177,7 @@ gda_data_model_class_init (G_GNUC_UNUSED gpointer g_class)
 				      g_cclosure_marshal_VOID__INT,
 				      G_TYPE_NONE, 1, G_TYPE_INT);
 		/**
-		 * GdaDataModel::row-removed
+		 * GdaDataModel::row-removed:
 		 * @model: the #GdaDataModel
 		 * @row: the row number
 		 *
@@ -192,7 +192,7 @@ gda_data_model_class_init (G_GNUC_UNUSED gpointer g_class)
 				      g_cclosure_marshal_VOID__INT,
 				      G_TYPE_NONE, 1, G_TYPE_INT);
 		/**
-		 * GdaDataModel::reset
+		 * GdaDataModel::reset:
 		 * @model: the #GdaDataModel
 		 *
 		 * Gets emitted when @model's contents has been completely reset (the number and
@@ -208,7 +208,7 @@ gda_data_model_class_init (G_GNUC_UNUSED gpointer g_class)
 				      G_TYPE_NONE, 0);
 
 		/**
-		 * GdaDataModel::access-changed
+		 * GdaDataModel::access-changed:
 		 * @model: the #GdaDataModel
 		 *
 		 * Gets emitted when @model's access flags have changed. Use
diff --git a/libgda/gda-data-pivot.c b/libgda/gda-data-pivot.c
index 738bc19..48e4b3d 100644
--- a/libgda/gda-data-pivot.c
+++ b/libgda/gda-data-pivot.c
@@ -125,7 +125,7 @@ static GStaticMutex provider_mutex = G_STATIC_MUTEX_INIT;
 static GdaVirtualProvider *virtual_provider = NULL;
 
 /**
- * gda_data_pivot_get_type
+ * gda_data_pivot_get_type:
  *
  * Returns: the #GType of GdaDataPivot.
  */
diff --git a/libgda/gda-data-proxy.c b/libgda/gda-data-proxy.c
index 265c82b..b091a7c 100644
--- a/libgda/gda-data-proxy.c
+++ b/libgda/gda-data-proxy.c
@@ -573,7 +573,7 @@ gda_data_proxy_class_init (GdaDataProxyClass *klass)
 
 	/* signals */
 	/**
-	 * GdaDataProxy::row-delete-changed
+	 * GdaDataProxy::row-delete-changed:
 	 * @proxy: the #GdaDataProxy
 	 * @row: the concerned @proxy's row
 	 * @to_be_deleted: tells if the @row is marked to be deleted
@@ -588,7 +588,7 @@ gda_data_proxy_class_init (GdaDataProxyClass *klass)
                               NULL, NULL,
 			      _gda_marshal_VOID__INT_BOOLEAN, G_TYPE_NONE, 2, G_TYPE_INT, G_TYPE_BOOLEAN);
 	/**
-	 * GdaDataProxy::sample-size-changed
+	 * GdaDataProxy::sample-size-changed:
 	 * @proxy: the #GdaDataProxy
 	 * @sample_size: the new sample size
 	 *
@@ -602,7 +602,7 @@ gda_data_proxy_class_init (GdaDataProxyClass *klass)
                               NULL, NULL,
 			      g_cclosure_marshal_VOID__INT, G_TYPE_NONE, 1, G_TYPE_INT);
 	/**
-	 * GdaDataProxy::sample-changed
+	 * GdaDataProxy::sample-changed:
 	 * @proxy: the #GdaDataProxy
 	 * @sample_start: the first row of the sample
 	 * @sample_end: the last row of the sample
@@ -618,7 +618,7 @@ gda_data_proxy_class_init (GdaDataProxyClass *klass)
                               NULL, NULL,
 			      _gda_marshal_VOID__INT_INT, G_TYPE_NONE, 2, G_TYPE_INT, G_TYPE_INT);
 	/**
-	 * GdaDataProxy::validate-row-changes
+	 * GdaDataProxy::validate-row-changes:
 	 * @proxy: the #GdaDataProxy
 	 * @row: the proxy's row
 	 * @proxied_row: the proxied data model's row
@@ -636,7 +636,7 @@ gda_data_proxy_class_init (GdaDataProxyClass *klass)
                               validate_row_changes_accumulator, NULL,
                               _gda_marshal_ERROR__INT_INT, G_TYPE_ERROR, 2, G_TYPE_INT, G_TYPE_INT);
 	/**
-	 * GdaDataProxy::row-changes-applied
+	 * GdaDataProxy::row-changes-applied:
 	 * @proxy: the #GdaDataProxy
 	 * @row: the proxy's row
 	 * @proxied_row: the proxied data model's row
@@ -651,7 +651,7 @@ gda_data_proxy_class_init (GdaDataProxyClass *klass)
                               NULL, NULL,
 			      _gda_marshal_VOID__INT_INT, G_TYPE_NONE, 2, G_TYPE_INT, G_TYPE_INT);
 	/**
-	 * GdaDataProxy::filter-changed
+	 * GdaDataProxy::filter-changed:
 	 * @proxy: the #GdaDataProxy
 	 *
 	 * Gets emitted when @proxy's filter has been changed
diff --git a/libgda/gda-data-select.c b/libgda/gda-data-select.c
index 6996154..def7b5b 100644
--- a/libgda/gda-data-select.c
+++ b/libgda/gda-data-select.c
@@ -891,7 +891,7 @@ gda_data_select_get_connection (GdaDataSelect *model)
 }
 
 /**
- * gda_data_select_set_columns
+ * gda_data_select_set_columns:
  * @model: a #GdaDataSelect data model
  * @columns: (transfer full): a lis of #GdaColumn objects
  *
diff --git a/libgda/gda-enums.h b/libgda/gda-enums.h
index c60bab0..69e1a86 100644
--- a/libgda/gda-enums.h
+++ b/libgda/gda-enums.h
@@ -47,7 +47,7 @@ typedef enum  {
 
 /* how SQL identifiers are represented */
 /**
- * GdaSqlIdentifierStyle
+ * GdaSqlIdentifierStyle:
  * @GDA_SQL_IDENTIFIERS_LOWER_CASE: case insensitive SQL identifiers are represented in lower case (meaning that any SQL identifier which has a non lower case character is case sensitive)
  * @GDA_SQL_IDENTIFIERS_UPPER_CASE: case insensitive SQL identifiers are represented in upper case (meaning that any SQL identifier which has a non upper case character is case sensitive)
  *
diff --git a/libgda/gda-holder.c b/libgda/gda-holder.c
index 6a5e141..0857463 100644
--- a/libgda/gda-holder.c
+++ b/libgda/gda-holder.c
@@ -207,7 +207,7 @@ gda_holder_class_init (GdaHolderClass *class)
 	parent_class = g_type_class_peek_parent (class);
 
 	/**
-	 * GdaHolder::source-changed
+	 * GdaHolder::source-changed:
 	 * @holder: the #GdaHolder
 	 * 
 	 * Gets emitted when the data model in which @holder's values should be has changed
@@ -220,7 +220,7 @@ gda_holder_class_init (GdaHolderClass *class)
                               NULL, NULL,
                               _gda_marshal_VOID__VOID, G_TYPE_NONE, 0);
 	/**
-	 * GdaHolder::changed
+	 * GdaHolder::changed:
 	 * @holder: the #GdaHolder
 	 * 
 	 * Gets emitted when @holder's value has changed
@@ -233,7 +233,7 @@ gda_holder_class_init (GdaHolderClass *class)
                               NULL, NULL,
                               _gda_marshal_VOID__VOID, G_TYPE_NONE, 0);
 	/**
-	 * GdaHolder::attribute-changed
+	 * GdaHolder::attribute-changed:
 	 * @holder: the #GdaHolder
 	 * @att_name: attribute's name
 	 * @att_value: attribute's value
@@ -250,7 +250,7 @@ gda_holder_class_init (GdaHolderClass *class)
 			      G_TYPE_STRING, G_TYPE_VALUE);
 
 	/**
-	 * GdaHolder::validate-change
+	 * GdaHolder::validate-change:
 	 * @holder: the object which received the signal
 	 * @new_value: the proposed new value for @holder
 	 * 
diff --git a/libgda/gda-holder.h b/libgda/gda-holder.h
index 0d0620a..e002c24 100644
--- a/libgda/gda-holder.h
+++ b/libgda/gda-holder.h
@@ -92,7 +92,7 @@ GType               gda_holder_get_g_type              (GdaHolder *holder);
 const gchar        *gda_holder_get_id                  (GdaHolder *holder);
 
 /**
- * gda_holder_new_string
+ * gda_holder_new_string:
  * @id: a string
  * @str: a string
  * 
@@ -104,7 +104,7 @@ const gchar        *gda_holder_get_id                  (GdaHolder *holder);
 #define gda_holder_new_string(id,str) gda_holder_new_inline (G_TYPE_STRING, (id), (str))
 
 /**
- * gda_holder_new_boolean
+ * gda_holder_new_boolean:
  * @id: a string
  * @abool: a boolean value
  * 
@@ -116,7 +116,7 @@ const gchar        *gda_holder_get_id                  (GdaHolder *holder);
 #define gda_holder_new_boolean(id,abool) gda_holder_new_inline (G_TYPE_BOOLEAN, (id), (abool))
 
 /**
- * gda_holder_new_int
+ * gda_holder_new_int:
  * @id: a string
  * @anint: an int value
  * 
@@ -160,7 +160,7 @@ void                gda_holder_set_attribute            (GdaHolder *holder, cons
 							 GDestroyNotify destroy);
 
 /**
- * gda_holder_set_attribute_static
+ * gda_holder_set_attribute_static:
  * @holder: a #GdaHolder
  * @attribute: attribute's name
  * @value: (allow-none): a #GValue, or %NULL
diff --git a/libgda/gda-meta-struct.h b/libgda/gda-meta-struct.h
index 3bd0c72..1b5f2e6 100644
--- a/libgda/gda-meta-struct.h
+++ b/libgda/gda-meta-struct.h
@@ -291,7 +291,7 @@ const GValue *gda_meta_table_column_get_attribute (GdaMetaTableColumn *tcol, con
 void          gda_meta_table_column_set_attribute (GdaMetaTableColumn *tcol, const gchar *attribute, const GValue *value,
 						   GDestroyNotify destroy);
 /**
- * gda_meta_table_column_set_attribute_static
+ * gda_meta_table_column_set_attribute_static:
  * @column: a #GdaMetaTableColumn
  * @attribute: attribute's name
  * @value: (allow-none): a #GValue, or %NULL
@@ -371,7 +371,7 @@ typedef struct {
 	gpointer _gda_reserved4;
 } GdaMetaTableForeignKey;
 /**
- * GDA_META_TABLE_FOREIGN_KEY
+ * GDA_META_TABLE_FOREIGN_KEY:
  * @fk: a pointer
  *
  * Casts @fk to a #GdaMetaTableForeignKey (no check is actuelly being done on @fk's validity)
@@ -401,7 +401,7 @@ typedef struct {
 #define GDA_META_TABLE_FOREIGN_KEY_ON_DELETE_POLICY(fk) (((GdaMetaTableForeignKey*)(fk))->on_delete_policy)
 
 /**
- * GDA_META_TABLE_FOREIGN_KEY_IS_DECLARED
+ * GDA_META_TABLE_FOREIGN_KEY_IS_DECLARED:
  * @fk: a pointer to a #GdaMetaTableForeignKey
  *
  * Tells if @fk is an actual foreign key defined in the database's schema, or if it is an indication which
diff --git a/libgda/gda-quark-list.c b/libgda/gda-quark-list.c
index 6a5d4a8..33c2ebc 100644
--- a/libgda/gda-quark-list.c
+++ b/libgda/gda-quark-list.c
@@ -298,7 +298,7 @@ gda_quark_list_free (GdaQuarkList *qlist)
 
 
 /**
- * gda_quark_list_copy
+ * gda_quark_list_copy:
  * @qlist: quark_list to get a copy from.
  *
  * Creates a new #GdaQuarkList from an existing one.
@@ -341,7 +341,7 @@ name_is_protected (const gchar *name)
 }
 
 /**
- * gda_quark_list_add_from_string
+ * gda_quark_list_add_from_string:
  * @qlist: a #GdaQuarkList.
  * @string: a string.
  * @cleanup: whether to cleanup the previous content or not.
@@ -439,7 +439,7 @@ gda_quark_list_add_from_string (GdaQuarkList *qlist, const gchar *string, gboole
 }
 
 /**
- * gda_quark_list_find
+ * gda_quark_list_find:
  * @qlist: a #GdaQuarkList.
  * @name: the name of the value to search for.
  *
@@ -474,7 +474,7 @@ gda_quark_list_find (GdaQuarkList *qlist, const gchar *name)
 }
 
 /**
- * gda_quark_list_remove
+ * gda_quark_list_remove:
  * @qlist: a #GdaQuarkList structure.
  * @name: an entry name.
  *
diff --git a/libgda/gda-server-operation.c b/libgda/gda-server-operation.c
index e7257c8..f1f7823 100644
--- a/libgda/gda-server-operation.c
+++ b/libgda/gda-server-operation.c
@@ -146,7 +146,7 @@ gda_server_operation_class_init (GdaServerOperationClass *klass)
 
 	/* signals */
 	/**
-	 * GdaServerOperation::sequence-item-added
+	 * GdaServerOperation::sequence-item-added:
 	 * @op: the #GdaServerOperation
 	 * @seq_path: the path to the new sequence item
 	 * @item_index: the index (starting from 0) of the new sequence item in the sequence
@@ -162,7 +162,7 @@ gda_server_operation_class_init (GdaServerOperationClass *klass)
 			      _gda_marshal_VOID__STRING_INT, G_TYPE_NONE,
 			      2, G_TYPE_STRING, G_TYPE_INT);
 	/**
-	 * GdaServerOperation::sequence-item-remove
+	 * GdaServerOperation::sequence-item-remove:
 	 * @op: the #GdaServerOperation
 	 * @seq_path: the path to the sequence item to be removed
 	 * @item_index: the index (starting from 0) of the sequence item in the sequence
diff --git a/libgda/gda-set.c b/libgda/gda-set.c
index a56146e..dfdea88 100644
--- a/libgda/gda-set.c
+++ b/libgda/gda-set.c
@@ -275,7 +275,7 @@ gda_set_class_init (GdaSetClass *class)
 			      GDA_TYPE_HOLDER);
 
 	/**
-	 * GdaSet::validate-holder-change
+	 * GdaSet::validate-holder-change:
 	 * @set: the #GdaSet
 	 * @holder: the #GdaHolder which is going to change
 	 * @new_value: the proposed new value for @holder
@@ -295,7 +295,7 @@ gda_set_class_init (GdaSetClass *class)
 			      _gda_marshal_ERROR__OBJECT_VALUE, G_TYPE_ERROR, 2,
 			      GDA_TYPE_HOLDER, G_TYPE_VALUE);
 	/**
-	 * GdaSet::validate-set
+	 * GdaSet::validate-set:
 	 * @set: the #GdaSet
 	 * 
 	 * Gets emitted when gda_set_is_valid() is called, use
@@ -312,7 +312,7 @@ gda_set_class_init (GdaSetClass *class)
 			      validate_accumulator, NULL,
 			      _gda_marshal_ERROR__VOID, G_TYPE_ERROR, 0);
 	/**
-	 * GdaSet::holder-attr-changed
+	 * GdaSet::holder-attr-changed:
 	 * @set: the #GdaSet
 	 * @holder: the GdaHolder for which an attribute changed
 	 * @attr_name: attribute's name
@@ -329,7 +329,7 @@ gda_set_class_init (GdaSetClass *class)
 			      _gda_marshal_VOID__OBJECT_STRING_VALUE, G_TYPE_NONE, 3,
 			      GDA_TYPE_HOLDER, G_TYPE_STRING, G_TYPE_VALUE);
 	/**
-	 * GdaSet::public-data-changed
+	 * GdaSet::public-data-changed:
 	 * @set: the #GdaSet
 	 * 
 	 * Gets emitted when @set's public data (#GdaSetNode, #GdaSetGroup or #GdaSetSource values) have changed
@@ -343,7 +343,7 @@ gda_set_class_init (GdaSetClass *class)
 			      _gda_marshal_VOID__VOID, G_TYPE_NONE, 0);
 
 	/**
-	 * GdaSet::holder-type-set
+	 * GdaSet::holder-type-set:
 	 * @set: the #GdaSet
 	 * @holder: the #GdaHolder for which the #GType has been set
 	 *
@@ -362,7 +362,7 @@ gda_set_class_init (GdaSetClass *class)
 			      GDA_TYPE_HOLDER);
 
 	/**
-	 * GdaSet::source-model-changed
+	 * GdaSet::source-model-changed:
 	 * @set: the #GdaSet
 	 * @source: the #GdaSetSource for which the @data_model attribute has changed
 	 *
@@ -1662,7 +1662,7 @@ gda_set_get_source_for_model (GdaSet *set, GdaDataModel *model)
 }
 
 /**
- * gda_set_replace_source_model
+ * gda_set_replace_source_model:
  * @set: a #GdaSet object
  * @source: a pointer to a #GdaSetSource in @set
  * @model: a #GdaDataModel
diff --git a/libgda/gda-statement-extra.h b/libgda/gda-statement-extra.h
index eafd8f4..0439c82 100644
--- a/libgda/gda-statement-extra.h
+++ b/libgda/gda-statement-extra.h
@@ -27,16 +27,6 @@ G_BEGIN_DECLS
 /* private information to implement custom 
  * SQL renderers for GdaStatement objects
  */
-/**
- * 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.
- */
 typedef struct _GdaSqlRenderingContext GdaSqlRenderingContext;
 
 /**
@@ -125,6 +115,8 @@ typedef gchar *(*GdaSqlRenderingValue)     (const GValue *value, GdaSqlRendering
  * @render_select_from: function to render a #GdaSqlSelectFrom
  * @render_select_order: function to render a #GdaSqlSelectOrder
  * @render_distinct: function to render the DISTINCT clause in a SELECT
+ *
+ * Specifies the context in which a #GdaSqlStatement is being converted to SQL.
  */
 struct _GdaSqlRenderingContext {
 	GdaStatementSqlFlag      flags;
diff --git a/libgda/gda-statement.c b/libgda/gda-statement.c
index 430796c..46f2ab1 100644
--- a/libgda/gda-statement.c
+++ b/libgda/gda-statement.c
@@ -131,7 +131,7 @@ gda_statement_class_init (GdaStatementClass * klass)
 	parent_class = g_type_class_peek_parent (klass);
 
 	/**
-	 * GdaStatement::reset
+	 * GdaStatement::reset:
 	 * @stmt: the #GdaStatement object
 	 *
 	 * Gets emitted whenever the @stmt has changed
@@ -145,7 +145,7 @@ gda_statement_class_init (GdaStatementClass * klass)
 			      g_cclosure_marshal_VOID__VOID, G_TYPE_NONE,
 			      0);
 	/**
-	 * GdaStatement::checked
+	 * GdaStatement::checked:
 	 * @stmt: the #GdaStatement object
 	 *
 	 * Gets emitted whenever the structure and contents
diff --git a/libgda/gda-tree-manager.h b/libgda/gda-tree-manager.h
index 2ae2651..4c15f27 100644
--- a/libgda/gda-tree-manager.h
+++ b/libgda/gda-tree-manager.h
@@ -56,7 +56,7 @@ struct _GdaTreeManagerClass {
 
 	/* virtual methods */
 	/**
-	 * update_children
+	 * update_children:
 	 *
 	 * Returns: NULL if an error occurred, and @out_error is set to TRUE
 	 */
diff --git a/libgda/gda-tree-mgr-ldap.c b/libgda/gda-tree-mgr-ldap.c
index eb8a25a..63b7025 100644
--- a/libgda/gda-tree-mgr-ldap.c
+++ b/libgda/gda-tree-mgr-ldap.c
@@ -120,7 +120,7 @@ gda_tree_mgr_ldap_dispose (GObject *object)
 }
 
 /**
- * gda_tree_mgr_select_get_type:
+ * gda_tree_mgr_ldap_get_type:
  *
  * Returns: the GType
  *
diff --git a/libgda/gda-tree-mgr-tables.c b/libgda/gda-tree-mgr-tables.c
index bad197e..5f16aca 100644
--- a/libgda/gda-tree-mgr-tables.c
+++ b/libgda/gda-tree-mgr-tables.c
@@ -155,7 +155,7 @@ gda_tree_mgr_tables_dispose (GObject *object)
 }
 
 /**
- * gda_tree_mgr_select_get_type:
+ * gda_tree_mgr_tables_get_type:
  *
  * Returns: the GType
  *
diff --git a/libgda/gda-tree-node.c b/libgda/gda-tree-node.c
index 857aaee..1d61b00 100644
--- a/libgda/gda-tree-node.c
+++ b/libgda/gda-tree-node.c
@@ -98,7 +98,7 @@ gda_tree_node_class_init (GdaTreeNodeClass *klass)
 
 	/* signals */
 	/**
-	 * GdaTreeNode::node-changed
+	 * GdaTreeNode::node-changed:
 	 * @reporting: the #GdaTreeNode which emits the signal (may be a parent of @node, or @node itself)
 	 * @node: the #GdaTreeNode which has changed
 	 *
@@ -115,7 +115,7 @@ gda_tree_node_class_init (GdaTreeNodeClass *klass)
 			      g_cclosure_marshal_VOID__OBJECT,
 			      G_TYPE_NONE, 1, GDA_TYPE_TREE_NODE);
 	/**
-	 * GdaTreeNode::node-inserted
+	 * GdaTreeNode::node-inserted:
 	 * @reporting: the #GdaTreeNode which emits the signal (may be a parent of @node, or @node itself)
 	 * @node: the #GdaTreeNode which has been inserted
 	 *
@@ -132,7 +132,7 @@ gda_tree_node_class_init (GdaTreeNodeClass *klass)
 			      g_cclosure_marshal_VOID__OBJECT,
 			      G_TYPE_NONE, 1, GDA_TYPE_TREE_NODE);
 	/**
-	 * GdaTreeNode::node-has-child-toggled
+	 * GdaTreeNode::node-has-child-toggled:
 	 * @reporting: the #GdaTreeNode which emits the signal (may be a parent of @node, or @node itself)
 	 * @node: the #GdaTreeNode which changed from having children to being a
 	 *        leaf or the other way around
@@ -151,7 +151,7 @@ gda_tree_node_class_init (GdaTreeNodeClass *klass)
 			      g_cclosure_marshal_VOID__OBJECT,
 			      G_TYPE_NONE, 1, GDA_TYPE_TREE_NODE);
 	/**
-	 * GdaTreeNode::node-deleted
+	 * GdaTreeNode::node-deleted:
 	 * @reporting: the #GdaTreeNode which emits the signal (a parent of the removed node)
 	 * @relative_path: the path the node held, relative to @reporting
 	 *
diff --git a/libgda/gda-tree.c b/libgda/gda-tree.c
index afced42..c9ec43a 100644
--- a/libgda/gda-tree.c
+++ b/libgda/gda-tree.c
@@ -86,7 +86,7 @@ gda_tree_class_init (GdaTreeClass *klass)
 
 	/* signals */
 	/**
-	 * GdaTree::node-changed
+	 * GdaTree::node-changed:
 	 * @tree: the #GdaTree
 	 * @node: the #GdaTreeNode which has changed
 	 *
@@ -103,7 +103,7 @@ gda_tree_class_init (GdaTreeClass *klass)
 			      g_cclosure_marshal_VOID__OBJECT,
 			      G_TYPE_NONE, 1, GDA_TYPE_TREE_NODE);
 	/**
-	 * GdaTree::node-inserted
+	 * GdaTree::node-inserted:
 	 * @tree: the #GdaTree
 	 * @node: the #GdaTreeNode which has inserted
 	 *
@@ -120,7 +120,7 @@ gda_tree_class_init (GdaTreeClass *klass)
 			      g_cclosure_marshal_VOID__OBJECT,
 			      G_TYPE_NONE, 1, GDA_TYPE_TREE_NODE);
 	/**
-	 * GdaTree::node-has-child-toggled
+	 * GdaTree::node-has-child-toggled:
 	 * @tree: the #GdaTree
 	 * @node: the #GdaTreeNode which changed from having children to being a
 	 *        leaf or the other way around
@@ -139,7 +139,7 @@ gda_tree_class_init (GdaTreeClass *klass)
 			      g_cclosure_marshal_VOID__OBJECT,
 			      G_TYPE_NONE, 1, GDA_TYPE_TREE_NODE);
 	/**
-	 * GdaTree::node-deleted
+	 * GdaTree::node-deleted:
 	 * @tree: the #GdaTree
 	 * @node_path: the position the node held in @tree as a tree path
 	 *
@@ -749,7 +749,7 @@ static GSList *split_absolute_path (const gchar *path, gboolean *out_error);
 static GSList *split_indexed_path (const gchar *path, gboolean *out_error);
 
 /**
- * decompose_path_as_segments
+ * decompose_path_as_segments:
  * @path: a path using '/'
  * @use_names: 
  *
diff --git a/libgda/gda-util.c b/libgda/gda-util.c
index 5a538ad..712c37d 100644
--- a/libgda/gda-util.c
+++ b/libgda/gda-util.c
@@ -1517,7 +1517,7 @@ null_param_unknown_foreach_func (GdaSqlAnyPart *part, NullData *data, GError **e
 }
 
 /**
- * gda_rewrite_sql_statement_for_null_parameters: (skip):
+ * gda_rewrite_sql_statement_for_null_parameters: (skip)
  * @sqlst: (transfer full): a #GdaSqlStatement
  * @params: a #GdaSet to be used as parameters when executing @stmt
  * @out_modified: (allow-none): a place to store the boolean which tells if @stmt has been modified or not, or %NULL
diff --git a/libgda/gda-value.c b/libgda/gda-value.c
index 21409a9..d047933 100644
--- a/libgda/gda-value.c
+++ b/libgda/gda-value.c
@@ -61,7 +61,7 @@ extern gchar *gda_numeric_locale;
  * GdaNumeric:
  * @number: a string representing a number
  * @precision: precision to use when @number is converted (not implemented jet)
- * @width: (not implemented jet)
+ * @width: not implemented jet
  *
  * Holds numbers represented as strings.
  *
@@ -1381,7 +1381,7 @@ gda_timestamp_valid (const GdaTimestamp *timestamp)
 }
 
 /**
- * gda_value_new: (skip):
+ * gda_value_new: (skip)
  * @type: the new value type.
  *
  * Makes a new #GValue of type @type.
@@ -1402,7 +1402,7 @@ gda_value_new (GType type)
 }
 
 /**
- * gda_value_new_null: (skip):
+ * gda_value_new_null: (skip)
  *
  * Creates a new #GValue initiated to a #GdaNull structure with a #GDA_TYPE_NULL, to
  * represent a NULL in the database.
@@ -1416,7 +1416,7 @@ gda_value_new_null (void)
 }
 
 /**
- * gda_value_new_default: (skip):
+ * gda_value_new_default: (skip)
  * @default_val: (allow-none): the default value as a string, or %NULL
  *
  * Creates a new default value.
@@ -1435,7 +1435,7 @@ gda_value_new_default (const gchar *default_val)
 }
 
 /**
- * gda_value_new_binary: (skip):
+ * gda_value_new_binary: (skip)
  * @val: value to set for the new #GValue.
  * @size: the size of the memory pool pointer to by @val.
  *
@@ -1464,7 +1464,7 @@ gda_value_new_binary (const guchar *val, glong size)
 }
 
 /**
- * gda_value_new_blob: (skip):
+ * gda_value_new_blob: (skip)
  * @val: value to set for the new #GValue.
  * @size: the size of the memory pool pointer to by @val.
  *
@@ -1496,7 +1496,7 @@ gda_value_new_blob (const guchar *val, glong size)
 }
 
 /**
- * gda_value_new_blob_from_file: (skip):
+ * gda_value_new_blob_from_file: (skip)
  * @filename: name of the file to manipulate
  *
  * Makes a new #GValue of type #GDA_TYPE_BLOB interfacing with the contents of the file
@@ -1523,7 +1523,7 @@ gda_value_new_blob_from_file (const gchar *filename)
 }
 
 /**
- * gda_value_new_timestamp_from_timet: (skip):
+ * gda_value_new_timestamp_from_timet: (skip)
  * @val: value to set for the new #GValue.
  *
  * Makes a new #GValue of type #GDA_TYPE_TIMESTAMP with value @val
@@ -1571,7 +1571,7 @@ gda_value_new_timestamp_from_timet (time_t val)
 }
 
 /**
- * gda_value_new_from_string: (skip):
+ * gda_value_new_from_string: (skip)
  * @as_string: stringified representation of the value.
  * @type: the new value type.
  *
@@ -1603,7 +1603,7 @@ gda_value_new_from_string (const gchar *as_string, GType type)
 }
 
 /**
- * gda_value_new_from_xml: (skip):
+ * gda_value_new_from_xml: (skip)
  * @node: an XML node representing the value.
  *
  * Creates a GValue from an XML representation of it. That XML
@@ -1646,7 +1646,7 @@ gda_value_new_from_xml (const xmlNodePtr node)
 }
 
 /**
- * gda_value_free: (skip):
+ * gda_value_free: (skip)
  * @value: (transfer full) (allow-none): the resource to free (or %NULL)
  *
  * Deallocates all memory associated to a #GValue.
@@ -1661,7 +1661,7 @@ gda_value_free (GValue *value)
 }
 
 /**
- * gda_value_reset_with_type: (skip):
+ * gda_value_reset_with_type: (skip)
  * @value: the #GValue to be reseted
  * @type:  the #GType to set to
  *
@@ -1686,7 +1686,7 @@ gda_value_reset_with_type (GValue *value, GType type)
 
 
 /**
- * gda_value_is_null: (skip):
+ * gda_value_is_null: (skip)
  * @value: value to test.
  *
  * Tests if a given @value is of type #GDA_TYPE_NULL.
@@ -1701,7 +1701,7 @@ gda_value_is_null (const GValue *value)
 }
 
 /**
- * gda_value_is_number: (skip):
+ * gda_value_is_number: (skip)
  * @value: a #GValue.
  *
  * Gets whether the value stored in the given #GValue is of numeric type or not.
@@ -1724,7 +1724,7 @@ gda_value_is_number (const GValue *value)
 }
 
 /**
- * gda_value_copy: (skip):
+ * gda_value_copy: (skip)
  * @value: value to get a copy from.
  *
  * Creates a new #GValue from an existing one.
@@ -1751,7 +1751,7 @@ gda_value_copy (const GValue *value)
 }
 
 /**
- * gda_value_get_binary: (skip):
+ * gda_value_get_binary: (skip)
  * @value: a #GValue whose value we want to get.
  *
  * Returns: (transfer none): the value stored in @value.
@@ -1771,7 +1771,7 @@ gda_value_get_binary (const GValue *value)
 
 
 /**
- * gda_value_set_binary: (skip):
+ * gda_value_set_binary: (skip)
  * @value: a #GValue that will store @val.
  * @binary: a #GdaBinary structure with the data and its size to be stored in @value.
  *
@@ -1793,7 +1793,7 @@ gda_value_set_binary (GValue *value, const GdaBinary *binary)
 }
 
 /**
- * gda_value_take_binary: (skip):
+ * gda_value_take_binary: (skip)
  * @value: a #GValue that will store @val.
  * @binary: (transfer full): a #GdaBinary structure with the data and its size to be stored in @value.
  *
@@ -1812,7 +1812,7 @@ gda_value_take_binary (GValue *value, GdaBinary *binary)
 }
 
 /**
- * gda_value_set_blob: (skip):
+ * gda_value_set_blob: (skip)
  * @value: a #GValue that will store @val.
  * @blob: a #GdaBlob structure with the data and its size to be stored in @value.
  *
@@ -1830,7 +1830,7 @@ gda_value_set_blob (GValue *value, const GdaBlob *blob)
 }
 
 /**
- * gda_value_get_blob: (skip):
+ * gda_value_get_blob: (skip)
  * @value: a #GValue whose value we want to get.
  *
  * Returns: (transfer none): the value stored in @value.
@@ -1849,7 +1849,7 @@ gda_value_get_blob (const GValue *value)
 }
 
 /**
- * gda_value_take_blob: (skip):
+ * gda_value_take_blob: (skip)
  * @value: a #GValue that will store @val.
  * @blob: (transfer full): a #GdaBlob structure with the data and its size to be stored in @value.
  *
@@ -1868,7 +1868,7 @@ gda_value_take_blob (GValue *value, GdaBlob *blob)
 }
 
 /**
- * gda_value_get_geometric_point: (skip):
+ * gda_value_get_geometric_point: (skip)
  * @value: a #GValue whose value we want to get.
  *
  * Returns: (transfer none): the value stored in @value.
@@ -1882,7 +1882,7 @@ gda_value_get_geometric_point (const GValue *value)
 }
 
 /**
- * gda_value_set_geometric_point: (skip):
+ * gda_value_set_geometric_point: (skip)
  * @value: a #GValue that will store @val.
  * @val: value to be stored in @value.
  *
@@ -1900,7 +1900,7 @@ gda_value_set_geometric_point (GValue *value, const GdaGeometricPoint *val)
 }
 
 /**
- * gda_value_set_null: (skip):
+ * gda_value_set_null: (skip)
  * @value: a #GValue that will store a value of type #GDA_TYPE_NULL.
  *
  * Sets the type of @value to #GDA_TYPE_NULL.
@@ -1913,7 +1913,7 @@ gda_value_set_null (GValue *value)
 }
 
 /**
- * gda_value_get_numeric: (skip):
+ * gda_value_get_numeric: (skip)
  * @value: a #GValue whose value we want to get.
  *
  * Returns: (transfer none): the value stored in @value.
@@ -1927,7 +1927,7 @@ gda_value_get_numeric (const GValue *value)
 }
 
 /**
- * gda_value_set_numeric: (skip):
+ * gda_value_set_numeric: (skip)
  * @value: a #GValue that will store @val.
  * @val: value to be stored in @value.
  *
@@ -1945,7 +1945,7 @@ gda_value_set_numeric (GValue *value, const GdaNumeric *val)
 }
 
 /**
- * gda_value_get_short: (skip):
+ * gda_value_get_short: (skip)
  * @value: a #GValue whose value we want to get.
  *
  * Returns: the value stored in @value.
@@ -1959,7 +1959,7 @@ gda_value_get_short (const GValue *value)
 }
 
 /**
- * gda_value_set_short: (skip):
+ * gda_value_set_short: (skip)
  * @value: a #GValue that will store @val.
  * @val: value to be stored in @value.
  *
@@ -1976,7 +1976,7 @@ gda_value_set_short (GValue *value, gshort val)
 }
 
 /**
- * gda_value_get_ushort: (skip):
+ * gda_value_get_ushort: (skip)
  * @value: a #GValue whose value we want to get.
  *
  * Returns: the value stored in @value.
@@ -1990,7 +1990,7 @@ gda_value_get_ushort (const GValue *value)
 }
 
 /**
- * gda_value_set_ushort: (skip):
+ * gda_value_set_ushort: (skip)
  * @value: a #GValue that will store @val.
  * @val: value to be stored in @value.
  *
@@ -2008,7 +2008,7 @@ gda_value_set_ushort (GValue *value, gushort val)
 
 
 /**
- * gda_value_get_time: (skip):
+ * gda_value_get_time: (skip)
  * @value: a #GValue whose value we want to get.
  *
  * Returns: (transfer none): the value stored in @value.
@@ -2022,7 +2022,7 @@ gda_value_get_time (const GValue *value)
 }
 
 /**
- * gda_value_set_time: (skip):
+ * gda_value_set_time: (skip)
  * @value: a #GValue that will store @val.
  * @val: value to be stored in @value.
  *
@@ -2040,7 +2040,7 @@ gda_value_set_time (GValue *value, const GdaTime *val)
 }
 
 /**
- * gda_value_get_timestamp: (skip):
+ * gda_value_get_timestamp: (skip)
  * @value: a #GValue whose value we want to get.
  *
  * Returns: (transfer none): the value stored in @value.
@@ -2054,7 +2054,7 @@ gda_value_get_timestamp (const GValue *value)
 }
 
 /**
- * gda_value_set_timestamp: (skip):
+ * gda_value_set_timestamp: (skip)
  * @value: a #GValue that will store @val.
  * @val: value to be stored in @value.
  *
@@ -2072,7 +2072,7 @@ gda_value_set_timestamp (GValue *value, const GdaTimestamp *val)
 }
 
 /**
- * gda_value_set_from_string: (skip):
+ * gda_value_set_from_string: (skip)
  * @value: a #GValue that will store @val.
  * @as_string: the stringified representation of the value.
  * @type: the type of the value
@@ -2110,7 +2110,7 @@ gda_value_set_from_string (GValue *value,
 }
 
 /**
- * gda_value_set_from_value: (skip):
+ * gda_value_set_from_value: (skip)
  * @value: a #GValue.
  * @from: the value to copy from.
  *
diff --git a/libgda/gda-value.h b/libgda/gda-value.h
index 717732f..bf29b72 100644
--- a/libgda/gda-value.h
+++ b/libgda/gda-value.h
@@ -83,7 +83,7 @@ typedef struct _GdaNumeric GdaNumeric;
  * GdaNumeric:
  * @number: a string representing a number
  * @precision: precision to use when @number is converted (not implemented jet)
- * @width: (not implemented jet)
+ * @width: not implemented jet
  *
  * Holds numbers represented as strings.
  *
@@ -152,7 +152,7 @@ typedef struct {
 } GdaBinary;
 
 /**
- * GdaBlob
+ * GdaBlob:
  * @data: data buffer, as a #GdaBinary
  * @op: (allow-none): a pointer to a #GdaBlopOp, or %NULL
  *
diff --git a/libgda/providers-support/gda-pstmt.c b/libgda/providers-support/gda-pstmt.c
index b6b7eac..13bdda5 100644
--- a/libgda/providers-support/gda-pstmt.c
+++ b/libgda/providers-support/gda-pstmt.c
@@ -36,7 +36,7 @@ struct _GdaPStmtPrivate {
 };
 
 /**
- * gda_pstmt_get_type
+ * gda_pstmt_get_type:
  *
  * Returns: the #GType of GdaPStmt.
  */
@@ -144,7 +144,7 @@ gda_pstmt_finalize (GObject *object)
 }
 
 /**
- * gda_pstmt_set_gda_statement
+ * gda_pstmt_set_gda_statement:
  * @pstmt: a #GdaPStmt object
  * @stmt: a #GdaStatement object
  *
@@ -169,7 +169,7 @@ gda_pstmt_set_gda_statement (GdaPStmt *pstmt, GdaStatement *stmt)
 }
 
 /**
- * gda_pstmt_copy_contents
+ * gda_pstmt_copy_contents:
  * @src: a #GdaPStmt object
  * @dest: a #GdaPStmt object
  *
diff --git a/libgda/thread-wrapper/gda-thread-wrapper.c b/libgda/thread-wrapper/gda-thread-wrapper.c
index 2d196a5..5f0f30c 100644
--- a/libgda/thread-wrapper/gda-thread-wrapper.c
+++ b/libgda/thread-wrapper/gda-thread-wrapper.c
@@ -755,7 +755,7 @@ GQuark gda_thread_wrapper_error_quark (void)
 }
 
 /**
- * gda_thread_wrapper_get_type
+ * gda_thread_wrapper_get_type:
  * 
  * Registers the #GdaThreadWrapper class on the GLib type system.
  * 
@@ -826,7 +826,7 @@ gda_thread_wrapper_get_property (GObject *object,
 }
 
 /**
- * gda_thread_wrapper_new
+ * gda_thread_wrapper_new:
  *
  * Creates a new #GdaThreadWrapper object
  *
@@ -1123,7 +1123,7 @@ gda_thread_wrapper_execute_void (GdaThreadWrapper *wrapper, GdaThreadWrapperVoid
 }
 
 /**
- * gda_thread_wrapper_cancel
+ * gda_thread_wrapper_cancel:
  * @wrapper: a #GdaThreadWrapper object
  * @id: the ID of a job as returned by gda_thread_wrapper_execute() or gda_thread_wrapper_execute_void()
  * 
@@ -1194,7 +1194,7 @@ gda_thread_wrapper_cancel (GdaThreadWrapper *wrapper, guint id)
 }
 
 /**
- * gda_thread_wrapper_iterate
+ * gda_thread_wrapper_iterate:
  * @wrapper: a #GdaThreadWrapper object
  * @may_block: whether the call may block
  *
@@ -1388,7 +1388,7 @@ gda_thread_wrapper_fetch_result (GdaThreadWrapper *wrapper, gboolean may_lock, g
 }
 
 /**
- * gda_thread_wrapper_get_waiting_size
+ * gda_thread_wrapper_get_waiting_size:
  * @wrapper: a #GdaThreadWrapper object
  *
  * Use this method to query the number of functions which have been queued to be executed
@@ -1672,7 +1672,7 @@ find_signal_r_func (G_GNUC_UNUSED GThread *thread, ThreadData *td, gulong *id)
 }
 
 /**
- * gda_thread_wrapper_disconnect
+ * gda_thread_wrapper_disconnect:
  * @wrapper: a #GdaThreadWrapper object
  * @id: a handler ID, as returned by gda_thread_wrapper_connect_raw()
  *
@@ -1762,7 +1762,7 @@ gda_thread_wrapper_disconnect (GdaThreadWrapper *wrapper, gulong id)
 }
 
 /**
- * gda_thread_wrapper_steal_signal
+ * gda_thread_wrapper_steal_signal:
  * @wrapper: a #GdaThreadWrapper object
  * @id: a signal ID
  *
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]