diff --git a/doc/sgml/C/image/Makefile.am b/doc/sgml/C/image/Makefile.am
index 052a68c3e9..3c1012fe8a 100644
--- a/doc/sgml/C/image/Makefile.am
+++ b/doc/sgml/C/image/Makefile.am
@@ -13,6 +13,7 @@ image_DATA = \
expand.png \
foliowin-single.png \
foliowin.png \
+ foreign-currency.png \
logo-NetBSD-banner.png \
logo-debian.png \
logo-linux.png \
diff --git a/doc/sgml/C/image/foreign-currency.png b/doc/sgml/C/image/foreign-currency.png
new file mode 100644
index 0000000000..094fbb8b97
Binary files /dev/null and b/doc/sgml/C/image/foreign-currency.png differ
diff --git a/doc/sgml/C/image/recnwin.png b/doc/sgml/C/image/recnwin.png
index 4ec10ae71e..f2588ffb8f 100644
Binary files a/doc/sgml/C/image/recnwin.png and b/doc/sgml/C/image/recnwin.png differ
diff --git a/doc/sgml/C/xacc-currencyhandling.sgml b/doc/sgml/C/xacc-currencyhandling.sgml
index 2c0aae41e1..4f2eb252c5 100644
--- a/doc/sgml/C/xacc-currencyhandling.sgml
+++ b/doc/sgml/C/xacc-currencyhandling.sgml
@@ -65,6 +65,72 @@
identity.
+
+
+ How to set up a foreign-currency account
+ All of the above may sound straightforward, but you may get
+ stumped when you first try to represent some foreign money. Let's
+ demonstrate how you'd go about setting up an account to represent,
+ say, French Francs.
+
+ Let's say you have an account that holds cash in US dollars,
+ and it has $1,000 in it. You want to buy about $100 worth of
+ Francs, and naturally you'd like to represent those Francs in
+ their own account. Here's what you need to do:
+
+
+
+ Create a new account (name it "Francs") of type Cash, with a
+ currency of FRF (that's the ISO code for French Francs; see
+ ISO Currency Codes, below).
+
+
+
+
+ Create another account (name it "Trading"), of type
+ Currency, with a currency of USD, and a security of
+ FRF. This account will represent trades between the
+ two currencies, or to be more precise, purchases of Francs
+ with dollars.
+
+
+
+
+ Now open the "Trading" account, and enter a transaction that
+ transfers from your cash account. Put 555 in the "Debit"
+ column, and 0.18 in the Price column. (GnuCash will offer to
+ calculate the Value for you; let it do so.) You've now bought
+ 555 Francs for $0.18 apiece.
+
+
+
+
+ Transfer the 555 Francs that are now in your trading account
+ into the "Francs" account (by putting "555" in the "Debit"
+ column). Note that you could not have transferred anything
+ directly from cash to Francs (try it); those two accounts do not
+ have a currency in common.
+
+
+
+
+ Note that your "Trading" account now is a bit screwed up --
+ the last transaction, transferring 555 francs to your "Francs"
+ account, didn't record the price of those francs. You can
+ change the price from 1 to 0.18 to make the balance in the
+ "Trading" account come out to zero.
+
+
+
+
+ Here's what it all looks like once you're done:
+
+
+
+
+
+
+ ISO Currency Codes
diff --git a/doc/sgml/C/xacc-recnwin.sgml b/doc/sgml/C/xacc-recnwin.sgml
index ecbbed1ed9..94f0691cdb 100644
--- a/doc/sgml/C/xacc-recnwin.sgml
+++ b/doc/sgml/C/xacc-recnwin.sgml
@@ -1,13 +1,14 @@
-Reconciliation Window
+Reconcile Window
-
-The Reconciliation window is used to reconcile a GnuCash account with
+The Reconcile window is used to reconcile a GnuCash account with
a statement that a bank or other institution has sent you.
+
+
For example, when you write a check for something, you should enter
the transaction into GnuCash. The reconciliation
(R) field of the transaction will initially
@@ -17,20 +18,12 @@
(cleared, but not reconciled).
-At the end of the month, you receive your bank statement,
- perhaps including canceled checks. At that point,
- you should "reconcile" the account, that is, match your personal
- records with the documentation provided by the bank.
-
-
-Open the reconcile window by selecting
- Reconcile... from the
- Accounts menu of the account's
- Register window. GnuCash will prompt
- you for some information from the statement:
+
+Choose Reconcile from the Accounts menu, and GnuCash will prompt you to
+ enter the ending balance from the bank statement.
@@ -39,6 +32,7 @@
+
Enter the date of the end of the period that the statement covers,
@@ -54,13 +48,14 @@
- The Funds In and Funds Out
- groups lists all the unreconciled transactions. The
- '?' columns show whether the transactions have
+ The Debits and Credits
+ groups list all the unreconciled transactions. The
+ 'R' columns show whether the transactions have
been cleared or reconciled.
+
Now, examine each item on the bank statement, and look for the
matching item in the Reconcile window.
@@ -86,7 +81,7 @@
If the amounts agree, click on the item in the Reconcile window. The
- '?' column will change to 'y'
+ 'R' column will change to 'y'
(reconciled) from 'n' or 'c'.
@@ -95,31 +90,29 @@
amounts in GnuCash, and marking off transactions in GnuCash
as they are reconciled.
-
-At the bottom of the window is a difference field, which
- should be $0.00 when you are done reconciling. If it isn't,
- then you have either missed transactions, or some amounts may
- be incorrect in GnuCash. (Or, probably rather less likely,
+At the bottom of the "Reconcile" window is a "Difference" field, which
+ should show $0.00 when you are done reconciling. If it shows some other value,
+ then either you have missed transactions, or some amounts may
+ be incorrect in GnuCash. (Or, less likely,
the bank may have made an error.)
-
-
-
+
-When you have completed marking off all the items on the
- bank statement, and when the difference is $0.00, you should press the
+When you have marked off all the items on the
+ bank statement, and when the difference is $0.00, press the
Finish button on the tool bar or select
Finish from the
- Reconcile menu. The Reconcile window will close.
+ Reconcile menu (the latter method will work
+ even if your "Difference" isn't $0.00).
+ The Reconcile window will close.
In the Register window, the
R field of the reconciled transactions will
change to 'y'.
-
diff --git a/doc/sgml/C/xacc-regwin.sgml b/doc/sgml/C/xacc-regwin.sgml
index d1d1b0a59d..1c78eaf087 100644
--- a/doc/sgml/C/xacc-regwin.sgml
+++ b/doc/sgml/C/xacc-regwin.sgml
@@ -167,9 +167,10 @@
indicates that a transaction has been reconciled,
'n' indicates that it has not, and
'c' indicates that it has been cleared, but not
- reconciled. When a transaction has cleared, you can change its status
- to 'c' by clicking on its R
- field.
+ reconciled. You can toggle
+ the reconciliation status between 'n' and 'c' by clicking in the
+ (R) field; you can set it to 'y' by using the Reconcile Window.
At the bottom of the account window, there are two running