Christopher Browne's doc updates.

git-svn-id: svn+ssh://svn.gnucash.org/repo/gnucash/trunk@2344 57a11ea4-9604-0410-9ed3-97b8803252fd
This commit is contained in:
Dave Peticolas 2000-05-17 07:02:14 +00:00
parent c1fa12bf8b
commit ee14e57cd0
34 changed files with 2493 additions and 2078 deletions

View File

@ -1,36 +1,41 @@
<!DOCTYPE html PUBLIC "-//IETF//DTD HTML 2.0//EN">
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<title>Importing MYM Files</title>
</head>
<body>
<h1>Managing Your Money --&gt; GnuCash</h1>
I have finally put the Perl script that allowed me to use
GnuCash up on a web site. I had a couple years of data in
Managing Your Money 2.x that I didn't want to reenter. The
script will output a single QIF file with all transactions,
accounts, and categories. (Currently only non-investment
transactions are handled.) The QIF file can be imported to
xacc-1.0.18 if a small patch is applied to QIFIO.c. The site is
I have finally put the Perl script that allowed me to use GnuCash
up on a web site. I had a couple years of data in Managing Your
Money 2.x that I didn't want to reenter. The script will output a
single QIF file with all transactions, accounts, and categories.
(Currently only non-investment transactions are handled.) The QIF
file can be imported to xacc-1.0.18 if a small patch is applied to
QIFIO.c. The site is
<p> <a href="http://www-cad.eecs.berkeley.edu/~gooch/mymdump.html">
<p><a href=
"http://www-cad.eecs.berkeley.edu/~gooch/mymdump.html">
MyMdump</a></p>
<h1>Duplicate Transactions</h1>
I also have a script that I use to remove duplicate
transactions at the QIF level. I use this script because Xacc
is very strict about duplicates (which is good) and because
editing imported transactions will cause a re-import of the
same transactions to produce duplicates. (I download the same
month's transactions from my bank several times each month, so
each downloaded QIF file--after the first--contains
transactions I have already imported. I don't want to rely on
the bank sending me the transactions in the same order or with
the same formatting.) The site is
I also have a script that I use to remove duplicate transactions at
the QIF level. I use this script because Xacc is very strict about
duplicates (which is good) and because editing imported
transactions will cause a re-import of the same transactions to
produce duplicates. (I download the same month's transactions from
my bank several times each month, so each downloaded QIF
file--after the first--contains transactions I have already
imported. I don't want to rely on the bank sending me the
transactions in the same order or with the same formatting.) The
site is
<p> <a href="http://www-cad.eecs.berkeley.edu/~gooch/qifuniq.html">
<p><a href=
"http://www-cad.eecs.berkeley.edu/~gooch/qifuniq.html">
qifuniq</a></p>
<p>I hope others find these scripts useful.</p>

File diff suppressed because it is too large Load Diff

View File

@ -2,6 +2,7 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
@ -82,14 +83,15 @@
</li>
<li><b><a href="xacc-reports.html">Reports</a>.</b> Display
or output as HTML Balance, Transaction, and Profit/Loss reports,
as well as graphical account balance tracking (requires gnuplot).</li>
or output as HTML Balance, Transaction, and Profit/Loss
reports, as well as graphical account balance tracking
(requires gnuplot).</li>
</ul>
<h2>Advanced Features</h2>
<p> GnuCash offers some features not found in simpler
accounting programs.</p>
<p>GnuCash offers some features not found in simpler accounting
programs.</p>
<ul>
<li>
@ -116,9 +118,9 @@
<b><a href="xacc-expense.html">Income/Expense Account
Types</a></b>
<p> Intuit's <a href="xacc-quicken.html"> Quicken</a>
product has what they call "categories" that are used to
track incomes and expenses. These may be used to create
<p>Intuit's <a href="xacc-quicken.html">Quicken</a> product
has what they call "categories" that are used to track
incomes and expenses. These may be used to create
Profit/Loss reports.</p>
</li>
@ -144,8 +146,8 @@
and "odd" sub-versions indicate an "experimental" stream that
seeks to add enhancement.</p>
<p> The present "experimental" stream is gnucash-1.3.x, which
is somewhat unstable.</p>
<p>The present "experimental" stream is gnucash-1.3.x, which is
somewhat unstable.</p>
<p>The latest stable release is 1.2.x; if you don't intend to
do development work, you should be using either this version,
@ -191,14 +193,13 @@
gnucash.org web site, registered the domain, got the initial
GTK/gnome code working.</dd>
<dt> <a href="mailto:rlb@cs.utexas.edu"> Rob
Browning</a></dt>
<dt><a href="mailto:rlb@cs.utexas.edu">Rob Browning</a></dt>
<dd>abused everyone for not using perl, and then after we added
perl support, dumped perl in favor of
guile/scheme support. Rob maintains the build infrastructure,
is handling the whole guile/perl extension language thing,
and is dealing with configuration and configurability.</dd>
<dd>abused everyone for not using perl, and then after we
added perl support, dumped perl in favor of guile/scheme
support. Rob maintains the build infrastructure, is handling
the whole guile/perl extension language thing, and is dealing
with configuration and configurability.</dd>
<dt><a href="mailto:peticola@cs.ucdavis.edu">Dave
Peticolas</a></dt>
@ -206,14 +207,13 @@
<dd>hacks obsessively on GnuCash. But he can stop anytime he
wants to. Really.</dd>
<dt> <a href="mailto:grib@billgribble.com"> Bill Gribble
</a></dt>
<dt><a href="mailto:grib@billgribble.com">Bill
Gribble</a></dt>
<dd>works magic. If your checks print wrong, blame him.
If you don't like the amount printed on your checks, blame him.
<dd>works magic. If your checks print wrong, blame him. If
you don't like the amount printed on your checks, blame him.
If you don't like your your bank balances, your bank, or your
life, blame him too.
</dd>
life, blame him too.</dd>
</dl>
<h2>Fixers and Patchers</h2>
@ -236,15 +236,17 @@
<dd>for attempted Java port/MoneyDance</dd>
<dt><a href="mailto:dennisb@cs.chalmers.se">Dennis
Björklund</a></dt>
Bj&ouml;rklund</a></dt>
<dd>Swedish translation</dd>
<dt> <a href="mailto:bojsen@worldnet.att.net"> Per Bojsen</a></dt>
<dt><a href="mailto:bojsen@worldnet.att.net">Per
Bojsen</a></dt>
<dd>several core dump fixes</dd>
<dt> <a href="simon.britnell@peace.com"> Simon Britnell</a></dt>
<dt><a href="simon.britnell@peace.com">Simon
Britnell</a></dt>
<dd>patch to RPM spec</dd>
@ -252,7 +254,8 @@
Browne</a></dt>
<dd>for perl stock scripts, Guile-based QIF import code, lots
of changes to English documentation, and lots of guile code</dd>
of changes to English documentation, and lots of guile
code</dd>
<dt><a href="mailto:grahamc@zeta.org.au">Graham
Chapman</a></dt>
@ -273,7 +276,8 @@
<dd>for GnoMoney and GTK port</dd>
<dt> <a href="mailto:mcondell@bbn.com"> Matthew Condell</a></dt>
<dt><a href="mailto:mcondell@bbn.com">Matthew
Condell</a></dt>
<dd>FreeBSD patch</dd>
@ -303,7 +307,8 @@
<dd>ASX support</dd>
<dt> <a href="mailto:hfiguiere@teaser.fr"> Hubert Figuiere</a></dt>
<dt><a href="mailto:hfiguiere@teaser.fr">Hubert
Figuiere</a></dt>
<dd>patch to gnc-prices</dd>
@ -321,7 +326,8 @@
<dd>for leap-year fix</dd>
<dt> <a href="mailto:grib@billgribble.com"> Bill Gribble</a></dt>
<dt><a href="mailto:grib@billgribble.com">Bill
Gribble</a></dt>
<dd>qif importation code</dd>
@ -361,7 +367,8 @@
<dd>for SuSE README file</dd>
<dt><a href="mailto:blarsen@ada-works.com"> Bryan Larsen</a></dt>
<dt><a href="mailto:blarsen@ada-works.com">Bryan
Larsen</a></dt>
<dd>guile budget report</dd>
@ -405,7 +412,8 @@
<dd>for QIF core dump fix</dd>
<dt> <a href="mailto:brent@baton.phys.lsu.edu"> Brent Neal</a></dt>
<dt><a href="mailto:brent@baton.phys.lsu.edu">Brent
Neal</a></dt>
<dd>TIAA-CREF support.</dd>
@ -418,8 +426,7 @@
<dd>web site graphics and content</dd>
<dt> <a href="mailto:mopyr@IPM.Lviv.UA"> Myroslav
Opyr</a></dt>
<dt><a href="mailto:mopyr@IPM.Lviv.UA">Myroslav Opyr</a></dt>
<dd>for misc patches</dd>
@ -451,7 +458,8 @@
<dd>for SCO Unixware and OpenServer binaries</dd>
<dt> <a href="mailto:Keith.Refson@earth.ox.ac.uk"> Keith Refson</a></dt>
<dt><a href="mailto:Keith.Refson@earth.ox.ac.uk">Keith
Refson</a></dt>
<dd>Solaris fixes</dd>
@ -488,18 +496,19 @@
<dt><a href="mailto:robby.stephenson@usa.net">Robby
Stephenson</a></dt>
<dd>register & file history patches</dd>
<dd>register &amp; file history patches</dd>
<dt><a href="mailto:tma@iis.fhg.de">Herbert Thoma</a></dt>
<dd>gnome register & euro support patches</dd>
<dd>gnome register &amp; euro support patches</dd>
<dt><a href="mailto:detrout@earthlink.net">Diane
Trout</a></dt>
<dd>scheme qif import patch</dd>
<dt> <a href="mailto:rkw@dataplex.net"> Richard Wackerbarth</a></dt>
<dt><a href="mailto:rkw@dataplex.net">Richard
Wackerbarth</a></dt>
<dd>patch to gnc-prices</dd>
@ -507,7 +516,8 @@
<dd>guile and register patches</dd>
<dt> <a href="mailto:dwmw2@infradead.org"> David Woodhouse</a></dt>
<dt><a href="mailto:dwmw2@infradead.org">David
Woodhouse</a></dt>
<dd>Great Britain translations</dd>
@ -516,10 +526,10 @@
<dd>QIF import fixes; MYM import</dd>
<dt> <a href="mailto:shimpei@gol.com"> Shimpei Yamashita</a></dt>
<dt><a href="mailto:shimpei@gol.com">Shimpei
Yamashita</a></dt>
<dd>Japanese translation</dd>
</dl>
<h2>Supported Operating Systems</h2>
@ -547,12 +557,12 @@
<p><a href="http://www.gnucash.org/"><img src=
"logos/linux.gif"></a> <a href="http://www.sco.com/skunkware">
<img src="logos/skunkware.gif"></a> <a href=
"http://www.bull.de/pub/"><img src="logos/bullogogross.gif">
<a href="http://www.ibm.com"> <img src="logos/ibm.gif"></a>
<a href="http://www.sgi.com"> <img src="logos/sgi.gif"></a>
<a href="http://www.debian.org"> <img src="logos/debian.jpg"></a>
<a href="http://www.netbsd.org"> <img src= "logos/NetBSD-banner.gif">
</p>
"http://www.bull.de/pub/"><img src="logos/bullogogross.gif"> <a
href="http://www.ibm.com"><img src="logos/ibm.gif"></a> <a
href="http://www.sgi.com"><img src="logos/sgi.gif"></a> <a
href="http://www.debian.org"><img src="logos/debian.jpg"></a>
<a href="http://www.netbsd.org"><img src=
"logos/NetBSD-banner.gif"></a></a></p>
<h2>History</h2>
The table below shows some historical lines-of-code and
@ -607,7 +617,8 @@
<td>5 files<br>
(0.4)</td>
<td>1 file<br>(0.1)</td>
<td>1 file<br>
(0.1)</td>
<td>40 files<br>
(8.8)</td>
@ -633,7 +644,8 @@
<td>9 files<br>
(0.8)</td>
<td>1 file<br>(0.1)</td>
<td>1 file<br>
(0.1)</td>
<td>61 files<br>
(16.2)</td>
@ -659,7 +671,8 @@
<td>12 files<br>
(1.4)</td>
<td>4 files<br>(0.3)</td>
<td>4 files<br>
(0.3)</td>
<td>68 files<br>
(18.3)</td>
@ -697,51 +710,98 @@
(34.7)</td>
</tr>
<tr align=center>
<td>gnucash-1.2.2<br>Aug 99
<td>41 files<br>(10.2+3.6)
<td>28 files<br>(5.5+1.7)
<td>14 files<br>(2.4+0.6)
<td>26 files<br>(8.7+0.5)
<td> -
<td>14 files<br>(1.4)
<td>30 files<br>(2.6)
<td>15 files<br>(1.8)
<td>168 files<br>(39.0)
<tr align="center">
<td>gnucash-1.2.2<br>
Aug 99</td>
<tr align=center>
<td>gnucash-1.3.6<br>April 2000
<td>41 files<br>(12.9+4.0)
<td>32 files<br>(6.8+2.1)
<td>19 files<br>(4.0+0.8)
<td> -
<td>78 files<br>(32.2+3.0)
<td>74 files<br>(17.0)
<td>33 files<br>(7.8)
<td>25 files<br>(4.5)
<td>302 files<br>(95.1)
<td>41 files<br>
(10.2+3.6)</td>
<td>28 files<br>
(5.5+1.7)</td>
<td>14 files<br>
(2.4+0.6)</td>
<td>26 files<br>
(8.7+0.5)</td>
<td>-</td>
<td>14 files<br>
(1.4)</td>
<td>30 files<br>
(2.6)</td>
<td>15 files<br>
(1.8)</td>
<td>168 files<br>
(39.0)</td>
</tr>
<tr align="center">
<td>gnucash-1.3.6<br>
April 2000</td>
<td>41 files<br>
(12.9+4.0)</td>
<td>32 files<br>
(6.8+2.1)</td>
<td>19 files<br>
(4.0+0.8)</td>
<td>-</td>
<td>78 files<br>
(32.2+3.0)</td>
<td>74 files<br>
(17.0)</td>
<td>33 files<br>
(7.8)</td>
<td>25 files<br>
(4.5)</td>
<td>302 files<br>
(95.1)</td>
</tr>
</table>
<p>Each cell displays the following:<br>
<br>
number of *c and *.h files<br>
(KLOCS in *.c + KLOCS in *.h)</p>
(unless its the scheme directories, in which case its *scm files, etc)
(unless its the scheme directories, in which case its *scm
files, etc)
<p>where KLOC == kilo-lines-of-code, as reported by <tt>
wc</tt>.</p>
<p>
<ul>
<li>engine -- contents of the src/engine and the include directories
<li>register -- contents of the register directory
<li>ledger -- *.c, *.h files in the src directory only
<li>motif -- contents of src/motif directory
<li>gnome -- src/gnome plus src/register/gnome
<li>scheme -- scheme and guile code -- src/scm plus src/guile
<li>docs -- english-only html docs (user documentation)
<li>txt -- internal README and *.txt documentation files in all subdirs
<li>engine -- contents of the src/engine and the include
directories</li>
<li>register -- contents of the register directory</li>
<li>ledger -- *.c, *.h files in the src directory only</li>
<li>motif -- contents of src/motif directory</li>
<li>gnome -- src/gnome plus src/register/gnome</li>
<li>scheme -- scheme and guile code -- src/scm plus
src/guile</li>
<li>docs -- english-only html docs (user documentation)</li>
<li>txt -- internal README and *.txt documentation files in
all subdirs</li>
</ul>
<hr>

