From 3cabf41fff04030ccb6574c9538237a0d254de8e Mon Sep 17 00:00:00 2001
From: Robert Graham Merkel <robert.merkel@benambra.org>
Date: Fri, 8 Jun 2001 06:16:04 +0000
Subject: [PATCH] More documentation updates.

git-svn-id: svn+ssh://svn.gnucash.org/repo/gnucash/trunk@4533 57a11ea4-9604-0410-9ed3-97b8803252fd
---
 ChangeLog                            |   5 ++
 doc/sgml/C/xacc-file-operations.sgml | 123 +++++++++++++++++++++++++--
 doc/sgml/C/xacc-quickstart.sgml      |   2 +-
 doc/sgml/C/xacc-regwin.sgml          |   4 +-
 4 files changed, 123 insertions(+), 11 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 2491e5687d..0366efa45c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2001-06-08  Robert Graham Merkel  <rgmerk@mira.net>
+
+	* doc/sgml/C/xacc-file-operations.sgml, xacc-quickstart.sgml, 
+	xacc-regwin.sgml: updates and corrections.
+
 2001-06-07  Dave Peticolas  <dave@krondo.com>
 
 	* src/scm/price-quotes.scm: same as below
diff --git a/doc/sgml/C/xacc-file-operations.sgml b/doc/sgml/C/xacc-file-operations.sgml
index ac79aad1fe..d444b27c14 100644
--- a/doc/sgml/C/xacc-file-operations.sgml
+++ b/doc/sgml/C/xacc-file-operations.sgml
@@ -1,12 +1,119 @@
-<article id="xacc-file-operations">
-<artheader>
-<title>File Operations</title>
-</artheader>
-<para> This isn't currently documented, but will describe saving and loading files,
-as well as backing up your data.  It will also mention the SQL interface.
-</para>
-</article>
+  <article id="xacc-file-operations">
+    <artheader>
+      <title>File Operations</title>
+    </artheader>
+    <sect1>
+      <title>
+	GnuCash Data Files
+      </title>
+      <para>In normal operation, GnuCash saves your data in normal data files,
+	which can be located in any directory you have permissions for.  They
+	are self-contained and can be moved, copied, and backed-up to tape, 
+	floppies, or any other medium you choose.
+        They can be saved using any name, and any file extension you choose, but, traditionally
+      the developers and users have used the extension ".xac".
+      </para>
 
