[libgda/tintou/wip/better-c-doc] Provide an organised documentation

[Corentin Noël <corentinnoel src gnome org>]

commit 59519207d9a25de0ea186afb7d3acb77c19aef44
Author: Corentin Noël <corentin noel collabora com>
Date:   Tue Sep 25 10:50:45 2018 +0200

    Provide an organised documentation

 doc/C/.gitignore                                   |   1 -
 doc/C/libgda/libgda-6.0-docs.xml                   | 327 +++++++++++----------
 ...libgda-sections.txt => libgda-6.0-sections.txt} | 233 ++++++++++++---
 libgda/gda-blob-op.h                               |   2 +-
 libgda/gda-quark-list.h                            |   2 +-
 libgda/gda-value.h                                 |   4 +-
 tools/common/web-server.c                          |   3 +-
 7 files changed, 357 insertions(+), 215 deletions(-)
---
diff --git a/doc/C/.gitignore b/doc/C/.gitignore
index e73634c5b..612ccec48 100644
--- a/doc/C/.gitignore
+++ b/doc/C/.gitignore
@@ -29,5 +29,4 @@ libgda-6.0-unused.sgml
 version.xml
 builddate.xml
 *.bak
-libgda-6.0-sections.txt
 setup-build.stamp
diff --git a/doc/C/libgda/libgda-6.0-docs.xml b/doc/C/libgda/libgda-6.0-docs.xml
index 72cec1e11..571413c7d 100644
--- a/doc/C/libgda/libgda-6.0-docs.xml
+++ b/doc/C/libgda/libgda-6.0-docs.xml
@@ -18,128 +18,137 @@
     </releaseinfo>
   </bookinfo>
 
-  <chapter>
+
+  <part id="api">
     <title>API Reference</title>