View File

@ -1,30 +1,38 @@
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<title>Editing Account Parameters</title>
</head>
<body>
<h1>Editing Account Parameters</h1>
<p>The "Edit Account" dialog box lets you change the properties of
an account. You can access this via the "edit" button of the main
window toolbar, the "Accounts" menu, or via the keyboard
<p>The "Edit Account" dialog box lets you change the properties
of an account. You can access this via the "edit" button of the
main window toolbar, the "Accounts" menu, or via the keyboard
shortcuts. For a description of the uses of the various
properties, see the information about <a
href="xacc-accwin.html">new accounts</a>.</p>
properties, see the information about <a href=
"xacc-accwin.html">new accounts</a>.</p>
<p><b>Account information</b> can be changed by typing in the
appropriate field. The account type cannot be changed.</p>
<p>A new <b>Parent Account</b> can be selected. Only those
accounts that can legally become the parent of the present
account are shown.</p>
<p>The source for <b>Stock Quotes</b> can be selected. See <a
href="xacc-ticker.html">the ticker</a> for more
information.</p>
<p><b>Account information</b> can be changed by typing in the appropriate
field. The account type cannot be changed.</p>
<p>A new <b>Parent Account</b> can be selected. Only those accounts that
can legally become the parent of the present account are shown.</p>
<p>The source for <b>Stock Quotes</b> can be selected. See
<a href="xacc-ticker.html">the ticker</a> for more information.</p>
<p><b>Notes</b> about the account can be edited.</p>
<hr>
<hr><p> Return to <a href="xacc-main.html"> Main Documentation
<p>Return to <a href="xacc-main.html">Main Documentation
Page.</a></p>
</body>
</html>

View File

@ -11,9 +11,11 @@
<body>
<h1>Account Types</h1>
GnuCash supports a number of different account types. You should always
choose the type that is appropriate for what you want to record. If
you're not sure, the explanations below should help you decide.
<P> GnuCash supports a number of different account types. You should
always choose the type that is appropriate for what you want to
record. If you're not sure, the explanations below should help you
decide.
<dl>
<dt><b>Cash</b></dt>
@ -27,7 +29,7 @@ you're not sure, the explanations below should help you decide.
<dd>The <b>Bank</b> account type denotes a savings or
checking account held at a bank or other financial
institution.
Such accounts sometimes bear interest.
<dd> Such accounts sometimes bear interest.
<dt><b>Credit</b></dt>
@ -37,7 +39,6 @@ you're not sure, the explanations below should help you decide.
American Express that do <em> not</em> permit you to maintain
continuing balances.</dd>
<p>
<dd>The introduction of <a href=
"http://www.visa.com/pd/debit/checkcard.html"> Check
Cards</a> where payments are withdrawn directly from a
@ -47,6 +48,9 @@ you're not sure, the explanations below should help you decide.
such an account, not really involving any granting of
credit.</dd>
<DD> Note the ambiguity of AMEX and Check Cards. This shows that
deciding where to put accounts is not an exact science.
<dt><b>Asset, Liability</b></dt>
<dd><b>Asset</b> and <b>Liability</b> accounts are used for
@ -121,12 +125,12 @@ you're not sure, the explanations below should help you decide.
<dd><b> Income</b> and <b>Expense</b> account types are used to
record income and expenses.
For example, if you deposit a paycheck in your bank account, you
<DD> For example, if you deposit a paycheck in your bank account, you
should mark it as a transfer from an 'income' account type.
Marking income in this way helps balance the books: the change in your
<dd> Marking income in this way helps balance the books: the change in your
net worth in the course of a few ekks, a few months, or a year, should
exactly equal your income (minus expenses) for the same period.
The value stored in the bank account contributes to your 'net worth';
<DD> The value stored in the bank account contributes to your 'net worth';
whereas the income contributes to your 'profits'.
</dd>
@ -135,15 +139,23 @@ whereas the income contributes to your 'profits'.
<dd><b>Equity</b> accounts are used to
store the opening balances when you first start using GnuCash
(or start a new accounting period). Assuming that you've had a bank
(or start a new accounting period).
<dd>Assuming that you've had a bank
account far longer than you've been using GnuCash, and assuming you
don't want to type in old transactions, you will want to type in a
non-zero 'opening balance' into your bank account. This opening balance
non-zero <b> opening balance </b> into your bank account. This opening balance
should be marked as a transfer from an account of type 'equity'.
Alternately, if you close and reopen all your books at the end of every
<DD> Alternately, if you close and reopen all your books at the end of every
quarter/year, the 'equity' will be your net-worth at the begining of the
period: it equal all assets minus all liabilities. As time passes by,
you will have both income and expenses. At the end of the year, your net
period: it equal all assets minus all liabilities.
<DD> As time goes by,
you will have both income and expenses.
<DD At the end of the year, your net
worth will be the equity at the begining of the year, plus all income
minus all expense. This value will become, of course, the equity for
the next accounting period.

View File

@ -2,6 +2,8 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<title></title>
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
@ -21,11 +23,11 @@
<p>The <b>Currency</b> field should typically be a <a href=
"xacc-currency.html#ISOCURR">three-letter ISO currency code</a>
(<em>e.g.</em> - <tt> USD</tt> for U.S. Dollars). The <b>
Account Code</b> is a number that determines the <a href=
"xacc-groups.html#SORTORDER"> sort order</a> of the account
when it appears in a report or in the <a href=
"xacc-groups.html"><b>Chart of Accounts</b></a>.</p>
(<em>e.g.</em> - <tt>USD</tt> for U.S. Dollars). The <b>Account
Code</b> is a number that determines the <a href=
"xacc-groups.html#SORTORDER">sort order</a> of the account when
it appears in a report or in the <a href="xacc-groups.html"><b>
Chart of Accounts</b></a>.</p>
<p>The picture below shows an example for a stock or currency
trading account. Note that the Security field is not grayed

View File

@ -2,6 +2,8 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<title></title>
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">

View File