+      <para>
+	The GnuCash file format has changed between the 1.4 and 1.6 releases.  The
+	new version uses XML (making it much easier to write independent tools to 
+	manipulate GnuCash files) and supports storing much more meta-information, amongst
+	many other benefits.  GnuCash 1.6 can read files from older versions, but
+	older versions <emphasis>cannot</emphasis>read GnuCash 1.6 files.  We suggest
+	that GnuCash users who wish to share data upgrade to 1.6.
+      </para>
+
+      <para>Gnucash <emphasis>cannot</emphasis> directly open data files from any other 
+      accounting package.  It can, however, import QIF files that Quicken, Microsoft
+      Money, and several other packages use an export format with the 
+      <link linkend="xacc-quicken">QIF importer</link>.  GnuCash does not have the 
+	ability to export QIFs at present, though such functionality would be highly
+	desirable - if anybody with some coding skills wants to work on it, please
+	contact the developers.
+      </para>
+    </sect1>
+
+    <sect1>
+      <title>
+	The File Menu
+      </title>      
+      <para>Like most applications, file operations are performed from the file menu:</para>
+ 
+      <itemizedlist>
+	<listitem><para><emphasis>New File</emphasis>: Create a brand-new, empty
+	    GnuCash file.  If you have unsaved work, GnuCash will ask you if you
+	    wish to save it.
+	    </para></listitem>
+
+	<listitem><para><emphasis>Open</emphasis>: Retrieve an existing GnuCash file.</para>
+	  </listitem>
+	<listitem><para><emphasis>Save</emphasis>: Save your current GnuCash data to disk under
+	    its current name.</para>
+	    </listitem>
+	<listitem><para><emphasis>Save as</emphasis>: Save the current data under a new 
+	    name.</listitem>
+	<listitem><para><emphasis><link linkend="xacc-export-accounts">Export Accounts</link>
+	      </emphasis>: Export your account structure, without any transactions.  Useful
+	    for making templates for others, or as a simple, but still useful way to close
+	    out books.
+	    </para></listitem>
+	<listitem>
+	  <para>
+	    <emphasis>
+	      <link linkend="xacc-quicken">Import QIF</link></emphasis>: Import QIF data
+	    files.</para></listitem>
+	<listitem>
+	  <para>
+	    <emphasis>
+	      <link linkend="xacc-new-account-tree">New Account Tree</link></emphasis>: 
+	    A shortcut
+	    to create many of the common accounts used by households.</para>
+	  </listitem>
+	<listitem><para><emphasis>Short cuts to previously opened files</emphasis>: 
+	    the previous four or so 
+	  GnuCash files you have opened will appear.  Select them to open.</listitem>
+
+	<listitem><para><emphasis>Move to New Window</emphasis>: create a new 
+	    top-level window.  See <link linkend="xacc-toplevel">here for more details.</link>
+	    </para></listitem>
+	<listitem><para><emphasis>Close This Window</emphasis>: Close <emphasis>this</emphasis>
+	    top-level window, leaving others open.  See <link linkend="xacc-toplevel">here</link> for more details.</para>
+	</listitem>
+	 <listitem><para><emphasis>Exit GnuCash</emphasis>: Close all windows and exit.
+	    GnuCash will prompt you to save the file, if there have been any changes since
+	    the last save.</para>
+	</listitem>
+      </itemizedlist>
+    </sect1>
+    <sect1 id="xacc-export-accounts">
+      <title>
+	Exporting Accounts
+      </title>
+      <para>
+	FIXME: Need content!
+	</para>
+      <para>
+	This needs to describe how to use the export accounts feature.
+      </para>
+    </sect1>
+
+    <sect1 id="xacc-postgres-backend">
+      <title>
+	Using PostGres to store your data
+      </title>
+      <para><emphasis>FIXME: Need Content!</emphasis></para>
+      <para>
+	GnuCash has beta support for using postgres, a free, powerful, 
+	mostly SQL-compliant database engine, as a data storage method
+	rather than flat files.
+      </para>
+      <para>
+	At this stage, the only documentation is in the file 
+	src/doc/engine/sql/README in the GnuCash source distribution.
+      </para>
+    </sect1>
+  </article>
+  
 
 <!-- Local variables: -->
 <!-- sgml-parent-document: "gnucash.sgml" -->
diff --git a/doc/sgml/C/xacc-quickstart.sgml b/doc/sgml/C/xacc-quickstart.sgml
index f9298b91d8..48e96dc53d 100644
--- a/doc/sgml/C/xacc-quickstart.sgml
+++ b/doc/sgml/C/xacc-quickstart.sgml
@@ -83,7 +83,7 @@
 	</para>
       </sect1>
       
-      <sect1>
+      <sect1 id="xacc-new-account-tree">
 	<title>
 	  Setting up accounts from scratch
 	</title>
diff --git a/doc/sgml/C/xacc-regwin.sgml b/doc/sgml/C/xacc-regwin.sgml
index 0aee2bb0aa..d7331b045c 100644
--- a/doc/sgml/C/xacc-regwin.sgml
+++ b/doc/sgml/C/xacc-regwin.sgml
@@ -91,7 +91,7 @@
      <screeninfo>The Account Register - Auto-Split Ledger</screeninfo>
       <mediaobject>
 	 <imageobject>
-            <imagedata fileref="image/autosplitledger" srccredit="wilddev">
+            <imagedata fileref="image/autosplitledger.png" srccredit="wilddev">
          </imageobject>
       </mediaobject>
     </screenshot>
@@ -113,7 +113,7 @@
      <screeninfo>The Account Register - Transaction Journal</screeninfo>
       <mediaobject>
         <imageobject>
-         <imagedata fileref="image/transactionjrnl" srccredit="wilddev">
+         <imagedata fileref="image/transactionjrnl.png" srccredit="wilddev">
         </imageobject>
        </mediaobject>
     </screenshot>