-        <xi:include href="xml/background.xml"/>
-    <xi:include href="xml/binreloc.xml"/>
-    <xi:include href="xml/dir-blob-op.xml"/>
-    <xi:include href="xml/gda-attributes-manager.xml"/>
-    <xi:include href="xml/gda-batch.xml"/>
-    <xi:include href="xml/gda-binreloc.xml"/>
-    <xi:include href="xml/gda-blob-op.xml"/>
-    <xi:include href="xml/gda-blob-op-impl.xml"/>
-    <xi:include href="xml/gda-column.xml"/>
-    <xi:include href="xml/gda-config.xml"/>
-    <xi:include href="xml/gda-connect.xml"/>
-    <xi:include href="xml/gda-connection.xml"/>
-    <xi:include href="xml/gda-connection-event.xml"/>
-    <xi:include href="xml/gda-connection-internal.xml"/>
-    <xi:include href="xml/gda-connection-private.xml"/>
-    <xi:include href="xml/gda-data-access-wrapper.xml"/>
-    <xi:include href="xml/gda-data-comparator.xml"/>
-    <xi:include href="xml/gda-data-handler.xml"/>
-    <xi:include href="xml/gda-data-meta-wrapper.xml"/>
-    <xi:include href="xml/gda-data-model.xml"/>
-    <xi:include href="xml/gda-data-model-array.xml"/>
-    <xi:include href="xml/gda-data-model-dir.xml"/>
-    <xi:include href="xml/gda-data-model-dsn-list.xml"/>
-    <xi:include href="xml/gda-data-model-extra.xml"/>
-    <xi:include href="xml/gda-data-model-import.xml"/>
-    <xi:include href="xml/gda-data-model-iter.xml"/>
-    <xi:include href="xml/gda-data-model-iter-extra.xml"/>
-    <xi:include href="xml/gda-data-model-ldap.xml"/>
-    <xi:include href="xml/gda-data-model-private.xml"/>
-    <xi:include href="xml/gda-data-pivot.xml"/>
-    <xi:include href="xml/gda-data-proxy.xml"/>
-    <xi:include href="xml/gda-data-select.xml"/>
-    <xi:include href="xml/gda-data-select-extra.xml"/>
-    <xi:include href="xml/gda-data-select-priv.xml"/>
-    <xi:include href="xml/gda-ddl-base.xml"/>
-    <xi:include href="xml/gda-ddl-buildable.xml"/>
-    <xi:include href="xml/gda-ddl-column.xml"/>
-    <xi:include href="xml/gda-ddl-creator.xml"/>
-    <xi:include href="xml/gda-ddl-fkey.xml"/>
-    <xi:include href="xml/gda-ddl-table.xml"/>
-    <xi:include href="xml/gda-ddl-view.xml"/>
-    <xi:include href="xml/gda-debug-macros.xml"/>
-    <xi:include href="xml/gda-decl.xml"/>
-    <xi:include href="xml/gda-enums.xml"/>
-    <xi:include href="xml/gda-handler-bin.xml"/>
-    <xi:include href="xml/gda-handler-boolean.xml"/>
-    <xi:include href="xml/gda-handler-numerical.xml"/>
-    <xi:include href="xml/gda-handler-string.xml"/>
-    <xi:include href="xml/gda-handler-time.xml"/>
-    <xi:include href="xml/gda-handler-type.xml"/>
-    <xi:include href="xml/gda-holder.xml"/>
-    <xi:include href="xml/gda-ldap-connection.xml"/>
-    <xi:include href="xml/gda-lockable.xml"/>
-    <xi:include href="xml/gda-log.xml"/>
-    <xi:include href="xml/gda-meta-column-types.xml"/>
-    <xi:include href="xml/gda-meta-store.xml"/>
-    <xi:include href="xml/gda-meta-struct.xml"/>
-    <xi:include href="xml/gda-pstmt.xml"/>
-    <xi:include href="xml/gda-quark-list.xml"/>
-    <xi:include href="xml/gda-repetitive-statement.xml"/>
-    <xi:include href="xml/gda-row.xml"/>
-    <xi:include href="xml/gda-server-operation.xml"/>
-    <xi:include href="xml/gda-server-provider.xml"/>
-    <xi:include href="xml/gda-server-provider-extra.xml"/>
-    <xi:include href="xml/gda-server-provider-impl.xml"/>
-    <xi:include href="xml/gda-server-provider-private.xml"/>
-    <xi:include href="xml/gda-set.xml"/>
-    <xi:include href="xml/gda-sql-builder.xml"/>
-    <xi:include href="xml/gda-sql-parser.xml"/>
-    <xi:include href="xml/gda-sql-parser-private.xml"/>
-    <xi:include href="xml/gda-sqlite.xml"/>
-    <xi:include href="xml/gda-sqlite-blob-op.xml"/>
-    <xi:include href="xml/gda-sqlite-handler-bin.xml"/>
-    <xi:include href="xml/gda-sqlite-handler-boolean.xml"/>
-    <xi:include href="xml/gda-sqlite-provider.xml"/>
-    <xi:include href="xml/gda-sqlite-pstmt.xml"/>
-    <xi:include href="xml/gda-sqlite-recordset.xml"/>
-    <xi:include href="xml/gda-statement.xml"/>
-    <xi:include href="xml/gda-statement-extra.xml"/>
-    <xi:include href="xml/gda-statement-struct.xml"/>
-    <xi:include href="xml/gda-statement-struct-compound.xml"/>
-    <xi:include href="xml/gda-statement-struct-decl.xml"/>
-    <xi:include href="xml/gda-statement-struct-delete.xml"/>
-    <xi:include href="xml/gda-statement-struct-insert.xml"/>
-    <xi:include href="xml/gda-statement-struct-parts.xml"/>
-    <xi:include href="xml/gda-statement-struct-pspec.xml"/>
-    <xi:include href="xml/gda-statement-struct-select.xml"/>
-    <xi:include href="xml/gda-statement-struct-trans.xml"/>
-    <xi:include href="xml/gda-statement-struct-unknown.xml"/>
-    <xi:include href="xml/gda-statement-struct-update.xml"/>
-    <xi:include href="xml/gda-statement-struct-util.xml"/>
-    <xi:include href="xml/gda-transaction-status.xml"/>
-    <xi:include href="xml/gda-transaction-status-private.xml"/>
-    <xi:include href="xml/gda-tree.xml"/>
-    <xi:include href="xml/gda-tree-manager.xml"/>
-    <xi:include href="xml/gda-tree-mgr-columns.xml"/>
-    <xi:include href="xml/gda-tree-mgr-label.xml"/>
-    <xi:include href="xml/gda-tree-mgr-ldap.xml"/>
-    <xi:include href="xml/gda-tree-mgr-schemas.xml"/>
-    <xi:include href="xml/gda-tree-mgr-select.xml"/>
-    <xi:include href="xml/gda-tree-mgr-tables.xml"/>
-    <xi:include href="xml/gda-tree-node.xml"/>
-    <xi:include href="xml/gda-util.xml"/>
-    <xi:include href="xml/gda-value.xml"/>
-    <xi:include href="xml/gda-vconnection-data-model.xml"/>
-    <xi:include href="xml/gda-vconnection-data-model-private.xml"/>
-    <xi:include href="xml/gda-vconnection-hub.xml"/>
-    <xi:include href="xml/gda-virtual-connection.xml"/>
-    <xi:include href="xml/gda-virtual-provider.xml"/>
-    <xi:include href="xml/gda-vprovider-data-model.xml"/>
-    <xi:include href="xml/gda-vprovider-hub.xml"/>
-    <xi:include href="xml/gda-worker.xml"/>
-    <xi:include href="xml/gda-xa-transaction.xml"/>
-    <xi:include href="xml/libgda-global-variables.xml"/>
-    <xi:include href="xml/keywords_hash.xml"/>
-    <xi:include href="xml/gda-symbols-util.xml"/>
-    <xi:include href="xml/itsignaler.xml"/>
-    <xi:include href="xml/parser_tokens.xml"/>
 
