After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 635360 - Explain backup files from 2.4's point of view
Explain backup files from 2.4's point of view
Status: RESOLVED FIXED
Product: GnuCash
Classification: Other
Component: Documentation
git-master
Other Linux
: Normal enhancement
: ---
Assigned To: Yawar Amin
Yawar Amin
Depends on:
Blocks:
 
 
Reported: 2010-11-20 17:28 UTC by Geert Janssens
Modified: 2018-06-29 22:47 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
patch for bug 635360 (7.05 KB, patch)
2010-12-12 11:26 UTC, Cristian Marchi
accepted-commit_now Details | Review

Description Geert Janssens 2010-11-20 17:28:53 UTC
Guide, chapter 2.7. Not critical, but the current explanation happens from a pre-2.4 point of view, namely that files may have no extension and backup files have a .xac extension. This is the way 2.2 and earlier used to work.

In 2.4 all xml files (original file AND backup files) have the extension .gnucash.

It would be less confusing if the example showed a file and backup file with .gnucash extension and the text below explains how things are supposed to be in 2.4. This is the 2.4 documentation after all.

Then a note can be added to explain additionally how it used to be in 2.2 and how the can affect you if you upgraded from 2.2 to 2.4.
Comment 1 Cristian Marchi 2010-12-12 11:26:51 UTC
Created attachment 176273 [details] [review]
patch for bug 635360

I attach a patch for this bug. I've added the YYYYMMDDHHMMSS part to .gnucash backup file extension to avoid confusion with non-backup file. If it's too verbose I will remove it.
About the 2.2 to 2.4 upgrade case I think it can be considered enough the existing note about xac files.

Comments anyone?
Comment 2 Christian Stimming 2010-12-12 20:09:39 UTC
Comment on attachment 176273 [details] [review]
patch for bug 635360

Sounds good.
Comment 3 Geert Janssens 2010-12-13 17:54:05 UTC
I would only change two small bits:

1. The first note:
...
       <note>
-        <para><application>&app;</application> 2.4 onwards creates backup files with the extension
-         <filename>.gnucash</filename> instead of the old extension <filename>.xac</filename>. 
-         So if you upgrade from the 2.2 series to the 2.4 series, you may end up with both <filename>.xac</filename> 
-         and <filename>.gnucash</filename> backup files in your directory.</para>
+        <para><application>&app;</application> versions 2.3.15 and older create backup files with the extension
+         <filename>.YYYYMMDDHHMMSS.xac</filename>. 
+         So if you upgrade from the 2.2 series to the 2.4 series, you may end up with both <filename>.YYYYMMDDHHMMSS.xac</filename> 
+         and <filename>.YYYYMMDDHHMMSS.gnucash</filename> backup files in your directory.</para>
       </note>
...

2. The last note:
...
       <note>
-        <para><application>&app;</application> will automatically delete any <filename>.xac</filename> and <filename>.log</filename> 
-        files that are older than 30 days. You can change this behavior in the <application>&app;</application>
+        <para>By default <application>&app;</application> will automatically delete any <filename>.log</filename> and <filename>.YYYYMMDDHHMMSS.gnucash</filename>
+        backup files that are older than 30 days. You can change this behavior in the <application>&app;</application>
...

Other than that, the I'm happy with your patch.
Comment 4 Cristian Marchi 2010-12-16 20:36:06 UTC
Thanks Geert, I've added your suggested modifications and I've applied the patch.
It's ok if I close this bug?
Comment 5 Geert Janssens 2010-12-16 21:58:52 UTC
Thanks for your work. You can close the bug as far as I'm concerned.
Comment 6 John Ralls 2018-06-29 22:47:42 UTC
GnuCash bug tracking has moved to a new Bugzilla host. This bug has been copied to https://bugs.gnucash.org/show_bug.cgi?id=635360. Please update any external references or bookmarks.