[libgda] Doc. improvements

[Vivien Malerba <vivien src gnome org>]

commit 855e0e9fc903c7fafa13f5658a311a92fb3d65c1
Author: Vivien Malerba <malerba gnome-db org>
Date:   Tue Jul 7 17:17:03 2015 +0200

    Doc. improvements

 doc/C/limitations.xml                    |    2 +-
 libgda/gda-connection.c                  |    7 +++++--
 providers/sqlite/sqlite_specs_dsn.xml.in |    2 +-
 3 files changed, 7 insertions(+), 4 deletions(-)
---
diff --git a/doc/C/limitations.xml b/doc/C/limitations.xml
index 1b1b4df..01cab6b 100644
--- a/doc/C/limitations.xml
+++ b/doc/C/limitations.xml
@@ -123,7 +123,7 @@
     </para>
     <sect2><title>Last inserted row's values</title>
       <para>
-       The <link 
linkend="gda-connection-statement-execute-non-select">gda_connection_statement_execute_non_select()</link>'s 
last_insert_row attribute uses the hidden "_ROWID_" column for each table, but it may fail if the table has a 
column with the same name.
+       The <link 
linkend="gda-connection-statement-execute-non-select">gda_connection_statement_execute_non_select()</link>'s 
last_insert_row attribute uses the hidden "_ROWID_" column for each table, but it may fail if the table has a 
column with the same name, or if the table is defined with the <ulink 
url="https://www.sqlite.org/withoutrowid.html";>WITHOUT ROWID</ulink> Optimization.
       </para>
     </sect2>
 
diff --git a/libgda/gda-connection.c b/libgda/gda-connection.c
index ef2caeb..64c7d5a 100644
--- a/libgda/gda-connection.c
+++ b/libgda/gda-connection.c
@@ -3195,8 +3195,8 @@ gda_connection_execute_non_select_command (GdaConnection *cnc, const gchar *sql,
  *        </itemizedlist></para></listitem>
  * </itemizedlist>
  *
- * If @last_insert_row is not %NULL and @stmt is an INSERT statement, then it will contain (if the
- * provider used by @cnc supports it) a new #GdaSet object composed of value holders named "+&lt;column 
number&gt;"
+ * If @last_insert_row is not %NULL and @stmt is an INSERT statement, then it will contain a new #GdaSet
+ * object composed of value holders named "+&lt;column number&gt;"
  * starting at column 0 which contain the actual inserted values. For example if a table is composed of an 
'id' column
  * which is auto incremented and a 'name' column then the execution of a "INSERT INTO mytable (name) VALUES 
('joe')"
  * query will return a #GdaSet with two holders:
@@ -3204,6 +3204,9 @@ gda_connection_execute_non_select_command (GdaConnection *cnc, const gchar *sql,
  *   <listitem><para>one with the '+0' ID which may for example contain 1 (note that its "name" property 
should be "id")</para></listitem>
  *   <listitem><para>one with the '+1' ID which will contain 'joe' (note that its "name" property should be 
"name")</para></listitem>
  * </itemizedlist>
+ * Note that the value pointer by @last_insert_row may be %NULL after the function call if either the 
database provider
+ * does not support it, or if the last interted row could not be determined (for example with SQLite if the 
table
+ * in which the data is inserted has the WITHOUT ROWID optimization).
  *
  * This method may fail with a %GDA_SERVER_PROVIDER_ERROR domain error (see the #GdaServerProviderError 
error codes).
  *
diff --git a/providers/sqlite/sqlite_specs_dsn.xml.in b/providers/sqlite/sqlite_specs_dsn.xml.in
index c232bbc..507bb01 100644
--- a/providers/sqlite/sqlite_specs_dsn.xml.in
+++ b/providers/sqlite/sqlite_specs_dsn.xml.in
@@ -2,7 +2,7 @@
 <data-set-spec>
   <parameters>
     <parameter id="DB_NAME" _name="Database name" _descr="The name of a database to use (without the .db)" 
gdatype="gchararray" nullok="FALSE"/>
-    <parameter id="APPEND_DB_EXTENSION" _name="Append '.db'" _descr="Defines if the '.db' extension need to 
be appended to the DB_NAME argument" gdatype="gchararray" nullok="TRUE"/>
+    <parameter id="APPEND_DB_EXTENSION" _name="Append '.db'" _descr="Defines if the '.db' extension need to 
be appended to the DB_NAME argument" gdatype="gboolean" nullok="TRUE"/>
     <parameter id="DB_DIR" _name="Directory" _descr="Directory where the database file is stored" 
gdatype="gchararray" nullok="FALSE" plugin="filesel:MODE=PICKFOLDER"/>
     <parameter id="EXTRA_FUNCTIONS" _name="Extra functions" _descr="Enable usage of extra functions 
(gda_upper, ...)" gdatype="gboolean" nullok="TRUE">
       <gda_value>TRUE</gda_value>