-  </chapter>
+    <chapter id="Getting Started">
+      <title>Getting Started</title>
+      <xi:include href="xml/libgda.xml"/>
+    </chapter>
+
+    <chapter id="Connection">
+      <title>Connection</title>
+      <xi:include href="xml/gda-connection.xml"/>
+      <xi:include href="xml/gda-connection-event.xml"/>
+      <xi:include href="xml/gda-ldap-connection.xml"/>
+      <xi:include href="xml/gda-xa-transaction.xml"/>
+      <xi:include href="xml/gda-transaction-status.xml"/>
+      <xi:include href="xml/gda-virtual-connection.xml"/>
+      <xi:include href="xml/gda-vconnection-data-model.xml"/>
+      <xi:include href="xml/gda-vconnection-hub.xml"/>
+    </chapter>
+
+    <chapter id="Provider">
+      <title>Provider</title>
+      <xi:include href="xml/gda-provider.xml"/>
+      <xi:include href="xml/gda-server-provider.xml"/>
+      <xi:include href="xml/gda-virtual-provider.xml"/>
+      <xi:include href="xml/gda-vprovider-data-model.xml"/>
+      <xi:include href="xml/gda-vprovider-hub.xml"/>
+      <xi:include href="xml/provider-support.xml"/>
+      <xi:include href="xml/provider-support-sql.xml"/>
+    </chapter>
+
+    <chapter id="Data Model">
+      <title>Data Model</title>
+      <xi:include href="xml/gda-data-model.xml"/>
+      <xi:include href="xml/gda-data-model-array.xml"/>
+      <xi:include href="xml/gda-data-model-bdb.xml"/>
+      <xi:include href="xml/gda-data-model-dir.xml"/>
+      <xi:include href="xml/gda-data-model-import.xml"/>
+      <xi:include href="xml/gda-data-model-iter.xml"/>
+      <xi:include href="xml/gda-data-model-ldap.xml"/>
+      <xi:include href="xml/gda-data-access-wrapper.xml"/>
+      <xi:include href="xml/gda-column.xml"/>
+      <xi:include href="xml/gda-row.xml"/>
+      <xi:include href="xml/gda-data-pivot.xml"/>
+      <xi:include href="xml/gda-data-proxy.xml"/>
+      <xi:include href="xml/gda-meta-store.xml"/>
+      <xi:include href="xml/gda-meta-struct.xml"/>
+      <xi:include href="xml/gda-data-select.xml"/>
+    </chapter>
+
+    <chapter id="Data Handlers">
+      <title>Data Handlers</title>
+      <xi:include href="xml/gda-blob-op.xml"/>
+      <xi:include href="xml/gda-value.xml"/>
+      <xi:include href="xml/gda-holder.xml"/>
+      <xi:include href="xml/gda-set.xml"/>
+      <xi:include href="xml/gda-data-handler.xml"/>
+      <xi:include href="xml/gda-data-comparator.xml"/>
+      <xi:include href="xml/gda-handler-bin.xml"/>
+      <xi:include href="xml/gda-handler-boolean.xml"/>
+      <xi:include href="xml/gda-handler-numerical.xml"/>
+      <xi:include href="xml/gda-handler-string.xml"/>
+      <xi:include href="xml/gda-handler-time.xml"/>
+      <xi:include href="xml/gda-handler-type.xml"/>
+      <xi:include href="xml/gda-quark-list.xml"/>
+      <xi:include href="xml/gda-attributes-manager.xml"/>
+    </chapter>
+
+    <chapter id="DDL">
+      <title>DDL</title>
+      <xi:include href="xml/gda-ddl-base.xml"/>
+      <xi:include href="xml/gda-ddl-buildable.xml"/>
+      <xi:include href="xml/gda-ddl-column.xml"/>
+      <xi:include href="xml/gda-ddl-creator.xml"/>
+      <xi:include href="xml/gda-ddl-fkey.xml"/>
+      <xi:include href="xml/gda-ddl-table.xml"/>
+      <xi:include href="xml/gda-ddl-view.xml"/>
+    </chapter>
+
+    <chapter id="Statement">
+      <title>Statement</title>
+      <xi:include href="xml/gda-pstmt.xml"/>
+      <xi:include href="xml/gda-sql-parser.xml"/>
+      <xi:include href="xml/gda-sql-builder.xml"/>
+      <xi:include href="xml/gda-statement.xml"/>
+      <xi:include href="xml/gda-repetitive-statement.xml"/>
+      <xi:include href="xml/gda-batch.xml"/>
+    </chapter>
+
+    <chapter id="Tree Manager">
+      <title>Tree Manager</title>
+      <xi:include href="xml/gda-tree.xml"/>
+      <xi:include href="xml/gda-tree-node.xml"/>
+      <xi:include href="xml/gda-tree-manager.xml"/>
+      <xi:include href="xml/gda-tree-mgr-columns.xml"/>
+      <xi:include href="xml/gda-tree-mgr-label.xml"/>
+      <xi:include href="xml/gda-tree-mgr-ldap.xml"/>
+      <xi:include href="xml/gda-tree-mgr-schemas.xml"/>
+      <xi:include href="xml/gda-tree-mgr-select.xml"/>
+      <xi:include href="xml/gda-tree-mgr-tables.xml"/>
+    </chapter>
+
+    <chapter id="Server Operation">
+      <title>Server Operation</title>
+      <xi:include href="xml/gda-server-operation.xml"/>
+      <xi:include href="xml/gda-server-operation-nodes.xml"/>
+      <xi:include href="xml/gda-server-operation-sequences.xml"/>
+    </chapter>
+
+    <chapter id="Report">
+      <title>Report</title>
+      <xi:include href="xml/gda-report-engine.xml"/>
+      <xi:include href="xml/gda-report-document.xml"/>
+      <xi:include href="xml/gda-report-rml-document.xml"/>
+      <xi:include href="xml/gda-report-docbook-document.xml"/>
+    </chapter>
+
+    <chapter id="Utilities">
+      <title>Utilities</title>
+      <xi:include href="xml/gda-lockable.xml"/>
+      <xi:include href="xml/gda-log.xml"/>
+      <xi:include href="xml/gda-util.xml"/>
+
+      <xi:include href="xml/gda-config.xml"/>
+      <xi:include href="xml/gda-connect.xml"/>
+      
+      <xi:include href="xml/gda-worker.xml"/>
+    </chapter>
+  </part>
+
   <chapter id="object-tree">
     <title>Object Hierarchy</title>
     <xi:include href="xml/tree_index.sgml"/>
