gnucash-docs maint: Multiple changes pushed

Geert Janssens gjanssens at code.gnucash.org
Thu Sep 6 11:00:42 EDT 2018


Updated	 via  https://github.com/Gnucash/gnucash-docs/commit/ecd868ba (commit)
	 via  https://github.com/Gnucash/gnucash-docs/commit/507bdc1a (commit)
	 via  https://github.com/Gnucash/gnucash-docs/commit/f5acedca (commit)
	 via  https://github.com/Gnucash/gnucash-docs/commit/6929e9f1 (commit)
	 via  https://github.com/Gnucash/gnucash-docs/commit/98040e59 (commit)
	 via  https://github.com/Gnucash/gnucash-docs/commit/1840b871 (commit)
	 via  https://github.com/Gnucash/gnucash-docs/commit/9dfd19c8 (commit)
	from  https://github.com/Gnucash/gnucash-docs/commit/c111e08b (commit)



commit ecd868ba4feb8f9b77ec02ba0f89d3b98f420e70
Author: Geert Janssens <geert at kobaltwit.be>
Date:   Thu Sep 6 16:50:21 2018 +0200

    Fix xmllint error

diff --git a/guide/C/ch_basics.xml b/guide/C/ch_basics.xml
index d14a86b..586e0f3 100644
--- a/guide/C/ch_basics.xml
+++ b/guide/C/ch_basics.xml
@@ -649,7 +649,7 @@
 		<title>Storage Comparison and Recommendations</title>
 		<para>Each storage format has benefits and shortcomings that users should 
 		consider for their needs and abilities. See the 
-		<link linkend='basics-storage-comparison-table' endterm="basics-storage-comparison-table.title"/> below 
+		<link linkend='basics-storage-comparison-table' endterm="basics-storage-comparison-tbltitle"/> below
 		for further details.</para>
 		
 		<para>The <acronym>XML</acronym> format is the most stable and established, 
@@ -672,7 +672,7 @@
 	<sect2 id="basics-storage-comparison-tblsect">
 		<title>Storage Comparison Table</title>
 		<table frame="topbot" id="basics-storage-comparison-table">
-			<title>Storage Comparison</title>
+			<title id="basics-storage-comparison-tbltitle">Storage Comparison</title>
 
 			<tgroup align="left" cols="5">
 				<colspec colname="c1item" ></colspec>

commit 507bdc1ae0061fccef33be3ec49860c2eeac8d76
Author: David Thomas <sunfish62 at yahoo.com>
Date:   Mon Sep 3 22:24:19 2018 -0400

    Changes to meet Fellen editorial suggestions

diff --git a/guide/C/ch_basics.xml b/guide/C/ch_basics.xml
index a93b06f..d14a86b 100644
--- a/guide/C/ch_basics.xml
+++ b/guide/C/ch_basics.xml
@@ -638,17 +638,18 @@
 		require access to a MySQL or PostgreSQL database server and the installation of 
 		additional database drivers on your machine.</para>
 		
-		<note>
+		<tip>
 		<para>Users can change the format at any time by using <menuchoice><guimenu>File</guimenu> 
 		<guimenuitem>Save As...</guimenuitem></menuchoice>. This will create a copy of 
 		the data file in the selected format.</para>
-		</note>
+		</tip>
 	</sect2>
 
 	<sect2 id="basics-files-storage-comparison">
 		<title>Storage Comparison and Recommendations</title>
 		<para>Each storage format has benefits and shortcomings that users should 
-		consider for their needs and abilities. See the Storage Comparison Table below 
+		consider for their needs and abilities. See the 
+		<link linkend='basics-storage-comparison-table' endterm="basics-storage-comparison-table.title"/> below 
 		for further details.</para>
 		
 		<para>The <acronym>XML</acronym> format is the most stable and established, 
@@ -658,7 +659,7 @@
 		<acronym>SQL</acronym> storage without the overhead of installing or managing 
 		a full <acronym>DBMS</acronym>. MySQL and PostgreSQL require the installation 
 		of MySQL and PostgreSQL <acronym>DBMS</acronym>, respectively, and are best 
-		implemented only by experienced database administrators.</para>
+		maintained only by experienced database administrators.</para>
 			
 		<note>
 			<para>Use of a <acronym>SQL</acronym> back end for storage implies to many 