@ -2,6 +2,7 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
@ -12,15 +13,18 @@
<h1>Accounts Payable and Accounts Receivable</h1>
<p>A/R (Accounts Receivable) and A/P (Accounts Payable) are
advanced concepts that are used by businesses to record sales for which
they are not paid right away, or to record bills that they've received,
but might not pay until a little while later. These types of accounts
primarily when you've got a lot of bills and receipts flowing in and
out, and don't want to loose track of them just because you don't
pay/get paid right away. For almost all home users, A/R and A/P
are too complicated and confusing to be worth the effort.
advanced concepts that are used by businesses to record sales
for which they are not paid right away, or to record bills that
they have received, but might not pay until a little while
later.</p>
</p>
<p>These types of accounts are used primarily when you've got a
lot of bills and receipts flowing in and out, and don't want to
loose track of them just because you don't pay/get paid right
away.</p>
<p>For almost all home users, A/R and A/P are too complicated
and confusing to be worth the effort.</p>
<h1>Accounts Receivable</h1>
@ -49,8 +53,8 @@ are too complicated and confusing to be worth the effort.
based on cash changing hands, but rather based on <em>
establishing obligations.</em></p>
<p> In more sophisticated operations, there may be a much
larger sequence of documents generated and tracked:</p>
<p>In more sophisticated operations, there may be a much more
complex sequence of documents generated and tracked:</p>
<ul>
<li>A customer sends in a <b>Purchase Order</b>, thus
@ -66,6 +70,11 @@ are too complicated and confusing to be worth the effort.
the <em>request to pay</em></li>
</ul>
<p>The fact of there being four documents leads to there being
considerable wads of paper, and having these and other such
processes explains why large organizations tend to have hefty
bureaucracies.</p>
<p>We report sales in our sales figures as soon as we make
them. Unfortunately, we may wind up selling some product to
no-good shady operators that we didn't know were shady, and
@ -121,21 +130,21 @@ are too complicated and confusing to be worth the effort.
companies tend to prefer to specifically track the amount that
they're losing to bad customers.</p>
<p> <em> Warning: <b> Advanced Accounting Concept.</b> Bad Debt
is an example of a "contra-account." That doesn't refer to <b>
<p><em>Warning: <b>Advanced Accounting Concept.</b> Bad Debt is
an example of a "contra-account." That doesn't refer to <b>
amounts paid to Nicaraguan rebels,</b> but rather the notion
that the account is an income account that is expected to hold
a balance opposite to what is normally expected, to be
counteract the balance in another income account. <a href=
"xacc-apprdepr.html#depr"> Accumulated Depreciation,</a> used
to diminish the value of an asset over time, is another example
of a contra-account.</em></p>
"xacc-apprdepr.html#depr">Accumulated Depreciation,</a> used to
diminish the value of an asset over time, is another example of
a contra-account.</em></p>
<h1>Accounts Payable</h1>
<p> The scenario for Accounts Receivable, reversed, reflects
how Accounts Payables work; just switch customer with supplier,
and see how the roles reverse.</p>
<p>The scenario for Accounts Receivable, reversed, reflects how
Accounts Payables work; just switch customer with supplier, and
watch the roles reverse.</p>
<ul>
<li>If we buy materials "on account," accrual accounting
@ -163,15 +172,14 @@ are too complicated and confusing to be worth the effort.
Rent</b> for the amount paid that is a <em>Credit</em> to
<b>Cash.</b>
<p> While this puts an unfortunate dent in the Cash
account, it <em> does</em> show on the books as an asset,
and there are no more payments to make for the next six
months.</p>
<p>While this puts an unfortunate dent in the Cash account,
it <em>does</em> show on the books as an asset, and there
are no more payments to make for the next six months.</p>
</li>
<li>Each month, the balance in <b>Prepaid Rent</b> would be
down via <em> Debit</em> <b> Rent Expense</b>, <em>
Credit</em> <b> Prepaid Rent</b>.</li>
down via <em>Debit</em> <b>Rent Expense</b>, <em>Credit</em>
<b>Prepaid Rent</b>.</li>
</ul>
<p>Similarly, companies collect payroll taxes on behalf of
@ -184,9 +192,8 @@ are too complicated and confusing to be worth the effort.
Taxes Payable</b>, on the other side.</li>
<li>When the quarterly check to the Government so that they
can make <em> their</em> payroll, <b> Payroll Taxes
Payable</b> drops as does the balance in the <b>Checking
Account</b>.<br>
can make <em>their</em> payroll, <b>Payroll Taxes Payable</b>
drops as does the balance in the <b>Checking Account</b>.<br>
<br>
</li>
</ul>

View File

@ -2,6 +2,7 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
@ -23,8 +24,8 @@
of the underlying ideas to help you apply your "favorite"
tax/depreciation policies.</em></p>
<p> Note that appreciation and depreciation of assets tend to
be treated somewhat differently:</p>
<p>Note that appreciation and depreciation of assets tend to be
treated somewhat differently:</p>
<ul>
<li>
@ -33,20 +34,19 @@
expense on an ongoing basis, gradually reducing the value
of an asset towards zero.
<p> Depreciation tends to only get calculated on assets
that are used for professional or business purposes, because
governments
don't generally allow you to claim depreciation deductions
on personal assets, and it's pointless to bother with the
procedure if it's not deductible. </p>
<p>Depreciation tends to only get calculated on assets that
are used for professional or business purposes, because
governments don't generally allow you to claim depreciation
deductions on personal assets, and it's pointless to bother
with the procedure if it's not deductible.</p>
</li>
<li>
In contrast, <a href="#appr"> Capital Gains,</a> which
could be called <em>asset value appreciation,</em> are
typically <em> not</em> recognized until some time down the
road when the asset is sold, and at that <em> instant,</em>
the entire gain becomes income.
In contrast, <a href="#appr">Capital Gains,</a> which could
be called <em>asset value appreciation,</em> are typically
<em>not</em> recognized until some time down the road when
the asset is sold, and at that <em>instant,</em> the entire
gain becomes income.
<p>Unlike depreciation, governments tend to be <em>quite
interested</em> in taxing capital gains in one manner or
@ -65,10 +65,10 @@
<h1>Capital Gains - Asset Appreciation</h1>
<a name="appr"></a>
<p>Appreciation of assets is, in general, a fairly tricky matter
to deal with. This is so because, for some sorts of assets, it
is difficult to correctly estimate an increase in value <em>
until you actually sell the asset.</em></p>
<p>Appreciation of assets is, in general, a fairly tricky
matter to deal with. This is so because, for some sorts of
assets, it is difficult to correctly estimate an increase in
value <em>until you actually sell the asset.</em></p>
<p>If you invest in <a href="xacc-ticker.html">securities</a>
that are traded on a daily basis on open markets such as stock
@ -83,9 +83,9 @@
used automobile involves a negotiation process that makes
pricing a bit less predictable.</p>
<p> Harder to estimate are values of collectible objects such
as jewelry, works of art, baseball cards, and "Beanie Babies."
The markets for such objects are somewhat less open than the
<p>Harder to estimate are values of collectible objects such as
jewelry, works of art, baseball cards, and "Beanie Babies." The
markets for such objects are somewhat less open than the
securities markets.</p>
<p>Worse still are one-of-a-kind assets. Factories often
@ -123,8 +123,8 @@
</ul>
<p>The <em>accrued gains</em> likely won't affect your taxable
income for <em> income</em> tax purposes, although it could
have some effect on <em> property</em> taxes.</p>
income for <em>income</em> tax purposes, although it could have
some effect on <em>property</em> taxes.</p>
<h2>The handling of capital gains in GnuCash</h2>
@ -264,9 +264,9 @@
<li>
You were over-optimistic about the value of the painting.
<p> Instead of the $16055 you thought the painting was
worth are only offered $15000. But you still decide to
sell, because you value $15000 more than you value the
<p>Instead of the $16055 you thought the painting was worth
are only offered $15000. But you still decide to sell,
because you value $15000 more than you value the
painting.</p>
<p>The numbers change a little bit, but not too
@ -402,8 +402,8 @@
money, any numbers on paper (or magnetic patterns on your
hard disk) are merely that.</p>
<p> If you could realistically convince a banker to lend
you money, using the assets as collateral, that is a pretty
<p>If you could realistically convince a banker to lend you
money, using the assets as collateral, that is a pretty
reasonable evidence that the assets have value, as lenders
are professionally suspicious of dubious overestimations of
value.</p>
@ -417,8 +417,8 @@
<h2>Taxation of Capital Gains</h2>
<p> Taxation policies vary considerably between countries, so
it is virtually impossible to say anything that will be
<p>Taxation policies vary considerably between countries, so it
is virtually impossible to say anything that will be
universally useful.</p>
<p>However, it is <em>common</em> for income generated by
@ -432,13 +432,13 @@
authorities, for example, tax those gains only if you owned the
property for less than ten years.</p>
<p> <a href="mailto:cbbrowne@hex.net"> I have</a> one story
from my professional tax preparation days where a family sold a
<p><a href="mailto:cbbrowne@hex.net">I have</a> one story from
my professional tax preparation days where a family sold a
farm, and expected a <em>considerable</em> tax bill that turned
out to be virtually nil due to having owned the property before
1971 (wherein lies a critical "Valuation Day" date in Canada)
and due to it being a <em> dairy</em> farm, with some <em>
really peculiar</em> resulting deductions.</p>
and due to it being a <em>dairy</em> farm, with some <em>really
peculiar</em> resulting deductions.</p>
<p>In short, this presentation is fairly simple, but taxation
often gets terribly complicated...</p>
@ -464,11 +464,10 @@
direction, on some of the more common depreciation calculation
schemes.</p>
<p> While there has been some discussion about how to
accomplish automated calculation and creation of transactions
to handle things like depreciation, there is not yet any
working code, so for now, you will have to do calculations by
hand.</p>
<p>While there has been some discussion about how to accomplish
automated calculation and creation of transactions to handle
things like depreciation, there is not yet any working code, so
for now, you will have to do calculations by hand.</p>
<h2>Depreciation schemes</h2>
@ -544,11 +543,10 @@
the end that is larger than zero ( <em>i.e.</em> - a resale
value).</p>
<p> <em> Beware: Tax authorities may require (or allow) a
larger percentage in the first period.</em> On the other hand,
in Canada, this is reversed, as they permit only a <em>
half</em> share of "Capital Cost Allowance" in the first
year.</p>
<p><em>Beware: Tax authorities may require (or allow) a larger
percentage in the first period.</em> On the other hand, in
Canada, this is reversed, as they permit only a <em>half</em>
share of "Capital Cost Allowance" in the first year.</p>
<p>The result of this approach is that asset value decreases
more rapidly at the beginning than at the end which is <em>
@ -703,11 +701,12 @@
<h2>A word of caution</h2>
<p>Since depreciation and tax issues are closely related, you
may not always be free in choosing your preferred method. Fixing
wrong calculations will cost a whole lot more time and trouble
than getting the calculations right the first time, so if you
plan to depreciate assets, it is wise to make sure of the
schemes you will be permitted <em> or required</em> to use.</p>
may not always be free in choosing your preferred method.
Fixing wrong calculations will cost a whole lot more time and
trouble than getting the calculations right the first time, so
if you plan to depreciate assets, it is wise to make sure of
the schemes you will be permitted <em>or required</em> to
use.</p>
<p>Return to <a href="xacc-main.html">Main Documentation
Page.</a></p>

View File

@ -1,17 +1,22 @@
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
<title>Balance Tracking Report</title>
</head>
<body>
<h1>Balance Tracking Report</h1>
<p><em>FIXME: Document this report!</em>
<p><em>FIXME: Document this report!</em></p>
<hr>
<p>Return to <a href="xacc-main.html">Main Documentation
Page.</a></p>
</body>
</html>

View File

@ -1,21 +1,26 @@
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
<title>Balance Sheet</title>
</head>
<body>
<h1>Balance Sheet</h1>
<p>This report summarizes your assets, liabilities, and equity.</p>
<p>This report summarizes your assets, liabilities, and
equity.</p>
<p>There are currently no options for this report, but the option
to specify a date for which the balance sheet is to be calculated
will be added soon.</p>
<p>There are currently no options for this report, but the
option to specify a date for which the balance sheet is to be
calculated will be added soon.</p>
<p>Return to <a href="xacc-main.html">Main Documentation
Page.</a></p>
</body>
</html>

View File

@ -2,6 +2,8 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<title></title>
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
@ -55,10 +57,10 @@
</ul>
<p>The engine links together all three of these values <tt>
(1.0, 150, 0.00667)</tt> permanently and makes it impossible
to change one without changing another, so that the grand total
is always zero, thereby guaranteeing satisfaction of the <a
href="xacc-double.html#IDENTITY"> double entry accounting
(1.0, 150, 0.00667)</tt> permanently and makes it impossible to
change one without changing another, so that the grand total is
always zero, thereby guaranteeing satisfaction of the <a href=
"xacc-double.html#IDENTITY">double entry accounting
identity.</a></p>
<h1>ISO Currency Codes</h1>

View File

@ -2,6 +2,8 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<title></title>
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">

View File