@@ -152,62 +161,30 @@
     <title>Index of deprecated API</title>
     <xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
   </index>
-  <index id="api-index-5-0" role="5.0">
-    <title>Index of new API in 5.0</title>
-    <xi:include href="xml/api-index-5.0.xml"><xi:fallback /></xi:include>
-  </index>
-  <index id="api-index-4-2-1" role="4.2.1">
-    <title>Index of new API in 4.2.1</title>
-    <xi:include href="xml/api-index-4.2.1.xml"><xi:fallback /></xi:include>
+  <index id="api-index-6-0" role="6.0">
+    <title>Index of new API in 6.0</title>
+    <xi:include href="xml/api-index-6.0.xml"><xi:fallback /></xi:include>
   </index>
   <index id="api-index-5-2" role="5.2">
     <title>Index of new API in 5.2</title>
     <xi:include href="xml/api-index-5.2.xml"><xi:fallback /></xi:include>
   </index>
-  <index id="api-index-6-0-0" role="6.0.0">
-    <title>Index of new API in 6.0.0</title>
-    <xi:include href="xml/api-index-6.0.0.xml"><xi:fallback /></xi:include>
-  </index>
-  <index id="api-index-4-2" role="4.2">
-    <title>Index of new API in 4.2</title>
-    <xi:include href="xml/api-index-4.2.xml"><xi:fallback /></xi:include>
-  </index>
-  <index id="api-index-4-2-4" role="4.2.4">
-    <title>Index of new API in 4.2.4</title>
-    <xi:include href="xml/api-index-4.2.4.xml"><xi:fallback /></xi:include>
+  <index id="api-index-5-2-0" role="5.2.0">
+    <title>Index of new API in 5.2.0</title>
+    <xi:include href="xml/api-index-5.2.0.xml"><xi:fallback /></xi:include>
   </index>
   <index id="api-index-5-0-2" role="5.0.2">
     <title>Index of new API in 5.0.2</title>
     <xi:include href="xml/api-index-5.0.2.xml"><xi:fallback /></xi:include>
   </index>
-  <index id="api-index-4-0-3" role="4.0.3">
-    <title>Index of new API in 4.0.3</title>
-    <xi:include href="xml/api-index-4.0.3.xml"><xi:fallback /></xi:include>
-  </index>
-  <index id="api-index-4-2-3" role="4.2.3">
-    <title>Index of new API in 4.2.3</title>
-    <xi:include href="xml/api-index-4.2.3.xml"><xi:fallback /></xi:include>
-  </index>
-  <index id="api-index-5-2-0" role="5.2.0">
-    <title>Index of new API in 5.2.0</title>
-    <xi:include href="xml/api-index-5.2.0.xml"><xi:fallback /></xi:include>
+  <index id="api-index-5-0" role="5.0">
+    <title>Index of new API in 5.0</title>
+    <xi:include href="xml/api-index-5.0.xml"><xi:fallback /></xi:include>
   </index>
   <index id="api-index-4-2-10" role="4.2.10">
     <title>Index of new API in 4.2.10</title>
     <xi:include href="xml/api-index-4.2.10.xml"><xi:fallback /></xi:include>
   </index>
-  <index id="api-index-3-2" role="3.2">
-    <title>Index of new API in 3.2</title>
-    <xi:include href="xml/api-index-3.2.xml"><xi:fallback /></xi:include>
-  </index>
-  <index id="api-index-4-2-6" role="4.2.6">
-    <title>Index of new API in 4.2.6</title>
-    <xi:include href="xml/api-index-4.2.6.xml"><xi:fallback /></xi:include>
-  </index>
-  <index id="api-index-6-0" role="6.0">
-    <title>Index of new API in 6.0</title>
-    <xi:include href="xml/api-index-6.0.xml"><xi:fallback /></xi:include>
-  </index>
   <index id="api-index-4-2-9" role="4.2.9">
     <title>Index of new API in 4.2.9</title>
     <xi:include href="xml/api-index-4.2.9.xml"><xi:fallback /></xi:include>
@@ -216,5 +193,33 @@
     <title>Index of new API in 4.2.8</title>
     <xi:include href="xml/api-index-4.2.8.xml"><xi:fallback /></xi:include>
   </index>