@@ -668,9 +669,9 @@
 			although it is a long term goal of the development team. </para>
 		</note>
 	</sect2>
-	<sect2 id="basics-files-storagetable">
+	<sect2 id="basics-storage-comparison-tblsect">
 		<title>Storage Comparison Table</title>
-		<table frame="topbot" id="storage-comparison">
+		<table frame="topbot" id="basics-storage-comparison-table">
 			<title>Storage Comparison</title>
 
 			<tgroup align="left" cols="5">

commit f5acedca1d763d5d193ebdf1fe985168047caaad
Author: David Thomas <sunfish62 at yahoo.com>
Date:   Fri Aug 31 16:33:38 2018 -0400

    Making "No"

diff --git a/guide/C/ch_basics.xml b/guide/C/ch_basics.xml
index d75dabf..a93b06f 100644
--- a/guide/C/ch_basics.xml
+++ b/guide/C/ch_basics.xml
@@ -739,10 +739,10 @@
 
 			<row>
                 <entry namest="c1item"                      >Multi-user</entry>
-  				<entry align="center" namest="c2xml"        > N </entry>
-  				<entry align="center" namest="c3sqlite"     > N </entry>
-  				<entry align="center" namest="c4mysql"      > N </entry>
-  				<entry align="center" namest="c5pgsql" > N </entry>
+  				<entry align="center" namest="c2xml"        > No </entry>
+  				<entry align="center" namest="c3sqlite"     > No </entry>
+  				<entry align="center" namest="c4mysql"      > No </entry>
+  				<entry align="center" namest="c5pgsql" > No </entry>
 			</row>
 			</tbody>
 		</tgroup>

commit 6929e9f1c46158447009ccd35d2b4d1a344fe593
Author: David Thomas <sunfish62 at yahoo.com>
Date:   Fri Aug 31 14:51:46 2018 -0400

    Final edit per GJanssens suggestion.

diff --git a/guide/C/ch_basics.xml b/guide/C/ch_basics.xml
index 3bdd1e8..d75dabf 100644
--- a/guide/C/ch_basics.xml
+++ b/guide/C/ch_basics.xml
@@ -654,8 +654,11 @@
 		<para>The <acronym>XML</acronym> format is the most stable and established, 
 		and for this reason, it is recommended for most users. <acronym>SQL</acronym>
 		storage was added for the 2.4 release and has become an increasingly popular 
-		choice for users, but can require experience with <acronym>DBMS</acronym> 
-		applications.</para>
+		choice for users. The SQLite format allows users to realize the benefits of 
+		<acronym>SQL</acronym> storage without the overhead of installing or managing 
+		a full <acronym>DBMS</acronym>. MySQL and PostgreSQL require the installation 
+		of MySQL and PostgreSQL <acronym>DBMS</acronym>, respectively, and are best 
+		implemented only by experienced database administrators.</para>
 			
 		<note>
 			<para>Use of a <acronym>SQL</acronym> back end for storage implies to many 

commit 98040e597510147cef536a1dbb230c64278dba4a
Author: David Thomas <sunfish62 at yahoo.com>
Date:   Fri Aug 31 12:38:43 2018 -0400

    Further edits, and actually checked for parsing accuracy ;)

diff --git a/guide/C/ch_basics.xml b/guide/C/ch_basics.xml
index c6b49ad..3bdd1e8 100644
--- a/guide/C/ch_basics.xml
+++ b/guide/C/ch_basics.xml
@@ -643,6 +643,7 @@
 		<guimenuitem>Save As...</guimenuitem></menuchoice>. This will create a copy of 
 		the data file in the selected format.</para>
 		</note>
+	</sect2>
 
 	<sect2 id="basics-files-storage-comparison">
 		<title>Storage Comparison and Recommendations</title>
@@ -703,16 +704,14 @@
 
 			<row>
 				<entry namest="c1item"                      >File extension</entry>
