r18921 - gnucash-docs/trunk/guide/C - Bug #589320 - Adapt / update documentation of Price Editor - Currency Namespace

Geert Janssens gjanssens at code.gnucash.org
Tue Mar 16 13:16:35 EDT 2010


Author: gjanssens
Date: 2010-03-16 13:16:35 -0400 (Tue, 16 Mar 2010)
New Revision: 18921
Trac: http://svn.gnucash.org/trac/changeset/18921

Added:
   gnucash-docs/trunk/guide/C/figures/currency_addcurr.png
Removed:
   gnucash-docs/trunk/guide/C/figures/currency_selectcomm.png
   gnucash-docs/trunk/guide/C/figures/currency_selectcurr.png
Modified:
   gnucash-docs/trunk/guide/C/ch_currency.xml
   gnucash-docs/trunk/guide/C/figures/currency_AfterGetOnlineQuotes.png
   gnucash-docs/trunk/guide/C/figures/currency_BeforeGetOnlineQuotes.png
   gnucash-docs/trunk/guide/C/figures/currency_main1.png
   gnucash-docs/trunk/guide/C/figures/currency_main2.png
   gnucash-docs/trunk/guide/C/figures/currency_main3.png
   gnucash-docs/trunk/guide/C/figures/currency_peditor.png
Log:
Bug #589320 - Adapt / update documentation of Price Editor - Currency Namespace

Modified: gnucash-docs/trunk/guide/C/ch_currency.xml
===================================================================
--- gnucash-docs/trunk/guide/C/ch_currency.xml	2010-03-16 11:20:04 UTC (rev 18920)
+++ gnucash-docs/trunk/guide/C/ch_currency.xml	2010-03-16 17:16:35 UTC (rev 18921)
@@ -1,12 +1,13 @@
 <!--
       (Do not remove this comment block.)
-  Version: 2.0.0
-  Last modified: July 9th 2006
+  Version: 2.4.0
+  Last modified: March 16th 2010
   Maintainers: 
                Chris Lyttle <chris at wilddev.net>
   Author:
   		Jon Lapham <lapham at extracta.com.br>
   	Updated	Bengt Thuree <bengt at thuree.com>
+  	Updated	Geert Janssens <janssens-geert at telenet.be>
   Originally designed by Carol Champagne.
   Translators:
                (translators put your name and email here)
@@ -26,7 +27,7 @@
 
     <para>Some of the issues which arise when using multiple currencies is how
     do you transfer funds between accounts with different currencies? How do
-    you calculate the overall value when you have mized currency accounts? How
+    you calculate the overall value when you have mixed currency accounts? How
     do reports deal with mixed currencies?</para>
   </sect1>
 
@@ -86,16 +87,16 @@
     <para>Below you see the result of this example, in which you start with
     USD 10,000, EUR 10,000 as well as HKD 10,000 in the three bank accounts.
     Notice that the total of the parent accounts only show the value of the
-    currency of subaccounts with matching currencies. In the future you can
+    currency of sub-accounts with matching currencies. In the future you can
     setup the exchange rates between the currencies, and the parent accounts
-    will calculate the converted value of all subaccounts. See the later
+    will calculate the converted value of all sub-accounts. See the later
     section (<xref linkend="currency_howto1" />) on how to do this.</para>
 
     <screenshot id="currency_main1">
       <mediaobject>
         <imageobject>
           <imagedata fileref="figures/currency_main1.png" format="PNG"
-                     srccredit="Bengt Thuree" />
+                     srccredit="Geert Janssens" />
         </imageobject>
 
         <textobject>
@@ -164,7 +165,7 @@
       <mediaobject>
         <imageobject>
           <imagedata fileref="figures/currency_main1.png" format="PNG"
-                     srccredit="Bengt Thuree" />
+                     srccredit="Geert Janssens" />
         </imageobject>
 
         <textobject>
@@ -182,11 +183,11 @@
       <para>Open the Price Editor by going to <guimenu>Tools</guimenu> -&gt;
       <guimenu>Price Editor</guimenu>.</para>
 
-      <screenshot id="currency_BeforeGetOnlineQuotes">
+      <screenshot id="currency_peditor">
         <mediaobject>
           <imageobject>
