From d575eea9b58999cd279b8fa2a639ccf263732322 Mon Sep 17 00:00:00 2001
From: gnuite <gnuite@gmail.com>
Date: Sun, 8 Mar 2009 22:07:34 +0000
Subject: [PATCH] Updated help files to reflect the database type options.

git-svn-id: svn+ssh://garage/var/lib/gforge/svnroot/maemo-mapper/trunk@245 6c538b50-5814-0410-93ad-8bdf4c0149d1
---
 data/help/en_US/maemomapper.xml    | 33 ++++++++++++++++++++++++++++--
 data/help/en_US/maemomapper.xml.in | 31 +++++++++++++++++++++++++++-
 data/help/fi_FI/maemomapper.xml    |  2 +-
 3 files changed, 62 insertions(+), 4 deletions(-)

diff --git a/data/help/en_US/maemomapper.xml b/data/help/en_US/maemomapper.xml
index 3c15c13..6882a99 100644
--- a/data/help/en_US/maemomapper.xml
+++ b/data/help/en_US/maemomapper.xml
@@ -844,7 +844,8 @@
           selected repository.
         </listitem>
         <listitem>
-          <display_text>New...</display_text> - Adds a new repository.
+          <display_text>New...</display_text> - Adds a new repository.  See
+          <ref refid="help_maemomapper_newrepo" refdoc="New Repositories"/>.
         </listitem>
         <listitem>
           <display_text>Reset...</display_text> - Resets your repository
@@ -872,6 +873,34 @@
         use of a particular repository.
       </note>
     </topic>
+    <topic>
+      <topictitle>Repository Types</topictitle>
+      <context contextUID="help_maemomapper_newrepo"/>
+      <para>
+        Over the years, Maemo Mapper has used several different types of
+        backing databases to store downloaded maps.  Currently, Maemo Mapper
+        supports two different types of backing map databases.
+      </para>
+      <list>
+        <listitem>
+          <display_text>SQLite 3 (default)</display_text> - The new default
+          backing database format since Maemo Mapper v2.6, SQLite 3 provides
+	  better reliability. It also scales somewhat better than GDBM and is
+	  not subject to file size limitations, making it the only choice for
+	  large map databases.  This is the preferred format, and should
+	  generally be used for all new databases.
+        </listitem>
+        <listitem>
+          <display_text>GDBM (legacy)</display_text> - The database format
+          of versions of Maemo Mapper prior to v2.6.  It is slightly less
+          reliable than SQLite, and GDBM files are limited to 2 gigabytes.
+          These limitations, however, allow it to perform slightly faster
+	  than SQLite for small map databases.  If you are unsatisfied with
+	  SQLite's performance in Maemo Mapper, you can take your chances with
+	  GDBM.
+        </listitem>
+      </list>
+    </topic>
     <topic>
       <topictitle>Managing Maps</topictitle>
       <context contextUID="help_maemomapper_mapman"/>
@@ -1598,7 +1627,7 @@
       <topictitle>About Maemo Mapper</topictitle>
       <context contextUID="help_maemomapper_about"/>
       <para>
-        Current Version: 2.5.3
+        Current Version: 2.6
       </para>
       <para>
         Maemo Mapper was created and developed by John Costigan (aka
diff --git a/data/help/en_US/maemomapper.xml.in b/data/help/en_US/maemomapper.xml.in
index 8b9d87d..edca102 100644
--- a/data/help/en_US/maemomapper.xml.in
+++ b/data/help/en_US/maemomapper.xml.in
@@ -844,7 +844,8 @@
           selected repository.
         </listitem>
         <listitem>
-          <display_text>New...</display_text> - Adds a new repository.
+          <display_text>New...</display_text> - Adds a new repository.  See
+          <ref refid="help_maemomapper_newrepo" refdoc="New Repositories"/>.
         </listitem>
         <listitem>
           <display_text>Reset...</display_text> - Resets your repository
@@ -872,6 +873,34 @@
         use of a particular repository.
       </note>
     </topic>
+    <topic>
+      <topictitle>Repository Types</topictitle>
+      <context contextUID="help_maemomapper_newrepo"/>
+      <para>
+        Over the years, Maemo Mapper has used several different types of
+        backing databases to store downloaded maps.  Currently, Maemo Mapper
+        supports two different types of backing map databases.
+      </para>
+      <list>
+        <listitem>
+          <display_text>SQLite 3 (default)</display_text> - The new default
+          backing database format since Maemo Mapper v2.6, SQLite 3 provides
+	  better reliability. It also scales somewhat better than GDBM and is
+	  not subject to file size limitations, making it the only choice for
+	  large map databases.  This is the preferred format, and should
+	  generally be used for all new databases.
+        </listitem>
+        <listitem>
+          <display_text>GDBM (legacy)</display_text> - The database format
+          of versions of Maemo Mapper prior to v2.6.  It is slightly less
+          reliable than SQLite, and GDBM files are limited to 2 gigabytes.
+          These limitations, however, allow it to perform slightly faster
+	  than SQLite for small map databases.  If you are unsatisfied with
+	  SQLite's performance in Maemo Mapper, you can take your chances with
+	  GDBM.
+        </listitem>
+      </list>
+    </topic>
     <topic>
       <topictitle>Managing Maps</topictitle>
       <context contextUID="help_maemomapper_mapman"/>
diff --git a/data/help/fi_FI/maemomapper.xml b/data/help/fi_FI/maemomapper.xml
index b04bf3b..e3dbbb6 100644
--- a/data/help/fi_FI/maemomapper.xml
+++ b/data/help/fi_FI/maemomapper.xml
@@ -1625,7 +1625,7 @@
       <topictitle>Tietoja ohjelmasta Maemo Mapper</topictitle>
       <context contextUID="help_maemomapper_about"/>
       <para>
-        Asennettu versio: 2.5.3
+        Asennettu versio: 2.6
       </para>
       <para>
         Maemo Mapperin on suunnitellut ja luonut John Costigan (aka
-- 
2.45.0