+  <index id="api-index-4-2-6" role="4.2.6">
+    <title>Index of new API in 4.2.6</title>
+    <xi:include href="xml/api-index-4.2.6.xml"><xi:fallback /></xi:include>
+  </index>
+  <index id="api-index-4-2-4" role="4.2.4">
+    <title>Index of new API in 4.2.4</title>
+    <xi:include href="xml/api-index-4.2.4.xml"><xi:fallback /></xi:include>
+  </index>
+  <index id="api-index-4-2-3" role="4.2.3">
+    <title>Index of new API in 4.2.3</title>
+    <xi:include href="xml/api-index-4.2.3.xml"><xi:fallback /></xi:include>
+  </index>
+  <index id="api-index-4-2-1" role="4.2.1">
+    <title>Index of new API in 4.2.1</title>
+    <xi:include href="xml/api-index-4.2.1.xml"><xi:fallback /></xi:include>
+  </index>
+  <index id="api-index-4-2" role="4.2">
+    <title>Index of new API in 4.2</title>
+    <xi:include href="xml/api-index-4.2.xml"><xi:fallback /></xi:include>
+  </index>
+  <index id="api-index-4-0-3" role="4.0.3">
+    <title>Index of new API in 4.0.3</title>
+    <xi:include href="xml/api-index-4.0.3.xml"><xi:fallback /></xi:include>
+  </index>
+  <index id="api-index-3-2" role="3.2">
+    <title>Index of new API in 3.2</title>
+    <xi:include href="xml/api-index-3.2.xml"><xi:fallback /></xi:include>
+  </index>
   <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
 </book>
diff --git a/doc/C/libgda/libgda-sections.txt b/doc/C/libgda/libgda-6.0-sections.txt
similarity index 90%
rename from doc/C/libgda/libgda-sections.txt
rename to doc/C/libgda/libgda-6.0-sections.txt
index 22c53bf6b..5cb10cd41 100644
--- a/doc/C/libgda/libgda-sections.txt
+++ b/doc/C/libgda/libgda-6.0-sections.txt
@@ -20,6 +20,7 @@ gda_ddl_fkey_get_onupdate_id
 gda_ddl_fkey_set_onupdate
 gda_ddl_fkey_prepare_create
 </SECTION>
+
 <SECTION>
 <FILE>gda-ddl-column</FILE>
 <TITLE>GdaDdlColumn</TITLE>
@@ -55,6 +56,7 @@ gda_ddl_column_set_unique
 gda_ddl_column_prepare_add
 gda_ddl_column_prepare_create
 </SECTION>
+
 <SECTION>
 <FILE>gda-ddl-base</FILE>
 <TITLE>GdaDdlBase</TITLE>
@@ -72,6 +74,7 @@ gda_ddl_base_set_name
 gda_ddl_base_set_names
 gda_ddl_base_set_schema
 </SECTION>
+
 <SECTION>
 <FILE>gda-ddl-buildable</FILE>
 <TITLE>GdaDdlBuildable</TITLE>
@@ -80,6 +83,7 @@ GDA_TYPE_DDL_BUILDABLE
 gda_ddl_buildable_parse_node
 gda_ddl_buildable_write_node
 </SECTION>
+
 <SECTION>
 <FILE>gda-ddl-creator</FILE>
 <TITLE>GdaDdlCreator</TITLE>
@@ -100,6 +104,7 @@ gda_ddl_creator_perform_operation
 gda_ddl_creator_write_to_file
 gda_ddl_creator_write_to_path
 </SECTION>
+
 <SECTION>
 <FILE>gda-ddl-table</FILE>
 <TITLE>GdaDdlTable</TITLE>
@@ -120,6 +125,7 @@ gda_ddl_table_set_temp
 gda_ddl_table_prepare_create
 gda_ddl_table_update
 </SECTION>
+
 <SECTION>
 <FILE>gda-ddl-view</FILE>
 <TITLE>GdaDdlView</TITLE>
@@ -139,6 +145,7 @@ gda_ddl_view_set_replace
 gda_ddl_view_prepare_create
 gda_ddl_view_create
 </SECTION>
+
 <SECTION>
 <FILE>gda-column</FILE>
 <TITLE>GdaColumn</TITLE>
@@ -156,6 +163,14 @@ gda_column_get_default_value
 gda_column_get_attribute
 gda_column_set_attribute
 gda_column_set_attribute_static
+gda_column_set_name
+gda_column_set_description
+gda_column_set_dbms_type
+gda_column_set_g_type
+gda_column_set_allow_null
+gda_column_set_auto_increment
+gda_column_set_position
+gda_column_set_default_value
 <SUBSECTION Standard>
 GDA_COLUMN
 GDA_COLUMN_CLASS
@@ -288,10 +303,6 @@ gda_connection_add_savepoint
 gda_connection_rollback_savepoint
 gda_connection_delete_savepoint
 <SUBSECTION>
-gda_connection_async_statement_execute
-gda_connection_async_fetch_result
-gda_connection_async_cancel
-<SUBSECTION>
 gda_connection_get_transaction_status
 gda_connection_get_options
 gda_connection_get_provider
@@ -339,7 +350,6 @@ gda_connection_get_type
 <TITLE>GdaDataModelArray</TITLE>
 GdaDataModelArray
 GdaDataModelArrayClass
-GdaDataModelArrayPrivate
 gda_data_model_array_new
 gda_data_model_array_new_with_g_types
 gda_data_model_array_new_with_g_types_v
@@ -494,7 +504,6 @@ gda_data_model_import_get_type
 <TITLE>GdaDataAccessWrapper</TITLE>
 GdaDataAccessWrapper
 GdaDataAccessWrapperClass
-GdaDataAccessWrapperPrivate
 gda_data_access_wrapper_new
 gda_data_access_wrapper_set_mapping
 <SUBSECTION Standard>
@@ -637,6 +646,8 @@ gda_data_model_iter_is_valid
 gda_data_model_iter_move_to_row
 gda_data_model_iter_move_next
 gda_data_model_iter_move_prev