-  				<entry align="center" namest="c2xml"        > gnucash </entry>
-  				<entry align="center" namest="c3sqlite"     > gnucash </entry>
+  				<entry align="center" namest="c2xml" nameend="c3sqlite"       > gnucash </entry>
   				<entry align="center" namest="c4mysql" nameend="c5pgsql" > N/A<footnote>
 					<para>MySQL and PostgreSQL place data within their own storage system.</para></footnote></entry>
 			</row>
 
 			<row>
                 <entry namest="c1item"                      >Additional software</entry>
-  				<entry align="center" namest="c2xml"        > None </entry>
-  				<entry align="center" namest="c3sqlite"     > None </entry>
+  				<entry align="center" namest="c2xml" nameend="c3sqlite" > None </entry>
   				<entry align="center" namest="c4mysql"      > MySQL </entry>
   				<entry align="center" namest="c5pgsql" > PostgreSQL </entry>
 			</row>
@@ -732,7 +731,7 @@
 			<row>
                 <entry namest="c1item"                      >File Save</entry>
   				<entry align="center" namest="c2xml"        > On command </entry>
-  				<entry align="center" namest="c3sqlite" namend="c5pgsql" > On commit </entry>
+  				<entry align="center" namest="c3sqlite" nameend="c5pgsql" > On commit </entry>
 			</row>
 
 			<row>

commit 1840b871a0f733b404b44291fbebe5b195eeda78
Author: David Thomas <sunfish62 at yahoo.com>
Date:   Fri Aug 31 12:16:04 2018 -0400

    Adding editorial changes

diff --git a/guide/C/ch_basics.xml b/guide/C/ch_basics.xml
index f92ad63..c6b49ad 100644
--- a/guide/C/ch_basics.xml
+++ b/guide/C/ch_basics.xml
@@ -625,144 +625,126 @@
 		<para><application>&app;</application> offers several formats for storing 
 		your financial data. The default file storage format is <acronym>XML</acronym>, 
 		while <acronym>SQL</acronym> storage is available in SQLite, MySQL, and PostgreSQL 
-		formats. Users can choose a file format from the <menuchoice><guimenu>File</guimenu> 
-		<guimenuitem>Save </guimenuitem></menuchoice> and <menuchoice><guimenu>File</guimenu> 
+		formats. Users can choose a file format for new files from <menuchoice><guimenu>File</guimenu> 
+		<guimenuitem>Save </guimenuitem></menuchoice> and for existing files from <menuchoice><guimenu>File</guimenu> 
 		<guimenuitem>Save As...</guimenuitem></menuchoice> dialogs.</para>
 		
-		<para>The <acronym>XML</acronym> storage format is a text file that is compressed 
-		with gzip, which is a preference that is set at <menuchoice><guimenu>Edit</guimenu> 
+		<para>The <acronym>XML</acronym> storage format is a text file that by default is compressed, 
+		which is a preference that is set at <menuchoice><guimenu>Edit</guimenu> 
 		<guimenuitem>Preferences</guimenuitem></menuchoice> <guilabel>General</guilabel> 
-		<guilabel>Compress files</guilabel>. <acronym>SQL</acronym> storage is available 
-		via the <acronym>DBI</acronym> back end; use of MySQL and PostgreSQL requires 
-		installation of those <acronym>DBMS</acronym> packages as well as additional 
-		<acronym>DBI</acronym> drivers.</para>
+		<guilabel>Compress files</guilabel>. SQLite storage is also available, and stores 
+		your data in a single file on your system, like the <acronym>XML</acronym> format. However,
+		internally, an SQLite file is managed as a database. The MySQL and PostgreSQL storage options 
+		require access to a MySQL or PostgreSQL database server and the installation of 
+		additional database drivers on your machine.</para>
 		
 		<note>
 		<para>Users can change the format at any time by using <menuchoice><guimenu>File</guimenu> 
 		<guimenuitem>Save As...</guimenuitem></menuchoice>. This will create a copy of 
 		the data file in the selected format.</para>
 		</note>
