From 21ea2a62b9f0dea431f8aa02b13ff257e349e501 Mon Sep 17 00:00:00 2001
From: Yawar Amin <yawar.amin@gmail.com>
Date: Sun, 24 Oct 2010 00:58:54 -0400
Subject: [PATCH 2/5] guide: Reword paragraphs about new file extension

Mention new file extension chosen during 2.3 development. Also, two
paragraphs in the `Basics' chapter talk about the new default .gnucash file
format. Make the second refer to the first.
---
 guide/C/ch_basics.xml |   34 ++++++++++++++++++++++------------
 1 files changed, 22 insertions(+), 12 deletions(-)

diff --git a/guide/C/ch_basics.xml b/guide/C/ch_basics.xml
index 74b8146..20a1426 100644
--- a/guide/C/ch_basics.xml
+++ b/guide/C/ch_basics.xml
@@ -2086,14 +2086,21 @@
     <para>To open an existing file, select <menuchoice><guimenu>File</guimenu>
     <guimenuitem>Open</guimenuitem></menuchoice> from the menu and choose your file from the list.</para>
 
-    <para><application>&app;</application> is storing its data with the extension <filename>.gnucash</filename>.</para>
-      <note>
-        <para>The <filename>.gnucash</filename> extension was introduced with version 2.4 of <application>&app;</application>.
-        For already existing files, the extension will never be changed. So if you open an existing file named 
-        <filename>Myoldfile</filename>, that name won't be changed if the file is saved. You might use the 
-        <guimenuitem>Save As...</guimenuitem> command and give the file a new name in order to have it saved with the 
-        extension <filename>.gnucash</filename>.</para>
-      </note>
+    <sect2 id="basics-file-ext2">
+      <title>The <filename>.gnucash</filename> Extension</title>
+
+      <para><application>&app;</application> stores its data with the
+      extension <filename>.gnucash</filename>.</para>
+
+      <para>The <filename>.gnucash</filename> extension was chosen as the
+      default during development of the 2.3 unstable series of
+      <application>&app;</application>. For already existing files, the
+      extension will never be changed. So if you open an existing file
+      named <filename>Myoldfile</filename>, that name won't be changed if
+      the file is saved. You might use the <guimenuitem>Save
+      As...</guimenuitem> command and give the file a new name in order to
+      have it saved with the extension
+      <filename>.gnucash</filename>.</para>
     
     <para>If you name your <application>&app;</application> file to <filename>MyBudget</filename>, the actual file name
     will be <filename>MyBudget.gnucash</filename></para>
@@ -2102,6 +2109,7 @@
         the file name. Per the above example, it is enough to only specify
         <filename>MyBudget</filename> as the filename.</para>
       </note>
+    </sect2>
   </sect1>
 
   <sect1 id="basics-import1">
@@ -2267,10 +2275,12 @@
       name.</para>
       
       <note>
-        <para>Starting from version 2.4 <application>&app;</application> does not create anymore
-        backup files with the extension <filename>.xac</filename> but with the extension 
-        <filename>.gnucash</filename>. So if you upgrade from <application>&app;</application> version 
-        2.2.x to 2.4 you may end up with both xac and gnucash backup files in your directory.</para>
+        <para>Remember from <xref linkend="basics-file-ext2"/> that the
+        default <application>&app;</application> file extension is
+        <filename>.gnucash</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>
       </note>
     </sect2>
 
-- 
1.7.0.2