+gda_data_model_iter_move_next_default
+gda_data_model_iter_move_prev_default
 gda_data_model_iter_get_row
 gda_data_model_iter_get_holder_for_field
 gda_data_model_iter_invalidate_contents
@@ -695,6 +706,10 @@ GdaRow
 gda_row_new
 gda_row_get_length
 gda_row_get_value
+gda_row_invalidate_value
+gda_row_invalidate_value_e
+gda_row_value_is_valid
+gda_row_value_is_valid_e
 <SUBSECTION Standard>
 GDA_IS_ROW
 GDA_IS_ROW_CLASS
@@ -722,6 +737,9 @@ gda_server_operation_set_value_at_path
 gda_server_operation_save_data_to_xml
 gda_server_operation_load_data_from_xml
 gda_server_operation_is_valid
+gda_server_operation_is_valid_from_resource
+gda_server_operation_render
+gda_server_operation_save_data_to_xml_string
 <SUBSECTION>
 GdaServerOperationError
 GdaServerOperationCreateTableFlag
@@ -729,17 +747,52 @@ gda_server_operation_prepare_create_database
 gda_server_operation_perform_create_database
 gda_server_operation_prepare_drop_database
 gda_server_operation_perform_drop_database
-gda_server_operation_prepare_create_table
-gda_server_operation_perform_create_table
-gda_server_operation_prepare_drop_table
-gda_server_operation_perform_drop_table
+<SUBSECTION>
+GdaServerOperationCreateTableArgFKeyRefField
+gda_server_operation_create_table_arg_fkey_ref_field_new
+gda_server_operation_create_table_arg_fkey_ref_field_copy
+gda_server_operation_create_table_arg_fkey_ref_field_free
+gda_server_operation_create_table_arg_fkey_ref_field_get_local_field
+gda_server_operation_create_table_arg_fkey_ref_field_get_referenced_field
+gda_server_operation_create_table_arg_fkey_ref_field_set_local_field
+gda_server_operation_create_table_arg_fkey_ref_field_set_referenced_field
+<SUBSECTION>
+GdaServerOperationCreateTableArg
+gda_server_operation_create_table_arg_new
+gda_server_operation_create_table_arg_copy
+gda_server_operation_create_table_arg_free
+gda_server_operation_create_table_arg_get_column_name
+gda_server_operation_create_table_arg_get_column_type
+gda_server_operation_create_table_arg_get_fkey_ondelete
+gda_server_operation_create_table_arg_get_fkey_onupdate
+gda_server_operation_create_table_arg_get_fkey_ref_field_get_type
+gda_server_operation_create_table_arg_get_fkey_refs
+gda_server_operation_create_table_arg_get_fkey_table
+gda_server_operation_create_table_arg_get_flags
+gda_server_operation_create_table_arg_set_column_name
+gda_server_operation_create_table_arg_set_column_type
+gda_server_operation_create_table_arg_set_fkey_ondelete
+gda_server_operation_create_table_arg_set_fkey_ondupdate
+gda_server_operation_create_table_arg_set_fkey_refs
+gda_server_operation_create_table_arg_set_fkey_table
+gda_server_operation_create_table_arg_set_flags
+<SUBSECTION>
+gda_server_operation_node_copy
+gda_server_operation_node_free
 <SUBSECTION Standard>
 GDA_IS_SERVER_OPERATION
 GDA_IS_SERVER_OPERATION_CLASS
 GDA_SERVER_OPERATION
 GDA_SERVER_OPERATION_CLASS
 GDA_TYPE_SERVER_OPERATION
+GDA_TYPE_SERVER_OPERATION_CREATE_TABLE_ARG
+GDA_TYPE_SERVER_OPERATION_CREATE_TABLE_ARG_FKEY_REF_FIELD
+GDA_TYPE_SERVER_OPERATION_NODE
 gda_server_operation_get_type
+gda_server_operation_create_table_arg_fkey_ref_field_get_type
+gda_server_operation_create_table_arg_get_type
+gda_server_operation_node_get_type
+gda_server_operation_error_quark
 </SECTION>
 
 <SECTION>
@@ -970,6 +1023,9 @@ gda_parse_iso8601_timestamp
 gda_parse_formatted_date
 gda_parse_formatted_time
 gda_parse_formatted_timestamp
+<SUBSECTION>
+gda_alphanum_to_text
+gda_text_to_alphanum
 </SECTION>
 
 <SECTION>
@@ -1065,8 +1121,12 @@ gda_blob_to_string
 gda_string_to_blob
 <SUBSECTION>
 GdaGeometricPoint
-gda_geometricpoint_copy
-gda_geometricpoint_free
+gda_geometric_point_copy
+gda_geometric_point_free
+gda_geometric_point_get_x
+gda_geometric_point_set_x
+gda_geometric_point_get_y
+gda_geometric_point_set_y
 gda_value_get_geometric_point
 gda_value_set_geometric_point
 <SUBSECTION>
@@ -1094,7 +1154,6 @@ gda_time_change_timezone
 gda_value_get_time
 gda_value_set_time
 gda_value_new_time_from_timet
-gda_value_new_timestamp_from_timet
 gda_value_new_date_time_from_timet
 <SUBSECTION>
 gda_value_get_short
@@ -1615,6 +1674,22 @@ gda_meta_store_get_internal_connection
 gda_meta_store_declare_foreign_key
 gda_meta_store_undeclare_foreign_key
 <SUBSECTION>