-            <imagedata fileref="figures/currency_BeforeGetOnlineQuotes.png"
-                       format="PNG" srccredit="Bengt Thuree" />
+            <imagedata fileref="figures/currency_peditor.png"
+                       format="PNG" srccredit="Geert Janssens" />
           </imageobject>
 
           <textobject>
@@ -198,55 +199,38 @@
       </screenshot>
 
       <para>Click on the <guibutton>Add</guibutton> button to add a new
-      currency exchange. A window will appear to allow you to select the
-      commodity you wish to define the exchange rate for. Click on
-      <guibutton>Select</guibutton> and set the <guilabel>Type</guilabel> to
-      Currency and the <guilabel>Currency/security</guilabel> to EUR (Euro).
-      This window should appear like this:</para>
+      currency exchange. A window will appear in which you can setup a new
+      exchange rate. This window should appear like this:</para>
 
-      <screenshot id="currency_selectcurr">
+      <screenshot id="currency_addcurr">
         <mediaobject>
           <imageobject>
-            <imagedata fileref="figures/currency_selectcurr.png" format="PNG"
-                       srccredit="Bengt Thuree" />
+            <imagedata fileref="figures/currency_addcurr.png" format="PNG"
+                       srccredit="Geert Janssens" />
           </imageobject>
 
           <textobject>
-            <phrase>Select Euro Commodity</phrase>
+            <phrase>Setup Euro Exchange Rate</phrase>
           </textobject>
 
-          <caption><para>Price Editor Select Commodity Window</para></caption>
+          <caption><para>Add Price Editor Window</para></caption>
         </mediaobject>
       </screenshot>
 
-      <para>Click <guibutton>Ok</guibutton> and in the Select Commodity
-      window, set the exchange rate between the selected commodity and the
+      <para> Set the <guilabel>Namespace</guilabel> to
+      Currency and the <guilabel>Security</guilabel> to EUR (Euro).
+      Then set the exchange rate between the selected security and the
       selected currency. In this example, you will set the exchange rate to 1
-      EUR to 1 USD.</para>
+      EUR for 1 USD.</para>
 
-      <screenshot id="currency_selectcomm">
+      <screenshot id="currency_manualpriceadded">
         <mediaobject>
           <imageobject>
-            <imagedata fileref="figures/currency_selectcomm.png" format="PNG"
-                       srccredit="Bengt Thuree" />
+            <imagedata fileref="figures/currency_BeforeGetOnline.png" format="PNG"
+                       srccredit="Geert Janssens" />
           </imageobject>
 
           <textobject>
-            <phrase>Select Commodity</phrase>
-          </textobject>
-
-          <caption><para>Price Editor Select Commodity Window</para></caption>
-        </mediaobject>
-      </screenshot>
-
-      <screenshot id="currency_peditor">
-        <mediaobject>
-          <imageobject>
-            <imagedata fileref="figures/currency_peditor.png" format="PNG"
-                       srccredit="Bengt Thuree" />
-          </imageobject>
-
-          <textobject>
             <phrase>Price Editor Window</phrase>
           </textobject>
 
@@ -259,7 +243,7 @@
         <mediaobject>
           <imageobject>
             <imagedata fileref="figures/currency_main2.png" format="PNG"
-                       srccredit="Bengt Thuree" />
+                       srccredit="Geert Janssens" />
           </imageobject>
 
           <textobject>
@@ -271,8 +255,8 @@
         </mediaobject>
       </screenshot>
 
-      <para>Observe that since you have no exchange rate for HKD, GnuCash do
-      not convert the HKD accounts to USD. This will be added in the next
+      <para>Observe that since you have no exchange rate for HKD, GnuCash
+      doesn't convert the HKD accounts to USD. This will be added in the next
       section.</para>
     </sect2>
 
@@ -289,8 +273,8 @@
       <screenshot id="currency_BeforeGetOnline">
         <mediaobject>
           <imageobject>
-            <imagedata fileref="figures/currency_peditor.png" format="PNG"
-                       srccredit="Bengt Thuree" />
+            <imagedata fileref="figures/currency_BeforeGetOnline.png" format="PNG"
+                       srccredit="Geert Janssens" />
           </imageobject>
 
           <textobject>
@@ -307,7 +291,7 @@
 
       <note><para>
          If the <guibutton>Get Quotes</guibutton> button is disabled, 