@ -2,6 +2,8 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<title></title>
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
@ -11,13 +13,15 @@
<body>
<h1>Why Use Double Entry Accounting?</h1>
<p>If you are a beginner, a novice, you need double entry accounting
to help you avoid beginner mistakes. It will keep you from creating
an unauditable mess. It will make your life easier, and it will make
this software easier to understand and to use.
And if you are an experienced accountant, then you would only turn ill
at the thought of life without it.
<p>If you are a novice to accounting, you <em>need</em> double
entry accounting to help you keep your accounts straight. It
will keep you from creating an unverifiable mess. It will make
your life easier, and it will make this software easier to
understand and to use.</p>
<p>And if you are an experienced accountant, you would likely
feel <em>ill</em> at the thought of life without it.</p>
<h1>What is Double Entry Accounting?</h1>
@ -48,17 +52,20 @@ at the thought of life without it.
in the other. This is effectively the "rule" of double entry
accounting; if you add something in to one account, you <em>
have</em> to have another component to that transaction to
balance this.</p>
balance it.</p>
<p><b>Not-quite-an-aside:</b> If you look at your bank
statements, they are typically written up from the <b>
bank's</b> perspective, which is exactly <em>opposite</em> to
yours. For instance, when you put money in, establishing a
deposit, this establishes a <b>DEBT</b> on their part.</p>
As a result, "newcomers to accounting," who only see the terms
"Debit" and "Credit" on statements from their bank seem to get
fairly confused about this.
<p> The perhaps less obvious extension is the notion that
double entry can be used to represent income and expenses as
well as bank transfers. See the <a href="xacc-expense.html">
<p>The perhaps less obvious extension is the notion that double
entry can be used to represent income and expenses as well as
bank transfers. See the <a href="xacc-expense.html">
Income/Expense</a> page for a more detailed discussion of
that.</p>
@ -72,12 +79,13 @@ at the thought of life without it.
call this <em>double</em>-entry bookkeeping; it would be
somewhat more accurate to call it <em>multiple-</em>entry
bookkeeping. Unfortunately, there's 700 years of history of use
of the term, which sufficiently discourages changing it. (And
some people think that UNIX has some crufty old bits of
oddness. Hah!)</p>
of the term, which sufficiently discourages changing it. (To
think some newcomers to UNIX think that it has some crufty old
bits of oddness. Hah! We've got UNIX beat by the better part of
a millennium!)</p>
<p> GnuCash treats "Debits" as positive values, and "Credits"
as negative values, so that this identity simplifies to <tt>
<p>GnuCash treats "Debits" as positive values, and "Credits" as
negative values, so that this identity simplifies to <tt>
value<sub>1</sub> + value<sub>2</sub> + value<sub>3</sub> + ...
= 0</tt></p>
@ -127,7 +135,7 @@ at the thought of life without it.
<h1>Scrubbing Clean</h1>
<p> GnuCash can be configured to be strict about double entry,
<p>GnuCash may be configured to be strict about double entry,
or you may configure it to be "loose."</p>
<p>In "loose" mode, you can create <em>unbalanced
@ -138,24 +146,33 @@ at the thought of life without it.
<ul>
<li>If you aren't sure of what you're doing, you likely do
not want to discard the validation of <b> double entry,</b>
as this helps you keep your accounts balanced even when
you're not perfectly clear on this.</li>
not want to discard the validation of <b>double entry,</b> as
this helps you keep your accounts balanced even when you're
not perfectly clear on this.</li>
<li>If you are an <em>accounting whiz,</em> you'll know that
it's <em> really important</em> to keep things in balance,
and again will prefer <b> double entry.</b></li>
it's <em>really important</em> to keep things in balance, and
again will prefer <b>double entry.</b></li>
</ul>
<p>But if you decide to "outsmart the system," and have a
number of unbalanced transactions, you'll probably want to
clean this up at some point. To clean up these unbalanced
transactions, you <b>Scrub</b> the account clean by choosing
<tt>Scrub</tt> from the window menu. This will examine each
transaction; if the transaction doesn't balance, a split entry
will be created and placed into an account named <b>
Unbalanced.</b> You may then review these splits and move them
to their proper accounts.</p>
<tt>Scrub</tt> from the window menu.</p>
<p>The process will examine each transaction; if the
transaction doesn't balance, a split entry will be created and
placed into an account named <b>Unbalanced.</b> You may then
review these splits and move them to their proper accounts.</p>
<p><b>Warning: Functionality Changing...</b></p>
<p>At present, control over whether GnuCash is "strict" or
"loose" is established at compile time, and defaults to <b>
strict.</b></p>
<p>In the future, there will be no option of "looseness."</p>
<hr>
<p>Return to <a href="xacc-main.html">Main Documentation

View File

@ -2,6 +2,8 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<title></title>
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
@ -19,31 +21,34 @@
currency - the euro. These countries locked the exchange rates
of their national currencies to the euro and are sharing the
new currency.</p>
<p>However, euro notes and coins will not be available until
January 1, 2001. Until then, the old national currency notes
and coins (French francs, Deutschmarks etc) will continue to
circulate. But in law they are part of the euro. Their value
in euro is completely fixed. All kinds of cashless monetary
circulate. But in law they are part of the euro. Their value in
euro is completely fixed. All kinds of cashless monetary
transactions like cheques or wire transfers are possible in
euro</p>
<p>You can find more information about the euro at:
<a href="http://europa.eu.int/euro"> http://europa.eu.int/euro
</a>.</p>
<p>You can find more information about the euro at: <a href=
"http://europa.eu.int/euro">http://europa.eu.int/euro</a> .</p>
<h2>EMU Member Countries and Exchange Rates</h2>
<a name="euro_iso_curr"></a>
<p>The following table shows the EMU member countries and
the respective exchange rates of the euro to the old national
currencies. More countries are expected to join the EMU later.</p>
<p>The following table shows the EMU member countries and the
respective exchange rates of the euro to the old national
currencies. More countries are expected to join the EMU
later.</p>
<table border="1">
<tr>
<th>Country</th>
<th>ISO Code</th>
<th>Full Description</th>
<th>Exchange Rate</th>
</tr>
@ -54,78 +59,111 @@
<tr>
<td>Austria</td>
<td>ATS</th>
<td>ATS</td>
<td>Austrian Schilling</td>
<td>1 euro = 13.7603 S</td>
</tr>
<tr>
<td>Belgium</td>
<td>BEF</th>
<td>BEF</td>
<td>Belgian Franc</td>
<td>1 euro = 40.3399 bfrs</td>
</tr>
<tr>
<td>Finland</td>
<td>FIM</th>
<td>FIM</td>
<td>Finnish Mark</td>
<td>1 euro = 5.94573 Fmk</td>
</tr>
<tr>
<td>France</td>
<td>FRF</th>
<td>FRF</td>
<td>French Franc</td>
<td>1 euro = 6.55957 FF</td>
</tr>
<tr>
<td>Germany</td>
<td>DEM</th>
<td>DEM</td>
<td>German Mark</td>
<td>1 euro = 1.95538 DM</td>
</tr>
<tr>
<td>Ireland</td>
<td>IEP</th>
<td>IEP</td>
<td>Irish Pound</td>
<td>1 euro = 0.787564 Ir. &pound;</td>
</tr>
<tr>
<td>Italy</td>
<td>ITL</th>
<td>ITL</td>
<td>Italian Lira</td>
<td>1 euro = 1936.27 Lit</td>
</tr>
<tr>
<td>Luxembourg</td>
<td>LUF</th>
<td>LUF</td>
<td>Luxembourgian Franc</td>
<td>1 euro = 40.3399 lfrs</td>
</tr>
<tr>
<td>Netherlands</td>
<td>NLG</th>
<td>NLG</td>
<td>Dutch Guilder</td>
<td>1 euro = 2.20371 hfl</td>
</tr>
<tr>
<td>Portugal</td>
<td>PTE</th>
<td>PTE</td>
<td>Portuguese Escudo</td>
<td>1 euro = 200.482 Esc</td>
</tr>
<tr>
<td>Spain</td>
<td>ESP</th>
<td>ESP</td>
<td>Spanish Peseta</td>
<td>1 euro = 166.386 Ptas</td>
</tr>
</table>
@ -134,9 +172,9 @@
<p>You can enable euro support in GnuCash in the international
category of the <a href="xacc-globalprefs.html">preferences</a>
dialog box. If your system locale specifies one of the
<a href="#euro_iso_curr">EMU member currencies</a>, euro support
is enabled by default.</p>
dialog box. If your system locale specifies one of the <a href=
"#euro_iso_curr">EMU member currencies</a>, euro support is
enabled by default.</p>
<p>FIXME: Actual documentation with screenshots and so on</p>
@ -144,3 +182,4 @@
Page.</a></p>
</body>
</html>

View File

@ -1,6 +1,8 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
@ -27,11 +29,11 @@
recognize a $100,000 sale <em>at the moment I and the customer
shake hands on the deal.</em></p>
<p> Since the money hasn't come in, the sale has to be
estimated in other way; the way this is done is to <b>
accrue</b> a sale at that time, and in making the transaction
balance, rather than adding something in to cash, I'd add the
$100,000 sale to <b> Accounts Receivable.</b></p>
<p>Since the money hasn't come in, the sale has to be estimated
in other way; the way this is done is to <b>accrue</b> a sale
at that time, and in making the transaction balance, rather
than adding something in to cash, I'd add the $100,000 sale to
<b>Accounts Receivable.</b></p>
<p>In a double entry system, two kinds of accounts must be
created: some of type "Income" and others of type "Expense."
@ -44,13 +46,12 @@
expenses are recorded as transfers from a credit card account
(or, in general, a liability account).</p>
<p> Another way of describing the requirement for "double
entry" is that when you receive an income, two things
happen:</p>
<p>Another way of describing the requirement for "double entry"
is that when you receive an income, two things happen:</p>
<ul>
<li>You receive a sum of <em> money,</em> and must record
that effect on your bank account.</li>
<li>You receive a sum of <em>money,</em> and must record that
effect on your bank account.</li>
<li>You have received an income, and must record that effect
on an income account.</li>
@ -150,9 +151,9 @@
necessary in order for the <a href="xacc-double.html#IDENTITY">
double-entry bookkeeping identity to hold true.</a></p>
<p> Another way in which income and expense accounts are
special is that their account totals do not directly appear on
a balance sheet. A balance sheet shows "Net Worth": the sum of
<p>Another way in which income and expense accounts are special
is that their account totals do not directly appear on a
balance sheet. A balance sheet shows "Net Worth": the sum of
all assets minus all liabilities.</p>
<p>Income and expenses are neither assets nor liabilities, and
@ -166,11 +167,11 @@
neither income or expenses, <em>they</em> correspondingly do
not appear on a P&amp;L statement.</p>
<p> Even though these accounts may be somewhat "special", you
do not need to do anything particularly special to use income
and expense accounts. GnuCash handles the values automatically,
so that if you record properly the effects of the transactions
on your bank account or credit card, the income/expense side of
<p>Even though these accounts may be somewhat "special", you do
not need to do anything particularly special to use income and
expense accounts. GnuCash handles the values automatically, so
that if you record properly the effects of the transactions on
your bank account or credit card, the income/expense side of
the transaction should also be handled correctly.</p>
<p>The time when things get "peculiar," and when you need to
@ -181,25 +182,25 @@
<h1>Using Income/Expense Accounts</h1>
<p> To use an income/expense account, simply create one from
the "New Account" dialogue window, and then be sure to transfer
<p>To use an income/expense account, simply create one from the
"New Account" dialogue window, and then be sure to transfer
income/expenses to it as you record paychecks, interest,
etc.</p>
<p>You will doubtless wish to create quite a number of income
and expense accounts; it may be worth looking at the <a href=
"xacc-groups.html#SAMPLECHART"> Sample Chart of Accounts</a>
for ideas.</p>
"xacc-groups.html#SAMPLECHART">Sample Chart of Accounts</a> for
ideas.</p>
<p> This partitioning of incomes and expenses is likely to
prove particularly useful for North Americans when <i>income
tax time</i> rolls around.</p>
<p>This partitioning of incomes and expenses is likely to prove
particularly useful for North Americans when <i>income tax
time</i> rolls around.</p>
<h1>Use of Terminology In Other Software</h1>
<p>If you have used other personal finance software, be aware
that <a href="xacc-quicken.html#QUICKENCATS"> Quicken calls
them "Categories."</a></p>
that <a href="xacc-quicken.html#QUICKENCATS">Quicken calls them
"Categories."</a></p>
<hr>
<p>Return to <a href="xacc-main.html">Main Documentation

