More documentation updates.

git-svn-id: svn+ssh://svn.gnucash.org/repo/gnucash/trunk@4533 57a11ea4-9604-0410-9ed3-97b8803252fd
This commit is contained in:
Robert Graham Merkel 2001-06-08 06:16:04 +00:00
parent 18a5741369
commit 3cabf41fff
4 changed files with 123 additions and 11 deletions

View File

@ -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

View File

@ -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" -->

View File

@ -83,7 +83,7 @@
</para>
</sect1>
<sect1>
<sect1 id="xacc-new-account-tree">
<title>
Setting up accounts from scratch
</title>

View File

@ -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>