-         that means that the perl module Finance::Quote is not installed. 
+         that means that the Perl module Finance::Quote is not installed. 
          For information on how to install it, please see 
          <xref linkend="invest-stockprice-auto2" ></xref>
       </para></note>
@@ -316,7 +300,7 @@
           <mediaobject>
             <imageobject>
               <imagedata fileref="figures/currency_AfterGetOnlineQuotes.png"
-                         format="PNG" srccredit="Bengt Thuree" />
+                         format="PNG" srccredit="Geert Janssens" />
             </imageobject>
 
             <textobject>
@@ -328,13 +312,13 @@
           </mediaobject>
         </screenshot></para>
 
-      <para>You noticed that GnuCash will download exchange rates for all
-      currencies you are using in your various accounts. This will happend
-      everytime you click on <guibutton>Get Quotes</guibutton> or have GnuCash
+      <para>You can observe that GnuCash will download exchange rates for all
+      currencies you are using in your various accounts. This will happen
+      every time you click on <guibutton>Get Quotes</guibutton> or have GnuCash
       downloading quotes/exchange rates automatically as per <xref
       linkend="invest-stockprice-auto2" /></para>
 
-      <para>And if you check the main Chart of Accounts you now see that
+      <para>And if you check the main Chart of Accounts you will see that
       GnuCash has automatically converted the HKD amount to USD amount on the
       parent accounts that are in USD, as well as on the Total (USD) column.
       Also the Euro accounts have been been updated with the latest exchange
@@ -344,7 +328,7 @@
         <mediaobject>
           <imageobject>
             <imagedata fileref="figures/currency_main3.png" format="PNG"
-                       srccredit="Bengt Thuree" />
+                       srccredit="Geert Janssens" />
           </imageobject>
 
           <textobject>
@@ -398,7 +382,7 @@
 
     <para>1) Use GnuCash build in currency exchange between accounts when you
     do your transactions. This is mainly used for one time transactions, and
-    nothing which happens regurarly.</para>
+    nothing which happens regularly.</para>
 
     <para>2) Use separate accounts for this Purchase, where all involved
     accounts use the same currency. This is the recommended method, since it
@@ -436,8 +420,8 @@
 Note: the currency of each account is shown in parenthesis.
  </literallayout>
 
-      <para>First you need to transfere some money ($10,000) to Jamaica, and
-      you use your normal US bank account (whith balance of $100,000) for
+      <para>First you need to transfer some money ($10,000) to Jamaica, and
+      you use your normal US bank account (with balance of $100,000) for
       that. The bank give you an exchange rate of USD 1 = JMD 64, but charges
       you USD 150 to do transfer the money.</para>
 
@@ -499,7 +483,7 @@
       <para>You find the boat, and since it's a bargain at JMD 509,000 you
       decide to buy it. To record this transaction in GnuCash, you will need
       to enter a simple transaction in Assets:Current Assets:Jamaican Bank
-      withdrawing 509,000 and transfering it to Assets:Fixed
+      withdrawing 509,000 and transferring it to Assets:Fixed
       Assets:Boat</para>
 
       <screenshot id="currency_purchase_AfterBoat.png">
@@ -780,7 +764,7 @@
       <title>Selling a currency investment</title>
 
       <para>Entering an currency you are selling is done in the same way as
