r22477 - gnucash-docs/branches/2.4/guide/C - [22439] Bug #672668 : Add section explaining how to migrate data.
Cristian Marchi
cmarchi at code.gnucash.org
Thu Nov 1 08:34:10 EDT 2012
Author: cmarchi
Date: 2012-11-01 08:34:10 -0400 (Thu, 01 Nov 2012)
New Revision: 22477
Trac: http://svn.gnucash.org/trac/changeset/22477
Modified:
gnucash-docs/branches/2.4/guide/C/ch_basics.xml
Log:
[22439] Bug #672668 : Add section explaining how to migrate data.
Modified: gnucash-docs/branches/2.4/guide/C/ch_basics.xml
===================================================================
--- gnucash-docs/branches/2.4/guide/C/ch_basics.xml 2012-11-01 10:35:34 UTC (rev 22476)
+++ gnucash-docs/branches/2.4/guide/C/ch_basics.xml 2012-11-01 12:34:10 UTC (rev 22477)
@@ -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