+gda_meta_store_change_copy
+gda_meta_store_change_free
+gda_meta_store_change_get_change_type
+gda_meta_store_change_get_keys
+gda_meta_store_change_get_table_name
+gda_meta_store_change_get_type
+gda_meta_store_change_new
+gda_meta_store_change_set_change_type
+gda_meta_store_change_set_table_name
+gda_meta_store_create_modify_data_model
+gda_meta_store_create_struct
+<SUBSECTION>
+gda_meta_store_schema_get_all_tables
+gda_meta_store_schema_get_depend_tables
+gda_meta_store_schema_remove_custom_object
+<SUBSECTION>
 gda_meta_context_get_type
 gda_meta_context_new
 gda_meta_context_copy
@@ -1623,6 +1698,8 @@ gda_meta_context_get_table
 gda_meta_context_set_column
 gda_meta_context_set_columns
 gda_meta_context_free
+<SUBSECTION>
+gda_meta_store_error_quark
 <SUBSECTION Standard>
 GDA_IS_META_STORE
 GDA_META_STORE
@@ -1671,12 +1748,15 @@ gda_meta_struct_get_db_object
 gda_meta_struct_get_table_column
 GdaMetaGraphInfo
 gda_meta_struct_dump_as_graph
+gda_meta_struct_error_quark
+gda_meta_struct_load_from_xml_file
 </SECTION>
 
 <SECTION>
 <FILE>gda-data-select</FILE>
 <TITLE>GdaDataSelect</TITLE>
 GdaDataSelect
+GdaDataSelectClass
 GdaDataSelectError
 gda_data_select_set_row_selection_condition_sql
 gda_data_select_set_row_selection_condition
@@ -1690,6 +1770,11 @@ gda_data_select_compute_columns_attributes
 gda_data_select_rerun
 gda_data_select_add_exception
 gda_data_select_prepare_for_offline
+<SUBSECTION Private>
+gda_data_select_take_row
+gda_data_select_get_stored_row
+gda_data_select_get_connection
+gda_data_select_set_columns
 <SUBSECTION Standard>
 GDA_IS_DATA_SELECT
 GDA_DATA_SELECT
@@ -1698,37 +1783,6 @@ GDA_TYPE_DATA_SELECT
 gda_data_select_get_type
 </SECTION>
 
-<SECTION>
-<FILE>gda-data-select-priv</FILE>
-<TITLE>Subclassing GdaDataSelect</TITLE>
-<INCLUDE>libgda/providers-support/gda-data-select-priv.h</INCLUDE>
-GdaDataSelectClass
-gda_data_select_take_row
-gda_data_select_get_stored_row
-gda_data_select_get_connection
-gda_data_select_set_columns
-<SUBSECTION>
-gda_column_set_name
-gda_column_set_description
-gda_column_set_dbms_type
-gda_column_set_g_type
-gda_column_set_allow_null
-gda_column_set_auto_increment
-gda_column_set_position
-gda_column_set_default_value
-<SUBSECTION>
-gda_alphanum_to_text
-gda_text_to_alphanum
-<SUBSECTION>
-gda_data_model_iter_move_next_default
-gda_data_model_iter_move_prev_default
-<SUBSECTION>
-gda_row_invalidate_value
-gda_row_invalidate_value_e
-gda_row_value_is_valid
-gda_row_value_is_valid_e
-</SECTION>
-
 <SECTION>
 <FILE>gda-pstmt</FILE>
 <TITLE>GdaPStmt</TITLE>
@@ -1752,7 +1806,6 @@ gda_server_operation_new
 gda_server_provider_internal_get_parser
 <SUBSECTION>
 gda_server_provider_perform_operation_default
-gda_server_provider_get_data_handler_default
 <SUBSECTION>
 gda_server_provider_handler_use_default
 gda_server_provider_handler_find
@@ -1830,7 +1883,6 @@ gda_statement_to_sql_real
 <TITLE>GdaDataComparator</TITLE>
 GdaDataComparator
 GdaDataComparatorClass
-GdaDataComparatorPrivate
 gda_data_comparator_new
 gda_data_comparator_set_key_columns
 GdaDiff
@@ -2053,7 +2105,6 @@ gda_worker_new
 gda_worker_new_unique
 gda_worker_ref
 gda_worker_unref
-gda_worker_kill
 <SUBSECTION>
 GdaWorkerFunc
 gda_worker_submit_job
@@ -2068,6 +2119,94 @@ GdaWorkerCallback
 gda_worker_set_callback
 </SECTION>
 