-      buying one except the you are now transfering money from the Currency
+      buying one except the you are now transferring money from the Currency
       account to your Savings account (very much similar to (<xref
       linkend="invest-sell1" />).</para>
 
@@ -866,7 +850,7 @@
   <sect1 id="currency_reconcile1">
     <title>Reconciling Statements in a Foreign Currency (How-To)</title>
 
-    <para>Reconciling foreigh statement are done in the same manner as when
+    <para>Reconciling foreign statement are done in the same manner as when
     you reconcile your local bank statement. If you have created a Chart of
     Accounts structure which allows you to have the same Currency per account
     as your Reconcile Statement, it is actually exactly the same as
@@ -882,7 +866,7 @@
     <title>Putting It All Together (Examples)</title>
 
     <para>In this Putting It All Together you will use quite a bit of what you
-    have learned so far in this guide with a bit of a twist. The twist beeing
+    have learned so far in this guide with a bit of a twist. The twist being
     a lot of different currencies.</para>
 
     <sect2>
@@ -964,7 +948,7 @@
       preferences (<guimenu>Edit</guimenu> -&gt; <guimenuitem>Preferences</guimenuitem>) 
       to set Default Currency as AUD. Since you have
       decided to be able to track as much of your various expenses and incomes
-      as possile, the following account hierarchy could be used;</para>
+      as possible, the following account hierarchy could be used;</para>
 
       <literallayout>
 Assets:Current Assets:Savings Account         (AUD)
@@ -979,7 +963,7 @@
 
       <para>You open the mail one morning, and to your enormous surprise find
       that you are the last living relative of a very distant relative who
-      happend to be very rich. And also $500,000 AUD richer. That was not the
+      happened to be very rich. And also $500,000 AUD richer. That was not the
       last though, another mail states you won the lottery, and got $250,000
       AUD for that. </para>
       
@@ -1048,7 +1032,7 @@
     <sect2>
       <title>Purchase a house</title>
 
-      <para>Atlast you can afford to pay of that house loan you had to take some years ago 
+      <para>At last you can afford to pay of that house loan you had to take some years ago 
       (with a $50,000 deposit).</para>
 
       <literallayout>
@@ -1092,7 +1076,7 @@
                 <entry></entry>
               </row>
               <row>
-                <entry>Libilities:Loans:Mortgage</entry>
+                <entry>Liabilities:Loans:Mortgage</entry>
 
                 <entry>250000</entry>
 
@@ -1103,7 +1087,7 @@
         </table>
         
       <para>The <guilabel>Liabilities:Loans:Mortgage</guilabel> Transaction Ledger looks like 
-      this after the transacations have been entered</para>
+      this after the transactions have been entered</para>
       
       <screenshot id="currency_PutTogether_AussieHouse.png">
         <mediaobject>
@@ -1269,7 +1253,7 @@
       </para>
         
       <para>As you can see in the Chart of Accounts, you have now purchased stocks in three
-      different currencise (HK, USD, as well as in SEK), but the Chart of Account (as seen below)
+      different currencies (HK, USD, as well as in SEK), but the Chart of Account (as seen below)
       do not indicate how much it is valued in your home currency, AUD.</para>
       <screenshot id="currency_PutTogether_AfterStocks.png">
         <mediaobject>
@@ -1317,7 +1301,7 @@
         </literallayout>
       </para>
       <para>This is a
-        simpe currency transaction from your Savings Account (AUD), to your
+        simple currency transaction from your Savings Account (AUD), to your
         Assets:Money owed to me:Peter (EURO) account. You got the exchange rate
         of 0.606161, which means you need to withdraw AUD 65,989.10, as well as
         pay the service fee of 35 AUD.</para>
@@ -1335,7 +1319,7 @@
       <note>
         <para>Again, this should not be taken as a financial advice. Please
         consult with a registered financial advisor before undertaking
-        investing (or spekulating) in overseas markets, or local markets for
+        investing (or speculating) in overseas markets, or local markets for
         that matter.</para>
 
         <para>A word of warning might be of interest here, taking a loan

Modified: gnucash-docs/trunk/guide/C/figures/currency_AfterGetOnlineQuotes.png
===================================================================
(Binary files differ)

Modified: gnucash-docs/trunk/guide/C/figures/currency_BeforeGetOnlineQuotes.png
===================================================================
(Binary files differ)

Added: gnucash-docs/trunk/guide/C/figures/currency_addcurr.png
===================================================================
(Binary files differ)


Property changes on: gnucash-docs/trunk/guide/C/figures/currency_addcurr.png
___________________________________________________________________
Added: svn:mime-type
   + image/png

Modified: gnucash-docs/trunk/guide/C/figures/currency_main1.png
===================================================================
(Binary files differ)

Modified: gnucash-docs/trunk/guide/C/figures/currency_main2.png
===================================================================
(Binary files differ)

Modified: gnucash-docs/trunk/guide/C/figures/currency_main3.png
===================================================================
(Binary files differ)

Modified: gnucash-docs/trunk/guide/C/figures/currency_peditor.png
===================================================================
(Binary files differ)

Deleted: gnucash-docs/trunk/guide/C/figures/currency_selectcomm.png
===================================================================
(Binary files differ)

Deleted: gnucash-docs/trunk/guide/C/figures/currency_selectcurr.png
===================================================================
(Binary files differ)



More information about the gnucash-changes mailing list