r22439 - gnucash-docs/trunk/guide/C - Bug #672668 : Add section explaining how to migrate data.

Cristian Marchi cmarchi at code.gnucash.org
Fri Oct 12 08:42:10 EDT 2012


Author: cmarchi
Date: 2012-10-12 08:42:10 -0400 (Fri, 12 Oct 2012)
New Revision: 22439
Trac: http://svn.gnucash.org/trac/changeset/22439

Modified:
   gnucash-docs/trunk/guide/C/ch_basics.xml
Log:
Bug #672668 : Add section explaining how to migrate data.

Modified: gnucash-docs/trunk/guide/C/ch_basics.xml
===================================================================
--- gnucash-docs/trunk/guide/C/ch_basics.xml	2012-10-12 12:22:39 UTC (rev 22438)
+++ gnucash-docs/trunk/guide/C/ch_basics.xml	2012-10-12 12:42:10 UTC (rev 22439)
@@ -743,7 +743,7 @@
     <title>Backing Up and Recovering Data</title>
 
     <para><application>&app;</application> creates several types of files to help ensure that your data
-    is not lost. If you look in the folder where your saved <filename>.gnucash</filename> file resides, you may see other
+    is not lost. If you look in the folder where your saved file resides, you may see other
     files generated by <application>&app;</application> with the following extensions: <filename>.gnucash</filename>,
     <filename>.log</filename>, <filename>.LCK</filename>, <filename>.LNK</filename> in the same directory 
     as your primary data file. What each of these files does is presented below.</para>
@@ -791,9 +791,10 @@
     <sect2 id="basics-backuplog2">
       <title>Log file (.log)</title>
 
-      <para>Each time you open a file in <application>&app;</application>, a <filename>.log</filename> file is created and saved
-      with the same name format as the <filename>.YYYYMMDDHHMMSS.gnucash</filename> backup files. As you make changes
-      to the open data file, the log file saves only those changes. Log files
+      <para>Each time you open and edit a file in <application>&app;</application>, 
+      <application>&app;</application> creates a log file of changes you have made to your data file. 
+      The log file uses a similar naming format as the backup files:
+      <filename>.YYYYMMDDHHMMSS.log</filename>. Log files
       are not a full backup of your data file - they simply record changes you
       have made to the data file in the current <application>&app;</application> session.</para>
 
@@ -888,24 +889,115 @@
 
    <sect2 id="migrate-financial">
      <title>Migrating financial data</title>
-     <para>Migrating <application>&app;</application> financial data is a as simple as copying the files with <filename>.gnucash</filename> 
-     extension with a file manager if you know where they are saved. If you can’t rememeber where a file is stored 
-     but you can open it directly within <application>&app;</application>, save it in the desidred path from within
+     <para>Migrating <application>&app;</application> financial data is a as simple as copying  <filename>.gnucash</filename> 
+     files with a file manager if you know where they are saved. If you can’t remember where a file is stored 
+     but you can open it directly within <application>&app;</application>, save it in the desired path from within
      <application>&app;</application>.</para>
 
-     <para>The rest are either backups or log files. It won’t do any harm to copy them too, but it’s not likely
+     <para>All other files in the folder are either backups or log files. It won’t do any harm to copy them too, but it’s not likely
      to do any good, either.</para>
    </sect2>
 
    <sect2 id="migrate-prefs">
      <title>Migrating preferences data</title>
-     <para>The paths where the <application>&app;</application> preferences files are stored may vary
-     depending on your operating system.</para>
+     <para>There are three different folders with supporting files: one for <application>&app;</application> preferences, 
+     one for reports, and one for online banking settings. Preferences are managed by
+     <application>gconf</application>, reports are managed by <application>&app;</application> 
+     itself, and online banking is managed by <application>aqbanking</application>. If you do not use online banking,
+     then you will not have this folder on your machine.</para>
+     <para>The paths where the <application>&app;</application> preferences files are stored vary
+     depending on your operating system (see <xref linkend="App-sett-loc" />, <xref linkend="Report-loc" />, and 
+     <xref linkend="OB-sett-loc" />). To back up and transfer your entire installation, you must copy
+     these folders as well.</para>
 
-     <para>On MacOSX, copy <filename class="directory">~/Library/Application Support/gnucash</filename>,
-     <filename class="directory">~/.aqbanking</filename>, and <filename class="directory">~/.gconf*</filename>.
-     These are your settings, custom reports, and what have you. If you don’t use online banking, 
-     you won’t have <filename class="directory">.aqbanking</filename>.</para>
+     
+	<table id="App-sett-loc"><title>Application Settings Locations</title>
+	<tgroup cols="2" align="left">
+  	  <thead>
+	    <row>
+  		<entry>Operating system</entry>
+		<entry>folder</entry>
+	    </row>
+	  </thead>
+	  <tbody>
+            <row>
+     	      <entry>Unix</entry>        
+     	      <entry><filename class="directory">~/.gconf/apps/gnucash</filename></entry>
+            </row>
+            <row>
+              <entry>Mac OSX</entry>
+              <entry><filename class="directory">~/.gconf/apps/gnucash</filename></entry>
+            </row>
+            <row>
+              <entry>Windows</entry>
+              <entry><filename class="directory">Documents and Settings/Username/.gconf/apps/gnucash </filename></entry>
+            </row>
+	  </tbody>
+	</tgroup>
+	</table>
+
+        <table id="Report-loc"><title>Saved Reports Locations</title>
+	<tgroup cols="2" align="left">
+  	  <thead>
+	    <row>
+  		<entry>Operating system</entry>
+		<entry>folder</entry>
+	    </row>
+	  </thead>
+	  <tbody>
+            <row>
+     	      <entry>Unix</entry>
+              <entry><filename class="directory">~/.gnucash</filename></entry>
+            </row>
+            <row>
+              <entry>Mac OSX</entry>
+              <entry><filename class="directory">~/Library/Application Support/gnucash</filename></entry>
+            </row>
+            <row>
+              <entry>Windows</entry>
+              <entry><filename class="directory">Documents and Settings/Username/.gnucash</filename></entry>
+            </row>
+	  </tbody>
+	</tgroup>
+	</table>
+
+
+	<table id="OB-sett-loc"><title>Online Banking Settings Locations</title>
+	<tgroup cols="2" align="left">
+  	  <thead>
+	    <row>
+  		<entry>Operating system</entry>
+		<entry>folder</entry>
+	    </row>
+	  </thead>
+	  <tbody>
+            <row>
+     	      <entry>Unix</entry>
+              <entry><filename class="directory">~/.aqbanking</filename></entry>
+            </row>
+            <row>
+              <entry>Mac OSX</entry>
+              <entry><filename class="directory">~/.aqbanking</filename></entry>
+            </row>
+            <row>
+              <entry>Windows</entry>
+              <entry><filename class="directory">Documents and Settings/Username/.aqbanking</filename></entry>
+            </row>  
+	  </tbody>
+	</tgroup>
+	</table>
+
+     <note>
+       <para>On Unix and Mac OSX, these folders will generally not
+       display in the file manager. You must set the file manager to show hidden files
+       and folders to see them.</para>
+     </note>
+
+     <tip>
+       <para>On Unix and Mac OSX, the <keycap>~</keycap> symbol means the 
+       <filename class="directory">home</filename> folder.</para>
+     </tip>
+
    </sect2>
 
   </sect1>



More information about the gnucash-changes mailing list