-		<sect3 id="basics-files-storage-comparison">
-			<title>Storage Comparison</title>
-			
-			<para>Each storage format has benefits and shortcomings that users should 
-			consider for their needs and abilities. See the Storage Comparison Table below 
-			for further details.</para>
-			
-			<para>The <acronym>XML</acronym> format is the most stable and established, 
-			and for this reason, it is recommended for most users. <acronym>SQL</acronym>
-			storage was added for the 2.4 release and has become an increasingly popular 
-			choice for users, but can require experience with <acronym>DBMS</acronym> 
-			applications.</para>
+
+	<sect2 id="basics-files-storage-comparison">
+		<title>Storage Comparison and Recommendations</title>
+		<para>Each storage format has benefits and shortcomings that users should 
+		consider for their needs and abilities. See the Storage Comparison Table below 
+		for further details.</para>
+		
+		<para>The <acronym>XML</acronym> format is the most stable and established, 
+		and for this reason, it is recommended for most users. <acronym>SQL</acronym>
+		storage was added for the 2.4 release and has become an increasingly popular 
+		choice for users, but can require experience with <acronym>DBMS</acronym> 
+		applications.</para>
 			
-			<note>
-				<para>Use of a <acronym>SQL</acronym> back end for storage implies to many 
-				that <application>&app;</application> has fully implemented <acronym>DBMS</acronym> 
-				features, including multi-user and incremental data manipulation.  However, 
-				<application>&app;</application> does not currently implement these features, 
-				although it is a long term goal of the development team. </para>
-			</note>
-
-            <table frame="topbot" id="storage-comparison">
-              <title>Storage Comparison</title>
-
-              <tgroup align="left" cols="5">
-                <colspec colname="c1item" ></colspec>
-                <colspec colname="c2xml" ></colspec>
-                <colspec colname="c3sqlite" ></colspec>
-                <colspec colname="c4mysql" ></colspec>
-                <colspec colname="c5postgresql" ></colspec>
-
-                <thead>
-                  <row>
-                    <entry> </entry>
-                    <entry align="center">XML</entry>
-                    <entry align="center">SQLite</entry>
-                    <entry align="center">MySQL</entry>
-                    <entry align="center">PostgreSQL</entry>
-                  </row>
-                </thead>
-
-                <tbody>
-                <row>
-                  <entry >Installation</entry>
-  				<entry align="center" namest="c2xml"        > Default </entry>
-  				<entry align="center" namest="c3sqlite"     > libdbi - 1 </entry>
-  				<entry align="center" namest="c4mysql"      > libdbi </entry>
-  				<entry align="center" namest="c5postgresql" > libdbi </entry>
-                </row>
-
-                <row>
-                  <entry >File extension</entry>
+		<note>
+			<para>Use of a <acronym>SQL</acronym> back end for storage implies to many 
+			that <application>&app;</application> has fully implemented <acronym>DBMS</acronym> 
+			features, including multi-user and incremental data manipulation.  However, 
+			<application>&app;</application> does not currently implement these features, 
+			although it is a long term goal of the development team. </para>
+		</note>
+	</sect2>
+	<sect2 id="basics-files-storagetable">
+		<title>Storage Comparison Table</title>
+		<table frame="topbot" id="storage-comparison">
+			<title>Storage Comparison</title>
+
+			<tgroup align="left" cols="5">
+				<colspec colname="c1item" ></colspec>
+				<colspec colname="c2xml" ></colspec>
+				<colspec colname="c3sqlite" ></colspec>
+				<colspec colname="c4mysql" ></colspec>
+				<colspec colname="c5pgsql" ></colspec>
+
+            <thead>
+              <row>
+                <entry> </entry>
+                <entry align="center">XML</entry>
+                <entry align="center">SQLite</entry>
+                <entry align="center">MySQL</entry>
+                <entry align="center">PostgreSQL</entry>
+              </row>
+            </thead>
+
+            <tbody>
+            <row>
+				<entry namest="c1item"                      >Availability</entry>
+  				<entry align="center" namest="c2xml"        > Built-in </entry>
+  				<entry align="center" namest="c3sqlite" nameend="c5pgsql" > Depends on packaging<footnote>
+					<para>SQLite relies on an additional package and driver (called libdbi 
+						and libdbd-sqlite3, respectively), which are installed by 
+						default on Mac OS and Windows. Linux users may need to manually 
+						install these for SQLite.</para>
+					<para>MySQL and PostgreSQL may require the installation of additional software drivers 
+						(libdbd-mysql and libdbd-pgsql).</para>
+					</footnote>
+				</entry>
+			</row>
+
+			<row>
+				<entry namest="c1item"                      >File extension</entry>
   				<entry align="center" namest="c2xml"        > gnucash </entry>
   				<entry align="center" namest="c3sqlite"     > gnucash </entry>