+<SECTION>
+<FILE>gda-provider</FILE>
+<TITLE>GdaProvider</TITLE>
+gda_provider_add_savepoint
+gda_provider_begin_transaction
+gda_provider_close_connection
+gda_provider_commit_transaction
+gda_provider_create_connection
+gda_provider_create_operation
+gda_provider_create_parser
+gda_provider_delete_savepoint
+gda_provider_escape_string
+gda_provider_get_data_handler
+gda_provider_get_def_dbms_type
+gda_provider_get_name
+gda_provider_get_server_version
+gda_provider_get_version
+gda_provider_identifier_quote
+gda_provider_meta_btypes
+gda_provider_meta_character_set
+gda_provider_meta_character_sets
+gda_provider_meta_check_column
+gda_provider_meta_check_columns
+gda_provider_meta_collation
+gda_provider_meta_collations
+gda_provider_meta_columns
+gda_provider_meta_constraint_ref
+gda_provider_meta_constraint_table
+gda_provider_meta_constraints_ref
+gda_provider_meta_constraints_ref_table
+gda_provider_meta_constraints_table
+gda_provider_meta_constraints_tables
+gda_provider_meta_domain
+gda_provider_meta_domain_constraint
+gda_provider_meta_domain_constraints
+gda_provider_meta_domains
+gda_provider_meta_domains_constraints
+gda_provider_meta_element_type
+gda_provider_meta_element_types
+gda_provider_meta_enum_type
+gda_provider_meta_enums_type
+gda_provider_meta_error_quark
+gda_provider_meta_execute_query
+gda_provider_meta_execute_query_row
+gda_provider_meta_get_connection
+gda_provider_meta_index_col
+gda_provider_meta_index_cols
+gda_provider_meta_index_table
+gda_provider_meta_indexes_table
+gda_provider_meta_indexes_tables
+gda_provider_meta_key_column
+gda_provider_meta_key_columns
+gda_provider_meta_routine
+gda_provider_meta_routine_col
+gda_provider_meta_routine_pars
+gda_provider_meta_routines
+gda_provider_meta_routines_col
+gda_provider_meta_routines_pars
+gda_provider_meta_schemata
+gda_provider_meta_schematas
+gda_provider_meta_table_column
+gda_provider_meta_table_columns
+gda_provider_meta_table_view
+gda_provider_meta_tables_views
+gda_provider_meta_trigger
+gda_provider_meta_triggers
+gda_provider_meta_udt
+gda_provider_meta_udt_col
+gda_provider_meta_udt_cols
+gda_provider_meta_udts
+gda_provider_meta_view_col
+gda_provider_meta_view_cols
+gda_provider_meta_views_cols
+gda_provider_open_connection
+gda_provider_perform_operation
+gda_provider_prepare_connection
+gda_provider_render_operation
+gda_provider_rollback_savepoint
+gda_provider_rollback_transaction
+gda_provider_statement_execute
+gda_provider_statement_prepare
+gda_provider_statement_rewrite
+gda_provider_statement_to_sql
+gda_provider_supports_feature
+gda_provider_supports_operation
+gda_provider_unescape_string
+</SECTION>
+
 <SECTION>
 <FILE>gda-connect</FILE>
 <TITLE>Inter thread signal propagation</TITLE>
diff --git a/libgda/gda-blob-op.h b/libgda/gda-blob-op.h
index b4cf9d564..4e5b6f762 100644
--- a/libgda/gda-blob-op.h
+++ b/libgda/gda-blob-op.h
@@ -41,7 +41,7 @@ struct _GdaBlobOpClass {
 /**
  * SECTION:gda-blob-op
  * @short_description: Binary data and BLOBs handling
- * @title: Blobs
+ * @title: GdaBlob
  * @stability: Stable
  * @see_also:
  *
diff --git a/libgda/gda-quark-list.h b/libgda/gda-quark-list.h
index ad52591b9..145771283 100644
--- a/libgda/gda-quark-list.h
+++ b/libgda/gda-quark-list.h
@@ -37,7 +37,7 @@ typedef struct _GdaQuarkList GdaQuarkList;
 /**
  * SECTION:gda-quark-list
  * @short_description: Manages lists of KEY=VALUE pairs
- * @title: Quark list
+ * @title: GdaQuarkList
  * @stability: Stable
  * @see_also:
  *
diff --git a/libgda/gda-value.h b/libgda/gda-value.h
index a4a27d0d1..1c65d0893 100644
--- a/libgda/gda-value.h
+++ b/libgda/gda-value.h
@@ -155,8 +155,8 @@ void                              gda_blob_set_op (GdaBlob *blob, GdaBlobOp *op)
 
 /**
  * SECTION:gda-value
- * @short_description: Assorted functions for dealing with #GValue values
- * @title: A single Value
+ * @short_description: Assorted functions for dealing with single #GValue values
+ * @title: GdaValue
  * @stability: Stable
  * @see_also: #GValue and #GdaBlobOp
  *
diff --git a/tools/common/web-server.c b/tools/common/web-server.c
index 07295d662..bb9627955 100644
--- a/tools/common/web-server.c
+++ b/tools/common/web-server.c
@@ -1338,8 +1338,7 @@ compute_object_content (HtmlDoc *hdoc, WebServer *webserver, TConnection *tcnc,
        g_value_take_string ((v1 = gda_value_new (G_TYPE_STRING)),
                             gda_sql_identifier_quote (name, t_connection_get_cnc (tcnc), NULL, FALSE, 
FALSE));
 
-       mstruct = gda_meta_struct_new (gda_connection_get_meta_store (t_connection_get_cnc (tcnc)),
-                                      GDA_META_STRUCT_FEATURE_ALL);
+       mstruct = (GdaMetaStruct*) g_object_new (GDA_TYPE_META_STRUCT, "meta-store", 
gda_connection_get_meta_store (t_connection_get_cnc (tcnc)), "features", GDA_META_STRUCT_FEATURE_ALL, NULL);
        dbo = gda_meta_struct_complement (mstruct, GDA_META_DB_UNKNOWN, NULL, v0, v1, error);
        gda_value_free (v0);
        gda_value_free (v1);