View File

@ -33,30 +33,46 @@
<a name="overview"><h2>Overview</h2></a>
<p>The Find Transactions dialog allows you to search for
transactions which match criteria that you specify, including
account(s) affected by the transaction, the value of the transaction,
the date, the memo, the description, etc. You can bring up the Find
Transactions dialog by clicking on the "Find" button in the main
GnuCash window or any register display window. The results of your
search will be shown in a register display similar to the ones used to
display your accounts, with the window title "Search Results".
transactions which match criteria that you specify, including:
<ul>
<li> Account(s) affected by the transaction,
<li> Value of the transaction,
<li> Date
<li> Memo field
<li> Transaction description
<ul>
etc.
<P> You may bring up the <b> Find Transactions </b> dialog by clicking
on the "Find" button in the main GnuCash window or any register
display window.
<P> The results of your search will be shown in a register display
similar to the ones used to display your accounts, with the window
title "Search Results".
<p>Clicking the "Find" button again within a Search Results
register window allows you to add additional terms to the query whose
results are displayed in that window. By combining multiple searches,
you can create very sophisticated queries to show you exactly the
results are displayed in that window. <P> By combining multiple searches,
you may construct rather sophisticated queries to display exactly the
subset of your transactions that you want to see.
<a href="#toc">Table of Contents</a>
<a name="how-to"><h2>How to use the Find Transactions dialog</h2></a>
<p>The Find Transactions dialog has two main parts. The upper
<p>The Find Transactions dialog has two main parts.
<ul>
<li> The upper
part of the dialog is a Notebook with tabs that allow you to specify
the conditions of your search. See <a href="#setup">Setting up a
search</a> for details on each search type. The lower part of the
the conditions of your search. <p> See <a href="#setup">Setting up a
search</a> for details on each search type.
<li>The lower part of the
dialog is a selector which allows you to specify how the results of
the search are to be combined with any previous search.
</uL>
<p>If you get the Find Transactions dialog by clicking the Find
button in the main GnuCash window or any normal account display
@ -107,9 +123,9 @@ accounts is to be displayed.
<p>If you select "All" accounts from the picker at the top of the
tab, the only transactions that will be show are those which affect
all the selected accounts. For example, if you select "My Checking
Account" and "My VISA Account" and then choose "All", only transfers
from Checking to Visa will be shown.
all the selected accounts. <P> For example, if you select <b>My
Checking Account<b> and <b> My VISA Account</b> and then choose <B>
All</b>, only transfers from Checking to Visa will be shown.
<p>If you select "Any" from the picker, transactions affecting any
selected amount will be shown. For example, if you select "My
@ -121,15 +137,15 @@ together in the Search Results window.
<p>In the Date tab, you can specify a date range for the
transactions you wish to find. The year, month, and day fields are in
the order you specify in Preferences:International:Date Format.
the order you specify in <tt> Preferences:International:Date Format</tt>.
<p>If you want to locate any transaction before a certain date,
specify your date in the second date entry and put a very early date
in the first date entry. The default date is January 1, 1900, which
should be early enough for most purposes. Similarly, if you want to
find any transaction after a certain date, put the date in the first
date entry and put a date after your last transaction in the second
entry.
specify your date in the second date entry and put a distant date in
the past in the first date entry. The default date is January 1,
1900, which should be distant enough for most peoples' purposes. <P>
Similarly, if you want to find any transaction after a certain date,
put the date in the first date entry and put a date after your last
transaction in the second entry.
<a name="amount"><h3>Amount searches</a></h3>
@ -146,12 +162,12 @@ interested in debits, credits, or both.
<p>In the Description, Number, Memo, and Action tabs, you can
specify a string which is matched against the respective fields of
splits and transactions. By default, the match used is a
case-insensitive substring match. If you select the "Case sensitive"
toggle button, the search is a case-sensitive substring match. If the
splits and transactions. <ul><li> By default, the match used is a
case-insensitive substring match. <li> If you select the "Case sensitive"
toggle button, the search is a case-sensitive substring match. <li>If the
"Regular expression" button is selected, the match interprets the
string you enter as a POSIX extended regular expression; case
sensitivity is still determined by the "Case sensitive" button.
sensitivity is still determined by the "Case sensitive" button.</ul>
<a href="#toc">Table of Contents</a>

View File

@ -1,42 +1,50 @@
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
<title>Preferences</title>
</head>
<body>
<h1>Preferences</h1>
<p>You can customize the behavior of
GnuCash by changing the settings in this dialog box.All settings
are automatically saved so changes are preserved for future
sessions.</p>
<p>You can customize the behavior of GnuCash by changing the
settings in this dialog box.All settings are automatically
saved so changes are preserved for future sessions.</p>
<p>To change settings, simply click to select the appropriate
page, then make appropriate changes, and click the "Apply"
button to see
your changes take effect. Clicking "OK" applies changes, then
closes the properties dialog box.
them. The "Close" button simply closes the dialog box without
applying the latest changes.</p>
button to see your changes take effect. Clicking "OK" applies
changes, then closes the properties dialog box. them. The
"Close" button simply closes the dialog box without applying
the latest changes.</p>
<p>The settings are grouped into the following categories:</p>
<ul><li><b>Account Fields:</b> sets which fields are displayed in
<ul>
<li><b>Account Fields:</b> sets which fields are displayed in
the account list of the main window.</li>
<li><b>Account Types:</b> sets which account types are displayed
in the main window.</li>
<li><b>Account Types:</b> sets which account types are
displayed in the main window.</li>
<li><b>General:</b> anything that doesn't fit anywhere
else.</li>
<li><b>International:</b> Options relating to date and time
display formats.</li>
<li><b>Register:</b> Options relating to the default appearance
of account registers.</li>
<li><b>Register:</b> Options relating to the default
appearance of account registers.</li>
</ul>
<hr>
<hr><p> Return to <a href="xacc-main.html"> Main Documentation
<p>Return to <a href="xacc-main.html">Main Documentation
Page.</a></p>
</body>
</html>

View File

@ -1,42 +1,50 @@
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
<title>Preferences</title>
</head>
<body>
<h1>Preferences</h1>
<p>You can customize the behavior of
GnuCash by changing the settings in this dialog box.All settings
are automatically saved so changes are preserved for future
sessions.</p>
<p>You can customize the behavior of GnuCash by changing the
settings in this dialog box.All settings are automatically
saved so changes are preserved for future sessions.</p>
<p>To change settings, simply click to select the appropriate
page, then make appropriate changes, and click the "Apply"
button to see
your changes take effect. Clicking "OK" applies changes, then
closes the properties dialog box.
them. The "Close" button simply closes the dialog box without
applying the latest changes.</p>
button to see your changes take effect. Clicking "OK" applies
changes, then closes the properties dialog box. them. The
"Close" button simply closes the dialog box without applying
the latest changes.</p>
<p>The settings are grouped into the following categories:</p>
<ul><li><b>Account Fields:</b> sets which fields are displayed in
<ul>
<li><b>Account Fields:</b> sets which fields are displayed in
the account list of the main window.</li>
<li><b>Account Types:</b> sets which account types are displayed
in the main window.</li>
<li><b>Account Types:</b> sets which account types are
displayed in the main window.</li>
<li><b>General:</b> anything that doesn't fit anywhere
else.</li>
<li><b>International:</b> Options relating to date and time
display formats.</li>
<li><b>Register:</b> Options relating to the default appearance
of account registers.</li>
<li><b>Register:</b> Options relating to the default
appearance of account registers.</li>
</ul>
<hr>
<hr><p> Return to <a href="xacc-main.html"> Main Documentation
<p>Return to <a href="xacc-main.html">Main Documentation
Page.</a></p>
</body>
</html>

View File