-  				<entry align="center" namest="c4mysql"      > N/A - 2 </entry>
-  				<entry align="center" namest="c5postgresql" > N/A - 2 </entry>
-                </row>
+  				<entry align="center" namest="c4mysql" nameend="c5pgsql" > N/A<footnote>
+					<para>MySQL and PostgreSQL place data within their own storage system.</para></footnote></entry>
+			</row>
 
-                <row>
-                  <entry >Additional software</entry>
+			<row>
+                <entry namest="c1item"                      >Additional software</entry>
   				<entry align="center" namest="c2xml"        > None </entry>
   				<entry align="center" namest="c3sqlite"     > None </entry>
   				<entry align="center" namest="c4mysql"      > MySQL </entry>
-  				<entry align="center" namest="c5postgresql" > PostgreSQL </entry>
-                </row>
-
-                <row>
-                  <entry >Additional expertise</entry>
-  				<entry align="center" namest="c2xml"        > None </entry>
-  				<entry align="center" namest="c3sqlite"     > None </entry>
-  				<entry align="center" namest="c4mysql"      > DBMS </entry>
-  				<entry align="center" namest="c5postgresql" > DBMS </entry>
-                </row>
-
-                <row>
-                  <entry >Compression</entry>
-  				<entry align="center" namest="c2xml"        > Y </entry>
-  				<entry align="center" namest="c3sqlite"     > N </entry>
-  				<entry align="center" namest="c4mysql"      > N </entry>
-  				<entry align="center" namest="c5postgresql" > N </entry>
-               </row>
-
-                <row>
-                  <entry >Save on command</entry>
-  				<entry align="center" namest="c2xml"        > Y </entry>
-  				<entry align="center" namest="c3sqlite"     > N </entry>
-  				<entry align="center" namest="c4mysql"      > N </entry>
-  				<entry align="center" namest="c5postgresql" > N </entry>
-                </row>
-
-                <row>
-                  <entry >Save on commit</entry>
-  				<entry align="center" namest="c2xml"        > N </entry>
-  				<entry align="center" namest="c3sqlite"     > Y </entry>
-  				<entry align="center" namest="c4mysql"      > Y </entry>
-  				<entry align="center" namest="c5postgresql" > Y </entry>
-                </row>
-
-                <row>
-                  <entry >Uses log files</entry>
-  				<entry align="center" namest="c2xml"        > Y </entry>
-  				<entry align="center" namest="c3sqlite"     > N </entry>
-  				<entry align="center" namest="c4mysql"      > N </entry>
-  				<entry align="center" namest="c5postgresql" > N </entry>
-                </row>
-
-                <row>
-                  <entry >Multi-user</entry>
+  				<entry align="center" namest="c5pgsql" > PostgreSQL </entry>
+			</row>
+
+			<row>
+                <entry namest="c1item"                      >Additional expertise</entry>
+  				<entry align="center" namest="c2xml" nameend="c3sqlite"  > None </entry>
+  				<entry align="center" namest="c4mysql" nameend="c5pgsql" > Database Administrator </entry>
+			</row>
+
+			<row>
+                <entry namest="c1item"                      >Compression</entry>
+  				<entry align="center" namest="c2xml"        > gzip </entry>
+  				<entry align="center" namest="c3sqlite" nameend="c5pgsql" > N/A </entry>
+			</row>
+
+			<row>
+                <entry namest="c1item"                      >File Save</entry>
+  				<entry align="center" namest="c2xml"        > On command </entry>
+  				<entry align="center" namest="c3sqlite" namend="c5pgsql" > On commit </entry>
+			</row>
+
+			<row>
+                <entry namest="c1item"                      >Multi-user</entry>
   				<entry align="center" namest="c2xml"        > N </entry>
   				<entry align="center" namest="c3sqlite"     > N </entry>
   				<entry align="center" namest="c4mysql"      > N </entry>
