[libgda] GdaConfig, GdaConnection: Add docs about error domains thrown.

[Murray Cumming <murrayc src gnome org>]

commit 9903d4cc34d7b679098501e6cdbba5f0e40b4051
Author: Murray Cumming <murrayc murrayc com>
Date:   Tue Aug 31 14:53:56 2010 +0200

    GdaConfig, GdaConnection: Add docs about error domains thrown.

 libgda/gda-config.c     |   10 ++++++++--
 libgda/gda-connection.c |    8 +++++++-
 2 files changed, 15 insertions(+), 3 deletions(-)
---
diff --git a/libgda/gda-config.c b/libgda/gda-config.c
index b5c8652..362575c 100644
--- a/libgda/gda-config.c
+++ b/libgda/gda-config.c
@@ -849,7 +849,9 @@ password_stored_cb (GnomeKeyringResult res, const gchar *dsnname)
  * @info: a pointer to a filled GdaDsnInfo structure
  * @error: a place to store errors, or %NULL
  *
- * Add or update a DSN from the definition in @info
+ * Add or update a DSN from the definition in @info.
+ *
+ * This method may fail with a %GDA_CONFIG_ERROR domain error (see the #GdaConfigError error codes).
  *
  * Returns: TRUE if no error occurred
  */
@@ -969,7 +971,9 @@ password_deleted_cb (GnomeKeyringResult res, const gchar *dsnname)
  * @dsn_name: the name of the DSN to remove
  * @error: a place to store errors, or %NULL
  *
- * Remove the DSN named @dsn_name
+ * Remove the DSN named @dsn_name.
+ *
+ * This method may fail with a %GDA_CONFIG_ERROR domain error (see the #GdaConfigError error codes).
  *
  * Returns: TRUE if no error occurred
  */
@@ -1229,6 +1233,8 @@ gda_config_get_provider_info (const gchar *provider_name)
  * provider named @provider_name. The caller must not call g_object_unref() on the
  * returned object.
  *
+ * This method may fail with a %GDA_CONFIG_ERROR domain error (see the #GdaConfigError error codes).
+ *
  * Returns: (transfer none): a pointer to the #GdaServerProvider, or %NULL if an error occurred
  */
 GdaServerProvider *
diff --git a/libgda/gda-connection.c b/libgda/gda-connection.c
index aeea0ee..34cccee 100644
--- a/libgda/gda-connection.c
+++ b/libgda/gda-connection.c
@@ -939,6 +939,9 @@ _gda_connection_get_internal_thread_provider (void)
  * provider (use gda_config_get_provider_info() to get it). Also one can use the "gda-sql-4.0 -L" command to 
  * list the possible named parameters.
  *
+ * This method may fail with a GDA_CONNECTION_ERROR domain error (see the #GdaConnectionError error codes) 
+ * or a %GDA_CONFIG_ERROR domain error (see the #GdaConfigError error codes).
+ *
  * Returns: a new #GdaConnection if connection opening was sucessfull or %NULL if there was an error.
  */
 GdaConnection *
@@ -1088,7 +1091,10 @@ gda_connection_open_from_dsn (const gchar *dsn, const gchar *auth_string,
  * Additionally, it is possible to have the connection string
  * respect the "&lt;provider_name&gt;://&lt;real cnc string&gt;" format, in which case the provider name
  * and the real connection string will be extracted from that string (note that if @provider_name
- * is not %NULL then it will still be used as the provider ID).
+ * is not %NULL then it will still be used as the provider ID).\
+ *
+ * This method may fail with a GDA_CONNECTION_ERROR domain error (see the #GdaConnectionError error codes) 
+ * or a %GDA_CONFIG_ERROR domain error (see the #GdaConfigError error codes).
  *
  * Returns: a new #GdaConnection if connection opening was sucessfull or %NULL if there was an error.
  */