@ -2,6 +2,7 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
@ -35,13 +36,13 @@
General Public License instead.) You can apply it to your
programs, too.</p>
<p> When we speak of free software, we are referring to
freedom, not price. Our General Public Licenses are designed to
make sure that you have the freedom to distribute copies of
free software (and charge for this service if you wish), that
you receive source code or can get it if you want it, that you
can change the software or use pieces of it in new free
programs; and that you know you can do these things.</p>
<p>When we speak of free software, we are referring to freedom,
not price. Our General Public Licenses are designed to make
sure that you have the freedom to distribute copies of free
software (and charge for this service if you wish), that you
receive source code or can get it if you want it, that you can
change the software or use pieces of it in new free programs;
and that you know you can do these things.</p>
<p>To protect your rights, we need to make restrictions that
forbid anyone to deny you these rights or to ask you to
@ -59,12 +60,12 @@
software, and (2) offer you this license which gives you legal
permission to copy, distribute and/or modify the software.</p>
<p> Also, for each author's protection and ours, we want to
make certain that everyone understands that there is no
warranty for this free software. If the software is modified by
someone else and passed on, we want its recipients to know that
what they have is not the original, so that any problems
introduced by others will not reflect on the original authors'
<p>Also, for each author's protection and ours, we want to make
certain that everyone understands that there is no warranty for
this free software. If the software is modified by someone else
and passed on, we want its recipients to know that what they
have is not the original, so that any problems introduced by
others will not reflect on the original authors'
reputations.</p>
<p>Finally, any free program is threatened constantly by
@ -92,10 +93,10 @@
(Hereinafter, translation is included without limitation in the
term "modification".) Each licensee is addressed as "you".</p>
<p> Activities other than copying, distribution and
modification are not covered by this License; they are outside
its scope. The act of running the Program is not restricted,
and the output from the Program is covered only if its contents
<p>Activities other than copying, distribution and modification
are not covered by this License; they are outside its scope.
The act of running the Program is not restricted, and the
output from the Program is covered only if its contents
constitute a work based on the Program (independent of having
been made by running the Program). Whether that is true depends
on what the Program does.</p>
@ -124,10 +125,10 @@
notices stating that you changed the files and the date of
any change.
<p> b) You must cause any work that you distribute or
publish, that in whole or in part contains or is derived from
the Program or any part thereof, to be licensed as a whole at
no charge to all third parties under the terms of this
<p>b) You must cause any work that you distribute or publish,
that in whole or in part contains or is derived from the
Program or any part thereof, to be licensed as a whole at no
charge to all third parties under the terms of this
License.</p>
<p>c) If the modified program normally reads commands
@ -230,16 +231,16 @@
conditions for copying, distributing or modifying the Program
or works based on it.</p>
<p> 6. Each time you redistribute the Program (or any work
based on the Program), the recipient automatically receives a
license from the original licensor to copy, distribute or
modify the Program subject to these terms and conditions. You
may not impose any further restrictions on the recipients'
exercise of the rights granted herein. You are not responsible
for enforcing compliance by third parties to this License.</p>
<p>6. Each time you redistribute the Program (or any work based
on the Program), the recipient automatically receives a license
from the original licensor to copy, distribute or modify the
Program subject to these terms and conditions. You may not
impose any further restrictions on the recipients' exercise of
the rights granted herein. You are not responsible for
enforcing compliance by third parties to this License.</p>
<p> 7. If, as a consequence of a court judgment or allegation
of patent infringement or for any other reason (not limited to
<p>7. If, as a consequence of a court judgment or allegation of
patent infringement or for any other reason (not limited to
patent issues), conditions are imposed on you (whether by court
order, agreement or otherwise) that contradict the conditions
of this License, they do not excuse you from the conditions of
@ -309,8 +310,8 @@
<h3><a name="SEC003">NO WARRANTY</a></h3>
<p> 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE
IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
<p>11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS
NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE
COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS
IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,

View File

@ -2,6 +2,7 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
@ -39,14 +40,14 @@
</pre>
<p>Note that accounts not only have names; they have <b>
codes,</b> in order to provide <em> order.</em> When a report
is generated, the <a name="SORTORDER"> sort order is determined
by the numbering.</a></p>
codes,</b> in order to provide <em>order.</em> When a report is
generated, the <a name="SORTORDER">sort order is determined by
the numbering.</a></p>
<p> A sensible hierarchy generally will have the "leaf"
accounts end in non-zero digits, whilst parent nodes have
increasing numbers of zeros. For instance, "cash" accounts
might logically be arranged thus:</p>
<p>A sensible hierarchy generally will have the "leaf" accounts
end in non-zero digits, whilst parent nodes have increasing
numbers of zeros. For instance, "cash" accounts might logically
be arranged thus:</p>
<ul>
<li>

View File

@ -2,6 +2,7 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
@ -61,8 +62,12 @@
<li><a href="xacc-expense.html">Using Income/Expense
Accounts</a></li>
<li><a href="xacc-globalprefs.html">Customizing Gnucash's Appearance</a></li>
<li><a href="xacc-accountedit.html">Changing Account Properties</a></li>
<li><a href="xacc-globalprefs.html">Customizing Gnucash's
Appearance</a></li>
<li><a href="xacc-accountedit.html">Changing Account
Properties</a></li>
</ul>
<h1>Extended Help/System Documentation</h1>

View File

@ -2,6 +2,7 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
@ -15,11 +16,11 @@
accounts from here.</p>
<p>Below is a picture of the main window, with only the main
accounts shown. Note how <b>Business Expenses</b> has been selected by
highlighting. The box with a cross in it,
immediately to its left, shows that it has one
or more detail accounts that are not shown at present.
To show them, click on this box.</p>
accounts shown. Note how <b>Business Expenses</b> has been
selected by highlighting. The box with a cross in it,
immediately to its left, shows that it has one or more detail
accounts that are not shown at present. To show them, click on
this box.</p>
<p><img src="contract.gif"><br>
</p>

View File

@ -1,20 +1,25 @@
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
<title>Profit And Loss Statement</title>
</head>
<body>
<h1>Profit and Loss Statement</h1>
<p>This report summarizes your sources of income and expenditure.</p>
<p>This report summarizes your sources of income and
expenditure.</p>
<p>There are currently no options for this report, but the option
to specify an accounting period will be added soon.</p>
<p>There are currently no options for this report, but the
option to specify an accounting period will be added soon.</p>
<p>Return to <a href="xacc-main.html">Main Documentation
Page.</a></p>
</body>
</html>

View File

@ -2,6 +2,7 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
@ -13,85 +14,89 @@
<p>You may print a GnuCash transaction as a check by selecting
"Print Check" from the Transaction menu in a register display
window.
window.</p>
<p> In the Print Check dialog, select the style of check form that
you wish to use, the position of the check on the page, and the
format for printing the date on the check. Clicking <tt>OK</tt>
will take you to the <a href="xacc-print.html">GnuCash Printing
</a> dialog, which will allow you to preview the check, select a
printer and paper size, and start the print job.
<p>In the Print Check dialog, select the style of check form
that you wish to use, the position of the check on the page,
and the format for printing the date on the check. Clicking
<tt>OK</tt> will take you to the <a href="xacc-print.html">
GnuCash Printing</a> dialog, which will allow you to preview
the check, select a printer and paper size, and start the print
job.</p>
<h2>Check format</h2>
<p>In order to print a check, it is necessary to know where the
pre-printed lines and boxes are on the check form. There are two
widely-used standard check formats: Quicken/QuickBooks (tm)
compatible, and Microsoft Money (tm) compatible.
pre-printed lines and boxes are on the check form. There are
two widely-used standard check formats: Quicken/QuickBooks (tm)
compatible, and Microsoft Money (tm) compatible.</p>
<p>By default, the check format is <tt>Quicken/QuickBooks</tt>,
which prints to any Quicken-compatible check forms.
which prints to any Quicken-compatible check forms.</p>
<h2>Custom Check Format</h2>
<p>If you wish to print to a type of check form that is not in
the <tt>Check Format</tt> option menu, select <tt>Custom</tt> in
the format menu and enter the positions of the various check
fields in the entry boxes below.
the <tt>Check Format</tt> option menu, select <tt>Custom</tt>
in the format menu and enter the positions of the various check
fields in the entry boxes below.</p>
<p> Positions in the Custom Check Format entry area are specified
with x = 0 at the left edge of the check with x increasing to the
right, and y = 0 at the bottom edge of the check with y increasing
as you travel up. Numbers may be entered as integer or floating
point values. The length units specified in the <tt>Units</tt>
option menu are used to interpret all values entered in the custom
check format area.
<p>Positions in the Custom Check Format entry area are
specified with x = 0 at the left edge of the check with x
increasing to the right, and y = 0 at the bottom edge of the
check with y increasing as you travel up. Numbers may be
entered as integer or floating point values. The length units
specified in the <tt>Units</tt> option menu are used to
interpret all values entered in the custom check format
area.</p>
<p>If you arrive at a working set of Custom Check Format
parameters for a commercially-available printable check form,
please submit them to <tt>gnucash-devel@gnucash.org</tt> so we can
include them as standard in a future release.
please submit them to <tt>gnucash-devel@gnucash.org</tt> so we
can include them as standard in a future release.</p>
<h2>Check position</h2>
<p>Printable check forms are available in several styles. In
general, each printable sheet is divided into three sections, and
each section can be either a check or a stub. The Check Position
option menu allows you to select which section of the page
contains the check you wish to print to. <tt>Top</tt>,
<tt>Middle</tt>, and <tt>Bottom</tt> should be defined correctly
for check forms using the paper size that you select in the
printing dialog.
general, each printable sheet is divided into three sections,
and each section can be either a check or a stub. The Check
Position option menu allows you to select which section of the
page contains the check you wish to print to. <tt>Top</tt>,
<tt>Middle</tt>, and <tt>Bottom</tt> should be defined
correctly for check forms using the paper size that you select
in the printing dialog.</p>
<h2>Custom check position</h2>
<p>If the preset check positions do not work correctly for your
check forms, you may choose <tt>Custom</tt> from the Check
Position option menu and enter a position for the check in the
<tt>Check Position</tt> entry. Enter the distance along the left
edge of the paper from the lower left-hand corner of the page to
the lower left-hand corner of the check. The units of this
measurement are those selected in the "Units" option menu.
<tt>Check Position</tt> entry. Enter the distance along the
left edge of the paper from the lower left-hand corner of the
page to the lower left-hand corner of the check. The units of
this measurement are those selected in the "Units" option
menu.</p>
<h2>Date format</h2>
<p> Select your preferred date format from the picker. The picker
shows a sample date of "December 31, 2000" for all formats, but
your date will be substituted when printing.
<p>Select your preferred date format from the picker. The
picker shows examples using the date of <tt>December 31,
2000</tt> for all formats, but your date will be substituted
when printing.</p>
<p> The "MM/DD/YY" and "DD/MM/YY" formats are available, but they
are strongly discouraged since they cannot always be
distinguished from each other. Please use a format with a full
or abbreviated month name instead of a number.
<p>The <tt>MM/DD/YY</tt> and <tt>DD/MM/YY</tt> formats are
available, but they are strongly discouraged since they cannot
always be distinguished from each other. Please use a format
with a full or abbreviated month name instead of a number.</p>
<h2>Custom date format</h2>
<p> If you wish to use another date format besides those available
in the picker, select <tt>Custom</tt> and enter a
<p>If you wish to use another date format besides those
available in the picker, select <tt>Custom</tt> and enter a
date-formatting string in the <tt>Date Format</tt> entry in the
custom settings area. If custom date format is selected, this
string is passed to <tt>strftime(3)</tt> as a format specifier.
string is passed to <tt>strftime(3)</tt> as a format
specifier.</p>
</body>
</html>

View File

@ -2,6 +2,7 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
@ -13,13 +14,13 @@
<p>At present, the only type of printing directly supported by
GnuCash is <a href="xacc-print-check.html">check printing</a>.
Other types of printing are expected to be supported soon.
Other types of printing are expected to be supported soon.</p>
<p> You may create a printout of the register
window contents by opening a register window and selecting <tt>
Print... To File</tt> from the <tt>File</tt> menu.
<a href="xacc-reports.html">Reports</a> can also be
<a href="xacc-reports.html">exported as HTML</a>.
<p>You may create a printout of the register window contents by
opening a register window and selecting <tt>Print... To
File</tt> from the <tt>File</tt> menu. <a href=
"xacc-reports.html">Reports</a> can also be <a href=
"xacc-reports.html">exported as HTML</a>.</p>
<h1>GnuCash as Web Server</h1>

View File

@ -45,40 +45,62 @@ of keeping up with what people want the program to do.
keep a Windows partition on their machine just so they can run Quicken
and the latest shoot-em-up games. So of course we want to give you a
way to suck all your Quicken data into GnuCash and remove one more
barrier to putting a nice ext2 filesystem on that Windows partition.
barrier to putting a nice <tt> ext2 </tt> filesystem on that Windows
partition.
<p>The problem is that GnuCash is a real double-entry accounting
system and Quicken has a pretty simplistic view about what an account
is, what a transaction is, and what to save in data files. In short,
QIF files just don't contain enough information to completely and
accurately reconstruct your Quicken account hierarchy in the GnuCash
double entry system without some guessing by the import code and some
hand-holding by you. QIF files omit small things that can be easily
guessed (for instance, are numbers in decimal-radix [1,000.00 == 1000]
form or European comma-radix form [1.000,00 == 1000]? Are dates m/d/y
or y/m/d?) and big things that can't be easily guessed, like, for
example, what currency the file is denominated in, or what account the
file describes.
is, what a transaction is, and, most critically, is severely flawed in its datamodel, that is, <em> what it saves in
data files.</em>
<p>For the most part, GnuCash's QIF importer does a good job of
figuring this stuff out, but you do have to keep an eye on it. The
system is designed so that you can correct problems BEFORE you make
changes to your GnuCash accounts; nothing is done to your GnuCash
accounts until you click the final "OK" button.
<P> Briefly, QIF files just don't contain enough information to
completely and accurately reconstruct your Quicken account hierarchy
in the GnuCash double entry system without some educated guessing by
the import code as well as some guidance, provided by you.
<ul>
<li> QIF files omit small things that may be fairly accurately inferred by
examining the data.
<P> For instance, are numbers in decimal-radix [1,000.00 ==
1000] form or European comma-radix form [1.000,00 == 1000]?
<P> Or are
dates <tt> m/d/y </tt> or <tt> y/m/d</tt>?
<Ll> More problematic are major things where there is little way of
guessing.
<P> For instance, determining the currency the file is denominated in.
<P> Or what <em> account </em> the file describes.
<p> GnuCash's QIF importer does a remarkably good job of guessing what
it can, but you <em> do </em> have to keep an eye on it. Fortunately,
the system is designed so that you can correct problems <em> before
</em> you changes are dropped into your GnuCash accounts. Nothing is
done to your GnuCash accounts until you click the final "OK" button.
<p>In the next section, I'll give an overview of the QIF file and
its "features". This may seem unnecessarily technical, but if you
will at least glance through it you will be much better able to
understand what's going on if you are having to jump through hoops to
make things work right, and how you might be able to jump right in and
edit the QIF file to fix really tough problems.
its "features". This may seem unnecessarily technical, but if you at
least glance through it you will be much better able to understand
what's going on if you are having to jump through hoops to make make a
problematic file work right, and how you might be able to jump right
in and edit the QIF file to fix really tough problems.
<p>There are two major "paths" for using the GnuCash QIF importer.
One is the "I am a Quicken user just migrating to GnuCash" path; the
other is the "I am downloading some updates from my bank as a QIF
file" path. This document mainly focuses on the former case, since
new users are likely to need the most help and you can't get started
using GnuCash until you can get your old records in.
<ul>
<li> One is the "I am a Quicken user just migrating to GnuCash" path.
<li> The other is the "I am downloading some updates from my bank as a
QIF file" path.
</uL>
<P> This document mainly focuses on the former case, since new users
are likely to need the most help and you really can't get started
using GnuCash until you can get your old records in. Fortunately,
once you learn to do the former, the latter should be a piece of cake.
<p><a href="#toc">Table of Contents</a>
@ -87,11 +109,12 @@ using GnuCash until you can get your old records in.
<p>QIF files are plain text files formatted as "tag-value" pairs.
At the beginning of each line there is a single character "tag"
followed immediately by the "value", which extends to the end of the
line. Don't be afraid to pop up a QIF file in "less" or the text
editor of your choice if you are having problems getting some Quicken
data imported correctly; chances are a simple search-and-replace will
fix just about any problem you might have with a QIF file. And a
regexp search-and-replace will get the rest.
line.
<P> Don't be afraid to pop up a QIF file using <tt> less </tt>
or the text editor of your choice if you are having problems getting
some Quicken data imported correctly; chances are a simple
search-and-replace can fix just about any problem you might have with
a QIF file. And a regexp search-and-replace will get the rest.
<p>Collections of tag-value pairs form records of various types.
There are records to store the names and descriptions of your accounts
@ -170,11 +193,12 @@ of all the $ fields in a transaction record should equal the T field.
<p>Note that nowhere in the transaction record, nor anywhere
else in the file, does Quicken store the name of the account that the
file describes. Don't ask me, I don't know why either. Microsoft
Money (which also can save QIF files) started doing a "trick" to get
the information in the file. If the very first Bank transaction in
the file has a payee of "Opening Balance", the L line contains the
name of the account that the file describes:
file describes. Don't ask me why not, I don't know either. Microsoft
Money (which also can save QIF files) uses a "trick" to get the
information in the file. If the very first Bank transaction in the
file has a payee of "Opening Balance", the L line contains the name of
the account that the file describes:
<pre>
!Type:Bank
D12/03/95
@ -184,36 +208,38 @@ name of the account that the file describes:
L[New Bank]
^
</pre>
<p>Opening Balance records are handled specially, since they don't
mean what they appear to mean (if you interpret the record literally,
as a transfer of $4706.57 from [New Bank] to [New Bank], your new
balance is a whopping $0.00). In the
<a href="#dialog-accounts">Accounts Tab</a> section there's a discussion
mean what the data appear to indicate (if you interpret the record
literally, as a transfer of $4706.57 from [New Bank] to [New Bank],
your new balance is a whopping $0.00). In the <a
href="#dialog-accounts">Accounts Tab</a> section there's a discussion
of what we do with them.
<h3>Multi-account Quicken exports</h3>
<p>Quicken and some other programs who use QIF as an export format
know how to put the history of multiple accounts into a single QIF
file. They do this by prepending an "!Account" record before the
set of transactions to/from that account.
file. They do this by prepending an "!Account" record before the set
of transactions to/from that account.
<p>The QIF Importer should be able to handle these files fine.
You may notice that the "Default QIF Account" seems somewhat
arbitrary; for multiple-account exports, the guessed account is the
first one with an Opening Balance record. However, since Quicken
explicitly lists the account for every transaction in multi-account
exports, you aren't likely to get any transactions in the default
account other than those that are supposed to be there.
<p>The QIF Importer should be able to handle these files fine. You
may notice that the "Default QIF Account" seems somewhat arbitrary;
for multiple-account exports, the guessed account is the first one
with an Opening Balance record. However, since Quicken explicitly
lists the account for every transaction in multi-account exports, you
aren't likely to get any transactions in the default account other
than those that are supposed to be there.
<p><a href="#toc">Table of Contents</a>
<a name="how-to"><h2>How to use the QIF Import dialog</h2></a>
<p>The "Quick Start" guide: To load your files, click the "Select
..." button in the Files tab to find the file, then click the "Load
File" button at the bottom of the Files tab to actually load it.
Repeat this until all your files are loaded (read the explanation
<p>The "Quick Start" guide: To load your files, click the "Select ..."
button in the Files tab to find the file, then click the "Load File"
button at the bottom of the Files tab to actually load it.
<P>Repeat this until all your files are loaded (read the explanation
below to see why you should load all your files at the same time).
Check the Accounts and Categories dialogs and make corrections if
necessary. Then click the big OK button.
@ -250,7 +276,7 @@ href="#dialog-categories">Categories tab</a>, and check that the
importer is going to put your Quicken transactions in the right place.
You can click to pop up a dialog and change the GnuCash destination
account name/type for any QIF account. Don't be afraid to change
these destination accounts; they are only guesses by the importer
these destination accounts; they are merely guesses by the importer
based on the name and type of the QIF account. Mappings of Quicken
account to GnuCash account are written to a preferences file when you
click "OK", so if you import other Quicken files describing these same

View File

@ -2,6 +2,7 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
@ -82,10 +83,10 @@
<p>For best results, you should make sure that those three
are checked.</p>
<p> If you do <em> not</em> check the <tt>Accounts
List</tt> box, then the name of your account will likely be
lost, and that will cause problems when you try to import
the data into GnuCash later.</p>
<p>If you do <em>not</em> check the <tt>Accounts List</tt>
box, then the name of your account will likely be lost, and
that will cause problems when you try to import the data
into GnuCash later.</p>
</li>
</ul>
Now you have a set of <tt>.QIF</tt> files, and should run

View File

@ -2,6 +2,7 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
@ -13,10 +14,10 @@
<p>The Reconciliation window is used to reconcile cleared
transactions from a bank statement. Enter a dollar amount from
your last bank statement in the box, and then click <tt>
OK</tt> . The window will then show all unreconciled
transactions since your last bank statement. The reconcile
window looks like this:</p>
your last bank statement in the box, and then click <tt>OK</tt>
. The window will then show all unreconciled transactions since
your last bank statement. The reconcile window looks like
this:</p>
<p><br>
<img src="recnwin.gif"><br>
@ -31,9 +32,9 @@
should enter the transaction into GnuCash.</p>
<p>At the end of the month, you receive your bank statement,
perhaps including canceled checks. At <em> that</em> point,
you should "reconcile" the account, that is, agree your
personal records to the documentation provided by the bank.</p>
perhaps including canceled checks. At <em>that</em> point, you
should "reconcile" the account, that is, agree your personal
records to the documentation provided by the bank.</p>
<ul>
<li>Open the reconcile window, and GnuCash will prompt you to

View File

@ -2,6 +2,7 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
@ -11,67 +12,96 @@
<body>
<h1>Register Window</h1>
<img src="regwin-single.gif">
<p> This is the "Register" or the "Ledger" window. Transactions are entered here.</p>
<p>To enter a new transaction, just type into the last blank transaction.
Use the mouse or the <a href="xacc-regwin_kbd.html">Register Keyboard Shortcuts</a>to move between fields, and hit the Enter key or click record to
record the transaction:</p>
<p>This is the "Register" or the "Ledger" window. Transactions
are entered here.</p>
<p>To enter a new transaction, just type into the last blank
transaction. Use the mouse or the <a href=
"xacc-regwin_kbd.html">Register Keyboard Shortcuts</a>to move
between fields, and hit the Enter key or click record to record
the transaction:</p>
<img src="regwin-single2.gif">
<p> Notice how a the transaction has been recorded and a new, blank
transaction has been created.</p>
<p>You can edit existing transactions in a similar manner. GnuCash
will prompt you to confirm any changes you make.</p>
<p>Notice how a the transaction has been recorded and a new,
blank transaction has been created.</p>
<p>You can edit existing transactions in a similar manner.
GnuCash will prompt you to confirm any changes you make.</p>
<h1>Manipulating transactions</h1>
<p>You can manipulate transactions with the toolbar or the "Transaction"
menu:
<ul><li><b>Delete:</b> you can delete a transaction or an individual
split.</li>
<li><b>Cancel:</b> this reverts any changes you have made to the
transaction you are currently entering/changing</li>
<p>You can manipulate transactions with the toolbar or the
"Transaction" menu:</p>
<ul>
<li><b>Delete:</b> you can delete a transaction or an
individual split.</li>
<li><b>Cancel:</b> this reverts any changes you have made to
the transaction you are currently entering/changing</li>
<li><b>New:</b> this moves the cursor to the last line of the
register where new transactions are entered</li>
<li><b>Jump:</b> When placed over an existing transaction, it takes
you to the corresponding register entry in the other register entry
that this
transaction appears in</li>
<li><b>Transfer:</b>This is an alternative way to enter a transaction.
You can do a transfer between any two accounts without opening
up other registers.</li>
<li><b>Close:</b>Closes this register</li></ul>
<li><b>Jump:</b> When placed over an existing transaction, it
takes you to the corresponding register entry in the other
register entry that this transaction appears in</li>
<li><b>Transfer:</b>This is an alternative way to enter a
transaction. You can do a transfer between any two accounts
without opening up other registers.</li>
<li><b>Close:</b>Closes this register</li>
</ul>
<h1>Viewing Transactions</h1>
<p>The register can show transactions in a variety of different
ways, controlled by entries on the "Register" menu.</p>
<p>The register can display transactions in several different
styles:</p>
<ul><li><b>single-line mode:</b> transactions are displayed on a single line.</li>
<li><b>double-line mode:</b> transactions are displayed over two lines,
with more information about each transaction shown.</li>
<li><b>multi-line mode:</b> transactions are displayed over multiple
lines, allowing the display of multiple entries. This allows you
to enter multi-split transactions (for instance, when you pay multiple bills with one check).</li>
<li><b>auto-single and auto-double modes</b> are like single and
double-line modes, except that the currently-edited transaction
is displayed in multi-line form. This is a very convenient way
of entering multi-account transactions.</li></ul>
<p>To change the display style, to go the "Register" menu and select
"style".</p>
<ul>
<li><b>single-line mode:</b> transactions are displayed on a
single line.</li>
<li><b>double-line mode:</b> transactions are displayed over
two lines, with more information about each transaction
shown.</li>
<li><b>multi-line mode:</b> transactions are displayed over
multiple lines, allowing the display of multiple entries.
This allows you to enter multi-split transactions (for
instance, when you pay multiple bills with one check).</li>
<li><b>auto-single and auto-double modes</b> are like single
and double-line modes, except that the currently-edited
transaction is displayed in multi-line form. This is a very
convenient way of entering multi-account transactions.</li>
</ul>
<p>To change the display style, to go the "Register" menu and
select "style".</p>
<p>Existing transactions are normally displayed in date order,
but this can also be changed with "Sort Order". You can also
select a date rate from which transactions will be displayed
with "Date Range".</p>
<p>Existing transactions are normally displayed in date order, but
this can also be changed with "Sort Order".
You can also select a date rate from which transactions will be
displayed with "Date Range".</p>
<h1>Reconciliation</h1>
<p>Transactions are typically checked against bank statements - a
process known as "reconciliation". GnuCash keeps track of
the reconciliation status of each transaction.</p>
<p>Transactions are typically checked against bank statements -
a process known as "reconciliation". GnuCash keeps track of the
reconciliation status of each transaction.</p>
<p>The reconciliation status of a transaction is shown by the
reconciliation (R) field. 'c' indicates that a transaction
has been reconciled, 'n' indicates that it has not. You can
change the reconciliation status by clicking on a the 'r' field
of the transaction.</p>
reconciliation (R) field. 'c' indicates that a transaction has
been reconciled, 'n' indicates that it has not. You can change
the reconciliation status by clicking on a the 'r' field of the
transaction.</p>
<p>At the bottom of the account window, there are two running
balances, the "cleared and reconciled" balance, and the "total"
balance... the "cleared and reconciled" balance should
@ -82,8 +112,6 @@
<p>Reconciliation can be done in the <a href=
"xacc-recnwin.html">Reconcile Window</a></p>
<h1>Stock Portfolios</h1>
<p>You can do stock transactions either from a single-stock

View File

@ -2,6 +2,7 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
@ -11,57 +12,86 @@
<body>
<h1>Reports</h1>
<p>A variety of financial reports can be selected on the "Extensions"
menu":
<ul><li><a href="xacc-balsheet.html">Balance Sheet:</a>shows Assets,
Liabilities and Equity.</li>
<li><a href="xacc-pnl.html">Profit And Loss State:</a>shows Income
and expenses over a selectable period <em>well, it will when
I get around to adding period support</em>
<li><a href="xacc-trans_report.html">Transaction Report</a>shows
transactions in an account, presented in a variety of ways.</li>
<li><a href="xacc-bal_tracker.html">Balance Tracker</a> tracks
the balance of one or more accounts over time, and supports
graphical output (if you have gnuplot installed).</li></ul>
<p>A variety of financial reports can be selected on the
"Extensions" menu":</p>
<ul>
<li><a href="xacc-balsheet.html">Balance Sheet:</a>shows
Assets, Liabilities and Equity.</li>
<li><a href="xacc-pnl.html">Profit And Loss State:</a>shows
Income and expenses over a selectable period <em>well, it
will when I get around to adding period support</em></li>
<li><a href="xacc-trans_report.html">Transaction
Report</a>shows transactions in an account, presented in a
variety of ways.</li>
<li><a href="xacc-bal_tracker.html">Balance Tracker</a>
tracks the balance of one or more accounts over time, and
supports graphical output (if you have gnuplot
installed).</li>
</ul>
<h1>The Report Window</h1>
Once you select a report, a report window will appear:
<p><img src="reportwin.gif"></p>
<p>The report is displayed in a resizable, scrollable window. To
control the report, you can use the toolbar buttons at the
top of the window:
<ul><li><b>Back</b> and <b>Forward</b> allow you to view the previous
contents of the window, just like a web browser</li>
<li><b>Parameters</b> pops up a dialog box allowing you to change the
information presented in the report:
<p><img src="report-option.gif"></p>
<p>See the help for the individual reports for details of options
available.</p></li>
<li><b>Export</b> allows you to export the contents of the report
as a HTML file for later viewing or printing.</li>
<li><b>Close</b> closes the report window.</li></ul>
<h1>Constructing custom reports</h1>
It is possible to write your own reports to meet your own needs, if
you can program a little.
You will need to know Scheme (a LISP-like programming language),
and it is an excellent idea to have a copy of the Gnucash source code
<p><img src="reportwin.gif"></p>
<p>The report is displayed in a resizable, scrollable window.
To control the report, you can use the toolbar buttons at the
top of the window:</p>
<ul>
<li><b>Back</b> and <b>Forward</b> allow you to view the
previous contents of the window, just like a web browser</li>
<li>
<b>Parameters</b> pops up a dialog box allowing you to
change the information presented in the report:
<p><img src="report-option.gif"></p>
<p>See the help for the individual reports for details of
options available.</p>
</li>
<li><b>Export</b> allows you to export the contents of the
report as a HTML file for later viewing or printing.</li>
<li><b>Close</b> closes the report window.</li>
</ul>
<h1>Constructing custom reports</h1>
It is possible to write your own reports to meet your own
needs, if you can program a little. You will need to know
Scheme (a LISP-like programming language), and it is an
excellent idea to have a copy of the Gnucash source code
available.
<P>The reporting interface is presently undocumented, but you can
get a good idea of how it works by examining the file
src/scm/report/hello-world.scm in the GnuCash source distribution.
<P>You will also need to access data from the "engine" to get
information for your report. This is performed by a set of Scheme
wrapper functions that are documented in the file src/g-wrap/gnc.html.
You may wish to examine some of the other reports in src/scm/report
for an indication of how they are used.
<P>At present, reports are produced by internally creating HTML and
rendering this with a HTML widget. (Future versions of GnuCash
will hopefully support a more flexible system).
<P>If you need more information, or have developed a new report that
may be of use to others, please contact the GnuCash development
mailing list at <a href="mailto:gnucash-devel@gnucash.org">gnucash-devel@gnucash.org</a>.
<p>The reporting interface is presently undocumented, but you
can get a good idea of how it works by examining the file
src/scm/report/hello-world.scm in the GnuCash source
distribution.</p>
<p>You will also need to access data from the "engine" to get
information for your report. This is performed by a set of
Scheme wrapper functions that are documented in the file
src/g-wrap/gnc.html. You may wish to examine some of the other
reports in src/scm/report for an indication of how they are
used.</p>
<p>At present, reports are produced by internally creating HTML
and rendering this with a HTML widget. (Future versions of
GnuCash will hopefully support a more flexible system).</p>
<p>If you need more information, or have developed a new report
that may be of use to others, please contact the GnuCash
development mailing list at <a href=
"mailto:gnucash-devel@gnucash.org">
gnucash-devel@gnucash.org</a>.</p>
<hr>
<p>Return to <a href="xacc-main.html">Main Documentation
Page.</a></p>
</body>

View File

@ -2,6 +2,7 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<meta http-equiv="Content-Type" content=
"text/html; charset=iso-8859-1">
@ -33,31 +34,34 @@
<li>Select a quote source from the pull-down menu. Currently
supported quote sources include <b>Yahoo</b>, <b>Yahoo
Europe</b>, <b>Fidelity Investments</b>, <b>T. Rowe Price</b>,
the <b>Vanguard Group</b>, <b>the Australian Stock
Europe</b>, <b>Fidelity Investments</b>, <b>T. Rowe
Price</b>, the <b>Vanguard Group</b>, <b>the Australian Stock
Exchange</b> (ASX) and <b>TIAA-CREF</b>. Note that Yahoo will
provide price quotes for many mutual funds <i>including</i>
Fidelity, T.Rowe Price and Vanguard, and that the quoted prices
at Yahoo <i>should</i> be identical to those that may be found
at the source sites (otherwise, somebody's reporting wrong
information!). If you choose Yahoo Europe, you should append the
market code for the security, such as PA for Paris, BE for
Berlin, etc. Example: 12150.PA (a Peugeot security in the Paris
market).
Fidelity, T.Rowe Price and Vanguard, and that the quoted
prices at Yahoo <i>should</i> be identical to those that may
be found at the source sites (otherwise, somebody's reporting
wrong information!). If you choose Yahoo Europe, you should
append the market code for the security, such as PA for
Paris, BE for Berlin, etc. Example: 12150.PA (a Peugeot
security in the Paris market).</li>
<li>Ensure that the currency of the account matches the source
<li>
Ensure that the currency of the account matches the source
of the stock you have selected. This means:
<ul>
<li>Quotes from the <b>Australian Stock Exchange</b> (ASX)
should be in Australian dollars (AUD).</li>
<li>Quotes from the <b>Australian Stock Exchange</b>
(ASX) should be in Australian dollars (AUD).</li>
<li>Quotes from <b>Yahoo Europe</b> should be in Euros (ECU)</li>
<li>Quotes from <b>Yahoo Europe</b> should be in Euros
(ECU)</li>
<li>Quotes from <b>Yahoo</b>, <b>Fidelity Investments</b>,
<b>T. Rowe Price</b> and the <b>Vanguard Group</b>
should be in US Dollars (USD).</li>
<li>Quotes from <b>Yahoo</b>, <b>Fidelity
Investments</b>, <b>T. Rowe Price</b> and the <b>Vanguard
Group</b> should be in US Dollars (USD).</li>
</ul>
</li>
</ul>
<table>
@ -196,52 +200,76 @@
<caption>
Pseudo-symbols that can be used for TIAA-CREF quotes.
</caption>
<tr>
<th>Name</th>
<th>Pseudo-symbol</th>
</tr>
<tr>
<td>Stock</td>
<td>CREFstok</td>
</tr>
<tr>
<td>Money Market</td>
<td>CREFmony</td>
</tr>
<tr>
<td>Equity Index</td>
<td>CREFequi</td>
</tr>
<tr>
<td>Inflation-Linked Bond</td>
<td>CREFinfb</td>
</tr>
<tr>
<td>Bond Market</td>
<td>CREFbond</td>
</tr>
<tr>
<td>TIAA Real Estate</td>
<td>TIAAreal</td>
</tr>
<tr>
<td>Social Choice</td>
<td>CREFsoci</td>
</tr>
<tr>
<td>Teachers PA Stock Index</td>
<td>TIAAsndx</td>
</tr>
<tr>
<td>Global Equities</td>
<td>CREFglob</td>
</tr>
<tr>
<td>Teachers PA Select Stock</td>
<td>TIAAsele</td>
</tr>
<tr>
<td>Growth</td>
<td>CREFgrow</td>
</tr>
</table>
@ -286,3 +314,4 @@
Page.</a></p>
</body>
</html>

View File

@ -1,6 +1,8 @@
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
@ -10,24 +12,35 @@
<body>
<h1>Transaction Report</h1>
<p>Transaction reports list details for transactions in a specified
account over a specified period, in a convenient format for
viewing and exporting.</p>
<p>Transaction reports list details for transactions in a
specified account over a specified period, in a convenient
format for viewing and exporting.</p>
<p>Options specifiable for this report include:</p>
<ul><li><b>Account:</b> the account to do the report on.</li>
<li><b>Date To and Date From:</b> the date range for the report
to cover.</li>
<ul>
<li><b>Account:</b> the account to do the report on.</li>
<li><b>Date To and Date From:</b> the date range for the
report to cover.</li>
<li><b>Primary Sort Key:</b> the field to sort on first.</li>
<li><b>Primary Sort Order:</b> the order in which to sort. "Ascending"
specifies smallest/largest, alphabetical ordering, earliest->latest,
or smallest amounts first. Descending produces the opposite effects.</li>
<li><b>Secondary Sort Key:</b> the field to sort on if the primary
sort keys are equal</li>
<li><b>Secondary Sort Order:</b> the ordering on which to sort the
secondary key.</b>
<li><b>Primary Sort Order:</b> the order in which to sort.
"Ascending" specifies smallest/largest, alphabetical
ordering, earliest-&gt;latest, or smallest amounts first.
Descending produces the opposite effects.</li>
<li><b>Secondary Sort Key:</b> the field to sort on if the
primary sort keys are equal</li>
<li><b>Secondary Sort Order:</b> the ordering on which to
sort the secondary key.</li>
</ul>
<hr>
<p>Return to <a href="xacc-main.html">Main Documentation
Page.</a></p>
</body>
</html>

View File

@ -2,6 +2,7 @@
<html>
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org">
<link rel="stylesheet" title="normal" type="text/css" href=
"gnucash.css">
@ -11,15 +12,15 @@
<body>
<h1>GnuCash Y2K Readiness</h1>
<p> GnuCash versions 1.1.25 and later store all dates as
seconds and nanoseconds, where the seconds are stored in a
64-bit signed integer. This should suffice to store dates into
both the distant past as well as the distant future, so long as
they fall not <em> too</em> many orders of magnitude outside
<p>GnuCash versions 1.1.25 and later store all dates as seconds
and nanoseconds, where the seconds are stored in a 64-bit
signed integer. This should suffice to store dates into both
the distant past as well as the distant future, so long as they
fall not <em>too</em> many orders of magnitude outside
cosmologists' estimations of the age of the universe.</p>
<p> The file format for version 1.1.25 and later stores dates
in the above-described fashion.</p>
<p>The file format for version 1.1.25 and later stores dates in
the above-described fashion.</p>
<p>Some internal routines use the <tt>time_t</tt> type to
express seconds. Note that on most OSes, this is a 32-bit