-  				<entry align="center" namest="c5postgresql" > N </entry>
-                </row>
-                </tbody>
-              </tgroup>
-            </table>
-			<para>1 - SQLite relies on libdbi. However, it is available by 
-			default on Mac OS and Windows. Linux users may need to manually 
-			install libdbi drivers for SQLite.</para>
-			<para>2 - MySQL and PostgreSQL place data within their own storage system.</para>
-		</sect3>
+  				<entry align="center" namest="c5pgsql" > N </entry>
+			</row>
+			</tbody>
+		</tgroup>
+		</table>
 	</sect2>
 
     <sect2 id="basics-create-data">

commit 9dfd19c83e8dcf9597165995b770844967b5d638
Author: David Thomas <sunfish62 at yahoo.com>
Date:   Fri Aug 17 00:03:11 2018 -0700

    Bug 777893 - Add information to Guide about file formats, esp. SQL

diff --git a/guide/C/ch_basics.xml b/guide/C/ch_basics.xml
index a8527ef..f92ad63 100644
--- a/guide/C/ch_basics.xml
+++ b/guide/C/ch_basics.xml
@@ -619,11 +619,151 @@
 
   <sect1 id="basics-files1">
     <title>Storing your financial data</title>
-
-    <para><application>&app;</application> is able to <link linkend="basics-store-data">store</link>
-    your financial data in files or <acronym>SQL</acronym> databases so that they can be
-    <link linkend="basics-open-data">opened</link> and modified at a later time.
-    But first you need to <link linkend="basics-create-data">create</link> a container for your data.</para>
+	<sect2 id="basics-files1-overview">
+		<title>Overview</title>
+		
+		<para><application>&app;</application> offers several formats for storing 
+		your financial data. The default file storage format is <acronym>XML</acronym>, 
+		while <acronym>SQL</acronym> storage is available in SQLite, MySQL, and PostgreSQL 
+		formats. Users can choose a file format from the <menuchoice><guimenu>File</guimenu> 
+		<guimenuitem>Save </guimenuitem></menuchoice> and <menuchoice><guimenu>File</guimenu> 
+		<guimenuitem>Save As...</guimenuitem></menuchoice> dialogs.</para>
+		
+		<para>The <acronym>XML</acronym> storage format is a text file that is compressed 
+		with gzip, which is a preference that is set at <menuchoice><guimenu>Edit</guimenu> 
+		<guimenuitem>Preferences</guimenuitem></menuchoice> <guilabel>General</guilabel> 
+		<guilabel>Compress files</guilabel>. <acronym>SQL</acronym> storage is available 
+		via the <acronym>DBI</acronym> back end; use of MySQL and PostgreSQL requires 
+		installation of those <acronym>DBMS</acronym> packages as well as additional 
+		<acronym>DBI</acronym> drivers.</para>
+		
+		<note>
+		<para>Users can change the format at any time by using <menuchoice><guimenu>File</guimenu> 
+		<guimenuitem>Save As...</guimenuitem></menuchoice>. This will create a copy of 
+		the data file in the selected format.</para>
+		</note>
+		<sect3 id="basics-files-storage-comparison">
+			<title>Storage Comparison</title>
+			
+			<para>Each storage format has benefits and shortcomings that users should 
+			consider for their needs and abilities. See the Storage Comparison Table below 
+			for further details.</para>
+			
+			<para>The <acronym>XML</acronym> format is the most stable and established, 
+			and for this reason, it is recommended for most users. <acronym>SQL</acronym>
+			storage was added for the 2.4 release and has become an increasingly popular 
+			choice for users, but can require experience with <acronym>DBMS</acronym> 
+			applications.</para>
+			
+			<note>
+				<para>Use of a <acronym>SQL</acronym> back end for storage implies to many 
+				that <application>&app;</application> has fully implemented <acronym>DBMS</acronym> 
+				features, including multi-user and incremental data manipulation.  However, 
+				<application>&app;</application> does not currently implement these features, 
+				although it is a long term goal of the development team. </para>
+			</note>
+
+            <table frame="topbot" id="storage-comparison">
+              <title>Storage Comparison</title>
+
+              <tgroup align="left" cols="5">
+                <colspec colname="c1item" ></colspec>
+                <colspec colname="c2xml" ></colspec>
+                <colspec colname="c3sqlite" ></colspec>
+                <colspec colname="c4mysql" ></colspec>
+                <colspec colname="c5postgresql" ></colspec>
+
+                <thead>
+                  <row>
+                    <entry> </entry>
+                    <entry align="center">XML</entry>
+                    <entry align="center">SQLite</entry>
+                    <entry align="center">MySQL</entry>
+                    <entry align="center">PostgreSQL</entry>
+                  </row>
+                </thead>
+
+                <tbody>
+                <row>
+                  <entry >Installation</entry>
+  				<entry align="center" namest="c2xml"        > Default </entry>
+  				<entry align="center" namest="c3sqlite"     > libdbi - 1 </entry>
+  				<entry align="center" namest="c4mysql"      > libdbi </entry>
+  				<entry align="center" namest="c5postgresql" > libdbi </entry>
+                </row>
+
+                <row>
+                  <entry >File extension</entry>
+  				<entry align="center" namest="c2xml"        > gnucash </entry>
+  				<entry align="center" namest="c3sqlite"     > gnucash </entry>
+  				<entry align="center" namest="c4mysql"      > N/A - 2 </entry>
+  				<entry align="center" namest="c5postgresql" > N/A - 2 </entry>
+                </row>
+
+                <row>
+                  <entry >Additional software</entry>
+  				<entry align="center" namest="c2xml"        > None </entry>
+  				<entry align="center" namest="c3sqlite"     > None </entry>
+  				<entry align="center" namest="c4mysql"      > MySQL </entry>
+  				<entry align="center" namest="c5postgresql" > PostgreSQL </entry>
+                </row>
+
+                <row>
+                  <entry >Additional expertise</entry>
+  				<entry align="center" namest="c2xml"        > None </entry>
+  				<entry align="center" namest="c3sqlite"     > None </entry>
+  				<entry align="center" namest="c4mysql"      > DBMS </entry>
+  				<entry align="center" namest="c5postgresql" > DBMS </entry>
+                </row>
+
+                <row>
+                  <entry >Compression</entry>
+  				<entry align="center" namest="c2xml"        > Y </entry>
+  				<entry align="center" namest="c3sqlite"     > N </entry>
+  				<entry align="center" namest="c4mysql"      > N </entry>
+  				<entry align="center" namest="c5postgresql" > N </entry>
+               </row>
+
+                <row>
+                  <entry >Save on command</entry>
+  				<entry align="center" namest="c2xml"        > Y </entry>
+  				<entry align="center" namest="c3sqlite"     > N </entry>
+  				<entry align="center" namest="c4mysql"      > N </entry>
+  				<entry align="center" namest="c5postgresql" > N </entry>
+                </row>
+
+                <row>
+                  <entry >Save on commit</entry>
+  				<entry align="center" namest="c2xml"        > N </entry>
+  				<entry align="center" namest="c3sqlite"     > Y </entry>
+  				<entry align="center" namest="c4mysql"      > Y </entry>
+  				<entry align="center" namest="c5postgresql" > Y </entry>
+                </row>
+
+                <row>
+                  <entry >Uses log files</entry>
+  				<entry align="center" namest="c2xml"        > Y </entry>
+  				<entry align="center" namest="c3sqlite"     > N </entry>
+  				<entry align="center" namest="c4mysql"      > N </entry>
+  				<entry align="center" namest="c5postgresql" > N </entry>
+                </row>
+
+                <row>
+                  <entry >Multi-user</entry>
+  				<entry align="center" namest="c2xml"        > N </entry>
+  				<entry align="center" namest="c3sqlite"     > N </entry>
+  				<entry align="center" namest="c4mysql"      > N </entry>
+  				<entry align="center" namest="c5postgresql" > N </entry>
+                </row>
+                </tbody>
+              </tgroup>
+            </table>
+			<para>1 - SQLite relies on libdbi. However, it is available by 
+			default on Mac OS and Windows. Linux users may need to manually 
+			install libdbi drivers for SQLite.</para>
+			<para>2 - MySQL and PostgreSQL place data within their own storage system.</para>
+		</sect3>
+	</sect2>
 
     <sect2 id="basics-create-data">
     <title>Creating a file</title>



Summary of changes:
 guide/C/ch_basics.xml | 135 ++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 130 insertions(+), 5 deletions(-)



More information about the gnucash-changes mailing list