<!--
      (Do not remove this comment block.)
  Version: 2.0.0
  Last modified: July 9th 2006
  Maintainers: 
               Chris Lyttle <chris@wilddev.net>
  Author:
  		Jon Lapham <lapham@extracta.com.br>
  	Updated	Dave Herman <dvherman@bigfoot.com>
  Originally designed by Carol Champagne.
  Translators:
               (translators put your name and email here)
-->
<chapter id="chapter8">
  <title>Investments</title>

  <para>This chapter explains how to manage your investments with GnuCash.
  Most people have an investment plan, whether its just putting money into a
  CD account, investing through a company sponsored plan at your workplace or
  buying and selling stocks and bonds through a brokerage. GnuCash gives you
  tools to help you manage these investments such as the <emphasis>Price
  Editor </emphasis> which allows you to record changes in the prices of
  stocks you own.</para>

  <sect1 id="invest_concepts1">
    <title>Basic Concepts</title>

    <para>An investment is something that you purchase in the hopes of
    generating income, or that you hope to sell in the future for more than
    you paid. Using this simple definition, many things could be considered
    investments: the house you live in, a valuable painting, stocks in
    publicly traded companies, your savings account at the bank, or a
    certificate of deposit. These many types of investments will be discussed
    in this chapter in terms of how to track them using GnuCash.</para>

    <sect2 id="invest_terms2">
      <title>Terminology</title>

      <para>Before discussing investments specifically, it will be helpful to
      present a glossary of investment terminology. The terms presented below
      represent some of the basic concepts of investing. It is a good idea to
      become familiar with these terms, or at least, refer back to this list
      if you encounter an unfamiliar word in the later sections.</para>

      <itemizedlist>
        <listitem>
          <para><emphasis>Capital gains</emphasis> is the difference between
          the purchase and selling prices of an investment. If the selling
          price is lower than the purchase price, this is called a
          <emphasis>capital loss</emphasis>. Also known as <emphasis>realized
          gain/loss</emphasis>.</para>
        </listitem>

        <listitem>
          <para><emphasis>Commission</emphasis> is the fee you pay to a broker
          to buy or sell securities.</para>
        </listitem>

        <listitem>
          <para><emphasis>Common stock</emphasis> is a security that
          represents a certain fractional ownership of a company. This is what
          you buy when you "buy stock" in a company on the open market. This
          is also sometimes known as <emphasis>capital
          stock</emphasis>.</para>
        </listitem>

        <listitem>
          <para><emphasis>Compounding</emphasis> is the concept that the
          reinvested interest can later earn interest of its own (interest on
          interest). This is often referred to as <emphasis>compound
          interest</emphasis>.</para>
        </listitem>

        <listitem>
          <para><emphasis>Dividends</emphasis> are cash payments a company
          makes to shareholders. The amount of this payment is usually
          determined as some amount of the profits of the company. Note that
          not all common stocks give dividends.</para>
        </listitem>

        <listitem>
          <para><emphasis>Equities</emphasis> are investments in which the
          investor becomes part (or whole) owner in something. This includes
          common stock in a company, or real estate.</para>
        </listitem>

        <listitem>
          <para><emphasis>Interest</emphasis> is what a borrower pays a lender
          for the use of their money. Normally, this is expressed in terms of
          a percentage of the principal per year. For example, a savings
          account with 1% interest (you are the lender, the bank is the
          borrower) will pay you $1 for every $100 you keep there per
          year.</para>
        </listitem>

        <listitem>
          <para><emphasis>Liquidity</emphasis> is a measure of how easily
          convertible an investment is to cash. Money in a savings account is
          very liquid, while money invested in a house has low liquidity
          because it takes time to sell a house.</para>
        </listitem>

        <listitem>
          <para><emphasis>Principal</emphasis> is the original amount of money
          invested or borrowed.</para>
        </listitem>

        <listitem>
          <para><emphasis>Realized vs Unrealized Gain/Loss</emphasis>,
          unrealized gain or loss occurs when you've got a change in price of
          an asset. You realize the gain/loss when you actually sell the
          asset. See also <emphasis>capital gain/loss</emphasis>.</para>
        </listitem>

        <listitem>
          <para><emphasis>Return</emphasis> is the total income plus capital
          gains or losses of an investment. See also
          <emphasis>Yield</emphasis>.</para>
        </listitem>

        <listitem>
          <para><emphasis>Risk</emphasis> is the probability that the return
          on investment is different from what was expected. Investments are
          often grouped on a scale from low risk (savings account, government
          bonds) to high risk (common stock, junk bonds). As a general rule of
          thumb, the higher the risk the higher the possible return.</para>
        </listitem>

        <listitem>
          <para><emphasis>Shareholder</emphasis> is a person who holds common
          stock in a company.</para>
        </listitem>

        <listitem>
          <para><emphasis>Stock split</emphasis> occurs when a company offers
          to issue some additional multiple of shares for each existing stock.
          For example, a "2 for 1" stock split means that if you own 100
          shares of a stock, you will receive an additional 100 at no cost to
          you. The unit price of the shares will be adjusted so there is no
          net change in the value, so in this example the price per share will
          be halved.</para>
        </listitem>

        <listitem>
          <para><emphasis>Valuation</emphasis> is the process of determining
          the market value or the price the investment would sell at in a
          <quote>reasonable time frame</quote>.</para>
        </listitem>

        <listitem>
          <para><emphasis>Yield</emphasis> is a measure of the amount of money
          you earn from an investment (IE: how much income you receive from
          the investment). Typically this is reported as a percentage of the
          principal amount. Yield does not include capital gains or loses (see
          Return). Eg: A stock sells for $100 and gives $2 in dividends per
          year has a yield of 2%.</para>
        </listitem>
      </itemizedlist>
    </sect2>

    <sect2 id="invest_types2">
      <title>Types of Investments</title>

      <para>Below is presented some of the broad types of investments
      available, and examples of each type.</para>

      <itemizedlist>
        <listitem>
          <para><emphasis>Interest-bearing account or
          instrument</emphasis></para>

          <para>This type of investment usually allows you immediate access to
          your money, and will typically pay you interest every month based on
          the amount of money you have deposited. Examples are bank savings
          accounts (and some interest bearing checking accounts) and cash
          accounts at your brokerage. This is a very low risk investment, in
          the US these accounts are often insured against loss, to a specified
          limit.</para>

          <para>Sometimes an interest bearing investment is
          <emphasis>time-locked</emphasis>. This type of investment requires
          you to commit your money to be invested for a given period of time
          for which you receive a set rate of return. Usually, the longer you
          commit the higher the interest rates. If you withdraw your money
          before the maturity date, you will usually have to pay an early
          withdrawal penalty. This is a relatively lower risk investment.
          Examples are certificates of deposit or some government bonds. Other
          types of Bonds may have higher yields based on the higher risks from
          the quality of the issuer's <quote>credit rating</quote>.</para>
        </listitem>

        <listitem>
          <para><emphasis>Stocks and Mutual Funds</emphasis></para>

          <para>This is an investment you make in a company, in which you
          effectively become a part owner. There is usually no time lock on
          publicly traded stock, however there may be changes in the tax rates
          you pay on capital gains depending on how long you hold the stock.
          Thus, stocks are typically quite liquid, you can access your money
          relatively quickly. This investment is a higher risk, as you have no
          guarantee on the future price of a stock.</para>

          <para>A mutual fund is a group investment mechanism in which you can
          buy into many stocks simultaneously. For example, a "S&amp;P 500
          index fund" is a fund which purchases all 500 stocks listed in the
          Standard and Poor's index. When you buy a share of this fund, you
          are really buying a small amount of each of the 500 stocks contained
          within the fund. Mutual funds are treated exactly like a single
          stock, both for tax purposes and in accounting.</para>
        </listitem>

        <listitem>
          <para><emphasis>Fixed Assets</emphasis></para>

          <para>Assets that increase in value over time are another form of
          investment. Examples include a house, a plot of land, or a valuable
          painting. This type of investment is very difficult to determine the
          value of until you sell it. The tax implications of selling these
          items is varied, depending on the item. For example, you may have
          tax relief from selling a house if it is your primary residence, but
          may would not receive this tax break on an expensive
          painting.</para>

          <para>Fixed asset investments are discussed in the chapter on
          "Depreciation and Capital Gains". Typically, there is not much to do
          in terms of accounting for fixed asset investments except recording
          the buying and selling transactions.</para>
        </listitem>
      </itemizedlist>
    </sect2>
  </sect1>

  <sect1 id="invest_accounts1">
    <title>Setting Up Accounts</title>

    <para>To setup investment accounts in GnuCash you can either use the
    predefined investment account hierarchy or create your own. The minimum
    you need to do to track investments is to setup an asset account for each
    type of investment you own. However, as we have seen in previous chapters,
    it is usually more logical to create a structured account hierarchy,
    grouping related investments together. For example, you may want to group
    all your publicly traded stocks under a parent account named after the
    brokerage firm you used to buy the stocks.</para>

    <para>Regardless of how you setup your account hierarchy, remember that
    you can always move accounts around later (without losing the work you've
    put into them), so your initial account hierarchy does not have to be
    perfect.</para>

    <sect2 id="invest_predefined2">
      <title>Predefined Accounts</title>

      <para>To use the predefined investment account hierarchy, you
      <emphasis>must</emphasis> create a new GnuCash file. This will run the
      <guilabel>New Account Hierarchy Setup</guilabel> druid. After choosing
      the default currency to use, you will be asked to <guilabel>Choose
      accounts to create</guilabel>. At this point, choose the "Investment
      Accounts" option (along with any others you are interested in). Assuming
      only <quote>Investment Accounts</quote> were selected, this will create
      an account hierarchy as shown below.</para>

      <screenshot id="invest_accountspredef">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_accountspredef.png" format="PNG"
                       srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>Setup Interest Investment</phrase>
          </textobject>

          <caption><para>This is an screen image of the "Accounts" tab after
          creating a new file and selecting only the default investment
          accounts. </para></caption>
        </mediaobject>
      </screenshot>

      <para>You will probably at least want to add a <emphasis>Bank</emphasis>
      account to the Assets and probably an <emphasis>Equity:Opening
      Balance</emphasis> account, as we have done in previous chapters. Don't
      forget to save your new account file with a relevant name!</para>
    </sect2>

    <sect2 id="invest_custom2">
      <title>Custom Accounts Example</title>

      <para>You can also manually setup your own investment account hierarchy.
      The following is a somewhat more complicated example of setting up
      GnuCash to track your investments, which has the advantage that it
      groups each different investment under the brokerage that deals with the
      investments. This way it is easier to compare the statements you get
      from your brokerage with the accounts you have in GnuCash and spot where
      GnuCash differs from the statement. <literallayout>
 Assets
    Investments
       Brokerage Accounts
          I*Trade
             Stocks
                ACME Corp
             Money Market Funds
                I*Trade Municipal Fund
             Cash
          My Stockbroker
             Money Market Funds
                Active Assets Fund
             Government Securities
                Treas Bond xxx
                Treas Note yyy
             Mutual Funds
                Fund A
                Fund B
             Cash
 Income
    Investments
       Brokerage Accounts
          Capital Gains
             I*Trade
             My Stockbroker
          Dividends
             I*Trade
                Taxable
                Non-taxable
             My Stockbroker
                Taxable
                Non-taxable
          Interest Income
             I*Trade
                Taxable
                Non-taxable
             My Stockbroker
                Taxable
                Non-taxable
 Expenses
    Investment Expenses
       Commissions
          I*Trade
          My Stockbroker
       Management Fees
          I*Trade
          My Stockbroker
 </literallayout></para>

      <para>There really is no unique way to set up your investment account
      hierarchy. Play around, try different layouts until you find something
      which divides your investment accounts into logical groups which make
      sense to you.</para>
    </sect2>
  </sect1>

  <sect1 id="invest_int1">
    <title>Interest Bearing Accounts</title>

    <para>Investments which have a fixed or variable rate of interest are one
    of the simplest and most common form of investments available. Interest
    bearing investments include your bank account, a certificate of deposit,
    or any other kind of investment in which you receive interest from the
    principal. This section will describe how to handle these kinds of
    investments in GnuCash.</para>

    <sect2 id="invest_intacct2">
      <title>Account Setup</title>

      <para>When you purchase the interest bearing investment, you must create
      an asset account to record the purchase of the investment, an income
      account to record earnings from interest, and an expense account to
      record bank charges. Below is an account layout example, in which you
      have an interest bearing savings account and a certificate of deposit at
      your bank.</para>

      <literallayout>
Assets
   Bank ABC
      CD
      Savings
Expenses
   Bank ABC
      Charges
Income
   Bank ABC
      Interest
  </literallayout>

      <para>As usual, this account hierarchy is simply presented as an
      example, you should create your accounts in a form which best matches
      your actual situation.</para>
    </sect2>

    <sect2 id="invest-intex2">
      <title>Example</title>

      <para>Now let's populate these accounts with real numbers. Let's assume
      that you start with $10000 in your bank account, which pays 1% interest
      and you buy a $5000 certificate of deposit with a 6 month maturity date
      and a 2% yield. Clearly, it is much better to keep your money in the CD
      than in the savings account. After the initial purchase, your accounts
      should look something like this:</para>

      <screenshot id="invest-int">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_int1.png" format="PNG"
                       srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>Setup Interest Investment</phrase>
          </textobject>

          <caption><para>This is an image of the account register after the
          creation and investing in a CD investment. </para></caption>
        </mediaobject>
      </screenshot>

      <para>Now, during the course of the next 6 month, you receive monthly
      bank statements which describe the activity of your account. In our
      fictional example, we do nothing with the money at this bank, so the
      only activity is income from interest and bank charges. The monthly bank
      charges are $2. After 6 months, the register window for the CD should
      look like this:</para>

      <screenshot id="invest-int2">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_int2.png" format="PNG"
                       srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>Setup Interest Investment</phrase>
          </textobject>

          <caption><para>This is an image of the register of the CD account
          after 6 months. </para></caption>
        </mediaobject>
      </screenshot>

      <para>And this is the main GnuCash window:</para>

      <screenshot id="invest-int3">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_int3.png" format="PNG"
                       srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>Setup Interest Investment</phrase>
          </textobject>

          <caption><para>This a screen capture of the accounts after 6 months.
          </para></caption>
        </mediaobject>
      </screenshot>

      <para>From the above image of the main GnuCash account window you see a
      nice summary of what happened to these investments over the 6 months.
      While the yield on the CD is double that of the savings account, the
      return on the CD was $50.21 versus $13.03 for the savings account, or
      almost 4 times more. Why? Because of the pesky $2 bank charges that hit
      the savings account (which counted for $12 over 6 months).</para>

      <para>After this 6 month period, the CD has reached maturity which means
      you may sell it with no early withdrawal penalty. To do so, simply
      transfer the $5050.21 from the CD account into the savings
      account.</para>
    </sect2>
  </sect1>

  <sect1 id="invest-setup1">
    <title>Setup Investment Portfolio</title>

    <para>Now that you have built an account hierarchy in the previous
    section, this section will show you how to create and populate the accounts with your
    investment portfolio. After this initial setup of your portfolio, you may have
    shares of stock purchased from before you started using GnuCash. For these stocks,
    follow the instructions in the <link linkend="invest-buy-stock2"><emphasis>Entering
    Preexisting Shares</emphasis></link> section below. If your have just purchased your stocks,
    then use the <link linkend="invest-buy-new2"><emphasis>Buying New Shares</emphasis>
    </link> section.</para>

    <sect2 id="invest-setup-stockaccounts2">
      <title>Setup Accounts for Stocks and Mutual Funds</title>

      <para>This section will show you how to add stocks and mutual fund
      accounts to GnuCash. In this section, we will assume you are using the
      basic account setup introduced in the previous section, but
      the principles can be applied to any account hierarchy.</para>

      <para>You should have within the top level <guilabel>Asset</guilabel>
      account, a few levels down, an account entitled
      <guilabel>Stock</guilabel>. Open the account tree to this level by
      clicking on the <quote>right facing triangle marker</quote> signs next
      to the account names until the tree is opened to the depth of the new
      account. You will need to create a sub-account (of type
      <emphasis>stock</emphasis>) under the Stock account for every stock you
      own. Every stock is a separate account. The naming of these stock
      accounts is usually done using the stock ticker abbreviation, though account
      names may be anything that is clear to you and other users. So, for
      example, you could name your accounts <emphasis>AMZN</emphasis>,
      <emphasis>IBM</emphasis> and <emphasis>NST</emphasis> for your Amazon,
      IBM and NSTAR stocks respectively. Below is a schematic model of the
      layout (only showing the Assets sub-accounts).</para>

      <literallayout>
 Assets
    Investments
       Brokerage Accounts
          Bond
          Mutual Funds
          Market Index
          Stock
             AMZN
             IBM
             NST
 </literallayout>

      <note>
        <para>If you want to track income (dividends/interest/capital gains)
        on a per-stock or fund basis, you will need to create an
        Income:Dividends:STOCKSYMBOL, Income:Cap Gain (Long):STOCKSYMBOL,
        Income:Cap Gain (Short):STOCKSYMBOL and Income:Interest:STOCKSYMBOL
        account for each stock you own that pays dividends or interest.</para>
      </note>
    </sect2>

    <sect2 id="invest-setup-example2">
      <title>Example Stock Account</title>

      <para>As an example, let's assume that you currently own 100 shares of
      Amazon stock. First, create the stock account AMZN by selecting the
      <guilabel>Stock</guilabel> account and click on the menu
      <guimenu>File</guimenu> -&gt; <guimenu>New Account</guimenu>. The New
      Account dialog will appear, follow the steps, in the sequence below to
      setup your new stock account.</para>

      <screenshot id="invest-newaccount">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_newaccount.png" format="PNG"
                       srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>New Account Window</phrase>
          </textobject>

          <caption><para>New Account Window </para></caption>
        </mediaobject>
      </screenshot>

      <orderedlist>
        <listitem>
          <para><emphasis>Account Name</emphasis> - Usually, use the stock
          ticker abbreviation, IE: <quote>AMZN</quote></para>
        </listitem>

        <listitem>
          <para><emphasis>Account Code</emphasis> - Optional field, use CUSIP,
          the newspaper listing symbol, mutual fund family ID or code of your
          own choosing.</para>
        </listitem>

        <listitem>
          <para><emphasis>Description</emphasis> - Optional field for detailed
          description of the commodity/stock. Note this field by default is
          displayed in the Account tab tree.</para>
        </listitem>

        <listitem>
          <para><emphasis>Account Type</emphasis> - Select the type of account
          you are creating from the lower left-hand list.</para>
        </listitem>

        <listitem>
          <para><emphasis>Parent Account</emphasis> - Select the parent
          account for the new account from the right hand listing. Expand list
          of accounts if necessary.</para>
        </listitem>

        <listitem>
          <para><emphasis>Create the New Security</emphasis> - To use a new
          stock, you must create the stock as a new commodity</para>

          <itemizedlist>
            <listitem>
              <para><emphasis>Select Security/Currency</emphasis> - Click on
              the <quote>Select ...</quote> button next to the
              <guilabel>security/currency</guilabel> line. We must change the
              security from the default (your default currency) to this
              specific stock. This will bring up the <quote>Select
              Security</quote> dialog.</para>
            </listitem>

            <listitem>
              <para><emphasis>Type</emphasis> - Change the
              <guilabel>type</guilabel> from current to the exchange where the
              security/commodity is traded (in this example NASDAQ).</para>

              <para>Select the <quote>New</quote> Button to open the
              <quote>New Security</quote> window.</para>

              <screenshot id="invest-selectsecurity">
                <mediaobject>
                  <imageobject>
                    <imagedata fileref="figures/invest_selectsecurity.png"
                               format="PNG" srccredit="Dave Herman" ></imagedata>
                  </imageobject>

                  <textobject>
                    <phrase>Select Security Window</phrase>
                  </textobject>

                  <caption><para>Select Security Window </para></caption>
                </mediaobject>
              </screenshot>
            </listitem>

            <listitem>
              <para><emphasis>Create the Security</emphasis> - Click on the
              <guilabel>New...</guilabel> button and enter the appropriate
              information for this stock on the new form <guilabel>New
              Security</guilabel>.</para>

              <!--  Open inter most loop (#3)
-->

              <itemizedlist>
                <listitem>
                  <para>The <guilabel>Full name:</guilabel> is
                  <quote>Amazon.com Inc</quote>.</para>
                </listitem>

                <listitem>
                  <para>The <guilabel>Symbol/abbreviation:</guilabel> is
                  <quote>AMZN</quote>.  The symbol is the stock ticket used in your
                  quote source several lines down on the form.  Note that different
                  symbols will be utilized on different price sources for the same stock,
                  an example is Ericsson on the Stockholm Exchange is ERIC-B while
                  on Yahoo it is ERRICB.ST</para>
                </listitem>

                <listitem>
                  <para>The <guilabel>Type:</guilabel> should already be
                  <quote>NASDAQ</quote>.</para>
                </listitem>

                <listitem>
                  <para>The <guilabel>CUSIP or other code</guilabel> is where
                  you can enter some other coding number or text (leave it
                  blank in this example).</para>
                </listitem>

                <listitem>
                  <para>The <guilabel>Fraction traded</guilabel> should be
                  adjusted to the smallest fraction of this security which can
                  be traded, usually 1/100 or 1/10000.</para>
                </listitem>

                <listitem>
                  <para>The box <quote>Get On-line Quotes</quote> and the
                  quote source and the timezone should be selected to define
                  the sources for updating prices on-line. See Also
                  <link linkend="invest-stockprice-auto2">
                    <quote>Setting Stock Price Automatically</quote></link>.</para>

                  <para> If the <quote>Get On-Line Quotes</quote> is not highlighted, and it
                  is not tickable, then the Finance::Quote package is not installed.
                  See the section on
                   <link linkend="invest-stockprice-auto-install3">
                    <quote>Installing Finance::Quote</quote></link>.</para>

                  <para>Below is what this window should look like when
                  finished: <screenshot id="invest-newsecurity">
                      <mediaobject>
                        <imageobject>
                          <imagedata fileref="figures/invest_newsecurity.png"
                                     format="PNG" srccredit="Dave Herman" ></imagedata>
                        </imageobject>

                        <textobject>
                          <phrase>New Security Window</phrase>
                        </textobject>

                        <caption><para>New Security Window </para></caption>
                      </mediaobject>
                    </screenshot></para>
                </listitem>

                <listitem>
                  <para><emphasis>Save Security</emphasis> - Click on the
                  <guilabel>OK</guilabel> button to save this new security,
                  this will close the <quote>New Security</quote> window and
                  return to the <quote>New Account</quote> window.</para>
                </listitem>
              </itemizedlist>

              <!--  Close inter most loop
-->
            </listitem>

            <!--  Close loop #2
-->
          </itemizedlist>
        </listitem>

        <listitem>
          <para><emphasis>Select the Security</emphasis> - you should now see
          the newly created security available in the pull down menu for
          <guilabel>Security/Currency</guilabel>. Select it (it is probably
          already selected) and click on <guilabel>OK</guilabel>.</para>
        </listitem>

        <listitem>
          <para><emphasis>Smallest Fraction</emphasis> - Specify the smallest
          fraction of the security/commodity that is traded.</para>
        </listitem>

        <listitem>
          <para><emphasis>Notes</emphasis> - Enter any notes or messages
          related to this security/commodity.</para>
        </listitem>

        <listitem>
          <para><emphasis>Tax Related</emphasis> - Check box if this account's
          transactions will relate to Tax Reports.</para>
        </listitem>

        <listitem>
          <para><emphasis>Placeholder</emphasis> - Check box if this account
          is a <quote>Placeholder</quote>, that is it will contain no
          transactions.</para>
        </listitem>

        <listitem>
          <para><emphasis>Finished</emphasis> - You should now have been
          automatically returned to the New Account dialog, with the
          <guilabel>symbol/abbreviation:</guilabel> line set to <quote>AMZN
          (Amazon.com Inc)</quote>. Click on <guilabel>OK</guilabel> to save
          this new stock account.</para>
        </listitem>

        <!--
                    Outer list can now be closed
-->
      </orderedlist>

      <para>You have now created the Amazon stock account, your main account
      should look something like this (notice that there are a few extra
      accounts here, a bank account, and an equity account):</para>

      <screenshot id="invest-setup-current">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_setup_current.png" format="PNG"
                       srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>Setup Current Portfolio</phrase>
          </textobject>

          <caption><para>This image is after the creation of the first stock
          account (AMZN)</para></caption>
        </mediaobject>
      </screenshot>

      <para>Open the account register window for this AMZN stock account
      (double click on it). Here you see the <emphasis
      role="strong">Portfolio</emphasis> view. This gives you an overview of
      your stock portfolio including the number of shares bought and sold.
      Obviously, we have not bought or sold any stocks yet, so the Portfolio
      view should not contain any transactions.</para>
    </sect2>
  </sect1>

  <sect1 id="invest-buy-stock1">
    <title>Buying Shares</title>

    <sect2 id="invest-buy-stock2">
      <title>Entering Preexisting Shares</title>

      <para>To register the initial 100 shares of this stock that you
      purchased previously, on the first transaction line, enter the date of
      the purchase (eg: Jan. 1 2001), a description (eg: Initial Purchase),
      transfer from <emphasis>Equity: Opening Balances</emphasis>, Shares (eg:
      100), and Price (eg: $20). You do not need to fill in the
      <guilabel>Buy</guilabel> column, as it will be calculated for you. This example 
      assumed there was no commission on this transaction to simplify the example. Your
      AMZN Portfolio view should now appear like this:</para>

      <screenshot id="invest-setup-portfolio1">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_setup_portfolio1.png"
                       format="PNG" srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>Setup Current Portfolio</phrase>
          </textobject>

          <caption><para>This image is of the transaction register of the AMZN account
          after the first stock account <quote>purchase</quote>.</para></caption>
        </mediaobject>
      </screenshot>

      <para>Notice that the <guilabel>Balance</guilabel> is in the units of
      the commodity (AMZN shares) not in currency units. Thus, the balance is
      100 (AMZN units) rather than $2000. This is how it should be.</para>
    </sect2>

    <sect2 id="invest-buy-new2">
      <title>Buying New Shares</title>

      <para>The only difference between setting up a new stock purchase
      versus the setup for preexisting stocks as described in the previous
      section is that instead of transferring the money used to purchase the
      stock from the Equity:Opening Balance account, you use your Assets:Bank ABC
      account.</para>

      <para>Now you will purchase $5000 of IBM stock, with a commission of $100.  First 
      step will be to create the stock account for IBM.  The existing Expense:Commission
      account will be used.  If you wish to track commissions to the individual stock
      an additional sub-account would be necessary.</para>

      <para>Now for the transaction, on the first transaction line, enter the date of
      the purchase (eg: Jan. 3 2005), a description (eg: Initial Purchase),
      Shares will be skipped (to be calculated), Price (eg: $96.60), and Buy ($5000).
      You do not need to fill in the <guilabel>Share</guilabel> column, as it will be
      calculated for you. The next line in the split transaction will be 
      <quote>Expense:Commission</quote> and fill in Buy ($100).
      The third line will be to transfer from <emphasis>Assets:Bank ABC:Saving</emphasis>,
      $5100 to balance the transaction.
      Your IBM Portfolio view should now appear like this:</para>

      <screenshot id="invest-setup-portfolio2">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_setup_portfolio2.png"
                       format="PNG" srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>Setup Current Portfolio</phrase>
          </textobject>

          <caption><para>This image is of the transaction register of the IBM account
          after the first stock account <quote>purchase</quote> with a commission.</para>
          </caption>
        </mediaobject>
      </screenshot>

    </sect2>
  </sect1>

  <sect1 id="invest-stockprice1">
    <title>Setting Share Price</title>

    <para>The value of a commodity, such as a stock, must be explicitly set.
    The stock accounts track the quantity of stocks you own, but the value of
    the stock is stored in the <emphasis>Price Editor</emphasis>. The values
    set in the Price Editor can be updated manually or automatically.</para>

    <sect2 id="invest-stockprice-initial2">
      <title>Initial Price Editor Setup</title>

      <para>To use the Price Editor to track a stock value, you must initially
      insert the stock. To do so, open the Price Editor
      (<guimenu>Tools</guimenu> -&gt; <guimenu>Price Editor</guimenu>) and
      click on <guibutton>Add</guibutton> button. The first time a
      Commodity/Stock is entered this window will be blank except for the
      control buttons on the bottom. Select the appropriate Commodity you want
      to insert into the Price Editor. At this point, you can input the price
      of the commodity manually. There are 5 fields in the New Commodity
      window:</para>

      <itemizedlist>
        <listitem>
          <para><guilabel>Commodity</guilabel> - the name of the commodity,
          must be chosen from the <guibutton>Select...</guibutton> list</para>
        </listitem>

        <listitem>
          <para><guilabel>Currency</guilabel> - the currency in which the
          Price is expressed.</para>
        </listitem>

        <listitem>
          <para><guilabel>Date</guilabel> - date that the price is
          valid</para>
        </listitem>

        <listitem>
          <para><guilabel>Type</guilabel> - one of: <guilabel>Bid</guilabel>
          (the market buying price), <guilabel>Ask</guilabel> (the market
          selling price), <guilabel>Last</guilabel> (the last transaction
          price), <guilabel>Net Asset Value</guilabel> (mutual fund price per
          share), or <guilabel>Unknown</guilabel>. Stocks and currencies will
          usually give their quotes as one of bid, ask or last. Mutual funds
          are often given as net asset value. For other commodities, simply
          choose "Unknown". This option is for informational purposes only, it
          is not used by GnuCash.</para>
        </listitem>

        <listitem>
          <para><guilabel>Price</guilabel> - the price of one unit of this
          commodity.</para>
        </listitem>
      </itemizedlist>

      <para>As an example of adding the AMZN commodity to the price editor,
      with an initial value of $40.50 per share.</para>

      <screenshot id="invest-peditor">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_peditor.png" format="PNG"
                       srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>Price Editor</phrase>
          </textobject>

          <caption><para>Adding the AMZN commodity to the price editor, with
          an initial value of $40.50 per share.</para></caption>
        </mediaobject>
      </screenshot>

      <para>Click <guibutton>OK</guibutton> when finished. Once you have
      performed this initial placement of the commodity into the Price Editor,
      you will not have to do it again, even if you use the same commodity in
      another account.</para>
    </sect2>

    <sect2 id="invest-stockprice-manual2">
      <title>Setting Stock Price Manually</title>

      <para>If the value of the commodity (stock) changes, you can adjust the
      value by entering the Price Editor, selecting the commodity, clicking on
      <guibutton>edit</guibutton> and entering the new price.</para>

      <screenshot id="invest-peditor2">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_peditor2.png" format="PNG"
                       srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>Price Editor</phrase>
          </textobject>

          <caption><para>The main price editor window, showing the list of all
          known commodities.</para></caption>
        </mediaobject>
      </screenshot>
    </sect2>

    <sect2 id="invest-stockprice-auto2">
      <title>Configuring for automatic retrieval of quotes</title>

      <para>If you have more than a couple of commodities, you will tire of
      having to update their prices constantly. GnuCash has the ability to
      automatically download the most recent price for your commodities using
      the Internet. This is accomplished through the Perl module
      Finance::Quote, which must be installed in order to activate this
      feature.</para>

      <para>To determine if the Perl module Finance::Quote is already
      installed on your system, type <quote>perldoc Finance::Quote</quote> in
      a terminal window and check to see if there is any documentation
      available. If you see the documentation, then the module is installed,
      if you do not see the documentation, then it has not been
      installed.</para>

      <sect3 id="invest-stockprice-auto-install3">
        <title>Installing Finance::Quote</title>

        <para>To install Finance::Quote begin by first closing any GnuCash
        applications you have running. Second, locate the folder where GnuCash
        is installed by searching for <quote>gnc-fq-update</quote> (without the quotes).
        Change to that directory, open a root shell and run the command
        <quote>gnc-fq-update</quote> (without the quotation marks). This will
        launch a Perl CPAN update session that will go out onto the Internet
        and install the Finance::Quote module on your system. The
        gnc-fq-update program is interactive, however, with most systems you
        should be able to answer <quote>no</quote> to the first question: <quote>Are you
        ready for manual configuration? [yes]</quote> and the update will
        continue automatically from that point.</para>

        <para>After installation is complete, you should run the <quote>gnc-fq-dump</quote>
        test program, in the same directory, distributed with GnuCash to test
        if Finance::Quote is installed and working properly.</para>

        <note>
          <para>If you feel uncomfortable about performing any of these steps,
          please either email the GnuCash-user mailing list
          (gnucash-user@gnucash.org) for help or come to the GnuCash IRC
          channel on irc.gnome.org. You can also leave out this step and
          manually update your stock prices.</para>
        </note>
      </sect3>

      <sect3 id="invest-stockprice-auto-configure3">
        <title>Configuring Finance::Quote</title>

        <para>With Finance::Quote installed and functioning correctly, you
        must configure your GnuCash stock accounts to use this feature to
        obtain updated price information automatically. For stock accounts
        that have already been setup, <guibutton>edit</guibutton> the account
        and select the <guilabel>Get On-line Quotes</guilabel> box. You should
        now be able to modify the pop-up menus <guilabel>The source for price
        quotes</guilabel> and <guilabel>The timezone for these
        quotes</guilabel>. When finished editing the stock account, return to
        the price editor and click on the <guibutton>Get Quotes</guibutton>
        button to update your stock prices on the Internet.</para>

        <para>The command <quote>gnucash --add-price-quotes $HOME/gnucash-filename</quote>
        can be used to fetch the current prices of your stocks.  The file specified
        <quote>$HOME/gnucash-filename</quote> will depend on the name and location of your
        data file.
        This can be determined by the name displayed in the top frame of the GnuCash window,
        before the <quote>-</quote>.  The file name can also be found <quote>File -&gt;</quote>
        <quote>pull down list</quote>, the first item, numbered 1, is the name of the currently
        open file.</para>

        <para>This can be automated by creating a crontab entry. For example,
        to update your file every Friday evening (16:00) after the relevant exchange
        markets close (modify the time accordingly for your time zone), you could add
        the following to your personal crontab:</para>

        <para>0 16 * * 5 gnucash --add-price-quotes $HOME/gnucash-filename &gt;
        /dev/null 2&gt;&amp;1</para>

        <para>Remember that Mutual Fund <quote>prices</quote> are really <quote>Net Asset
        Value</quote> and require several hours after the exchange closes before being
        available. If NAVs are downloaded before the current days NAVs are
        determined, yesterday's NAVs are retrieved.</para>
      </sect3>
    </sect2>

    <sect2 id="invest-stockprice-view2">
      <title>Displaying Share Value</title>

      <para>The main account window, by default, only shows the quantity of
      each commodity that you own, under the column heading
      <guilabel>Total</guilabel>. In the case of stocks, this commodity is the
      number of shares. Often, however, you will want to see the value of your
      stocks expressed in terms of some monetary unit. This is easily
      accomplished by entering the main window, selecting the <quote>Accounts</quote> tab,
      by clicking on the title bar <guibutton>Options</guibutton> button (the small
      down pointing arrow on the right side of the main account window titles bar), and
      selecting the option to display the account total field <quote>Total
      (USD)</quote>. You will see a new column in the main window entitled
      <guilabel>Total (USD)</guilabel> that will express the value of all
      commodities in the report currency.</para>

      <screenshot id="invest-stockvalue">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_stockvalue.png" format="PNG"
                       srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>Viewing Stock Value</phrase>
          </textobject>

          <caption><para>Viewing the value of a stock commodity in the main
          window using the Total in Report Currency option.</para></caption>
        </mediaobject>
      </screenshot>
    </sect2>

    <sect2 id="invest-stockprice-report">
      <title>Making Stock Value Reports</title>

      <para>GnuCash offers three alternatives to determine stock prices in
      reports:</para>

      <screenshot id="invest-stockvalue-report-options">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_stockvalue_report_options.png"
                       format="PNG" srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>Determining Stock Price Source in Reports</phrase>
          </textobject>

          <caption><para>Determining the value of a stock commodity in a
          report by setting the Price Source option.</para></caption>
        </mediaobject>
      </screenshot>

      <itemizedlist>
        <listitem>
          <para><guilabel>Weighted Average</guilabel> - gives you a graph of
          the weighted price of all <emphasis>transactions</emphasis>. It will
          <emphasis>not</emphasis> take into account prices defined in the
          price editor.</para>
        </listitem>

        <listitem>
          <para><guilabel>Most recent</guilabel> - displays the changing value
          of your stocks based solely on <emphasis>the most recent</emphasis>
          price available from the price editor. The price figuring in your
          stock transactions is <emphasis>not</emphasis> considered.</para>
        </listitem>

        <listitem>
          <para><guilabel>Nearest in time</guilabel> - the graph is
          exclusively based on the prices available from the price editor. The
          value of your stock at each step and point in time is calculated
          based on the nearest available price in the price editor.</para>
        </listitem>
      </itemizedlist>

      <screenshot id="invest-stockvalue-report">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_stockvalue_report.png"
                       format="PNG" srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>An Asset Barchart Report based on the <guilabel>Nearest in
            time</guilabel> Price Source.</phrase>
          </textobject>

          <caption><para>Tracking what value your stocks would've had on the
          stock exchanges.</para></caption>
        </mediaobject>
      </screenshot>
    </sect2>
  </sect1>

  <sect1 id="invest-sell1">
    <title>Selling Shares</title>

    <para>Entering an investment you are selling is done in the same way as
    buying one except the total cost of the transaction is entered in the
    <emphasis>Sell</emphasis> column and the <emphasis>Shares</emphasis>
    column is entered as a negative amount. The net proceeds from the sale
    should be transferred from the stock account to your bank or brokerage
    account.</para>

    <para>The proper recording of the stock sale *must* be done using a split
    transaction. In the split transaction, you must account for the profit (or
    loss) as coming from an Income:Capital Gains account (or Expense:Capital
    Loss). To balance this income, you will need to enter the stock asset
    twice in the split. Once to record the actual sale (using the correct
    number of shares and correct price per share) and once to balance the
    income profit (setting the number of shares to 0 and price per share to
    0).</para>

    <para>In the split transaction scheme presented below, the symbol
    NUM_SHARES is the number of shares you are selling, SELL_PRICE is the
    price for which you sold the shares, GROSS_SALE is the total price for
    which you sold shares, equal to NUM_SHARES*SELL_PRICE. PROFIT is the
    amount of money you made on the sale. COMMISSIONS are the brokerage
    commissions. NET_SALE is the net amount of money received from the sale,
    equal to GROSS_SALE - COMMISSIONS.</para>

    <table>
      <title>Selling Stock using Split Transaction Scheme</title>

      <tgroup cols="5">
        <tbody>
          <row>
            <entry><emphasis>Account</emphasis></entry>

            <entry><emphasis>Number of Shares</emphasis></entry>

            <entry><emphasis>Share Price</emphasis></entry>

            <entry><emphasis>Total Buy</emphasis></entry>

            <entry><emphasis>Total Sell</emphasis></entry>
          </row>

          <row>
            <entry>Assets:Bank</entry>

            <entry></entry>

            <entry></entry>

            <entry>NET_SALE</entry>

            <entry></entry>
          </row>

          <row>
            <entry>Assets:Stock:SYMBOL</entry>

            <entry>-NUM_SHARES</entry>

            <entry>SELL_PRICE</entry>

            <entry></entry>

            <entry>GROSS_SALE</entry>
          </row>

          <row>
            <entry>Assets:Stock:SYMBOL</entry>

            <entry>0</entry>

            <entry>0</entry>

            <entry>PROFIT</entry>

            <entry>(Loss)</entry>
          </row>

          <row>
            <entry>Income:Capital Gains</entry>

            <entry></entry>

            <entry></entry>

            <entry>(Loss)</entry>

            <entry>PROFIT</entry>
          </row>

          <row>
            <entry>Expenses:Commissions</entry>

            <entry></entry>

            <entry></entry>

            <entry>COMMISSION</entry>

            <entry></entry>
          </row>
        </tbody>
      </tgroup>
    </table>

    <para>If you will be recording the sale of the stock as a capital gain (or
    loss), please see the chapter <quote>Depreciation and Capital Gains</quote> for more
    information on this topic.</para>

    <sect2 id="invest-sellexample2">
      <title>Example - Sale of stock with profit</title>

      <para>As an example, assume you bought 100 shares of a stock for $20 per
      share, then later sell them all for $36 per share. In the split
      transaction scheme above, PRICEBUY is $20 (the original buying price),
      NUM_SHARES is 100, TOTALBUY is $2000 (the original buying cost),
      GROSS_SALE is $3600, and finally PROFIT is $1525
      (GROSS_SALE-TOTALBUY-COMMISSION).</para>

      <table>
        <title>Selling Stock Split Transaction Scheme</title>

        <?dbhtml table-width="50%" ?>

        <?dbfo table-width="50%" ?>

        <tgroup cols="5">
          <tbody>
            <row>
              <entry><emphasis>Account</emphasis></entry>

              <entry><emphasis>Shares</emphasis></entry>

              <entry><emphasis>Price</emphasis></entry>

              <entry><emphasis>Buy</emphasis></entry>

              <entry><emphasis>Sell</emphasis></entry>
            </row>

            <row>
              <entry>Assets:Bank</entry>

              <entry></entry>

              <entry></entry>

              <entry>3525.00</entry>

              <entry></entry>
            </row>

            <row>
              <entry>Assets:Stock:SYMBOL</entry>

              <entry>-100</entry>

              <entry>36.00</entry>

              <entry></entry>

              <entry>3600.00</entry>
            </row>

            <row>
              <entry>Assets:Stock:SYMBOL</entry>

              <entry>0</entry>

              <entry>0</entry>

              <entry>1600.00</entry>

              <entry></entry>
            </row>

            <row>
              <entry>Income:Capital Gains</entry>

              <entry></entry>

              <entry></entry>

              <entry></entry>

              <entry>1600.00</entry>
            </row>

            <row>
              <entry>Expenses:Commissions</entry>

              <entry></entry>

              <entry></entry>

              <entry>75.00</entry>

              <entry></entry>
            </row>
          </tbody>
        </tgroup>
      </table>

      <screenshot id="invest-sellstock">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_sellstock.png" format="PNG"
                       srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>Selling Stock Example</phrase>
          </textobject>

          <caption><para>An example of selling stock for gain. You bought 100
          shares of AMZN for $20 per share, and sold for $36.</para></caption>
        </mediaobject>
      </screenshot>

      <screenshot id="invest-sellstock2">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_sellstock2.png" format="PNG"
                       srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>Selling Stock Example</phrase>
          </textobject>

          <caption><para>An image of the account tree after the example of
          selling stock for gain. </para></caption>
        </mediaobject>
      </screenshot>
    </sect2>

    <sect2 id="invest-sellexampleloss">
      <title>Example - Sale of stock with loss</title>

      <para>As an example, assume you bought 100 shares of a stock for $100
      per share, then later sell them all for $50 per share. In the split
      transaction scheme below, PRICEBUY is $100 (the original buying price),
      NUM_SHARES is 100, TOTAL_BUY is $10,000 (the original buying price),
      (Loss) is $5000, and finally GROSS_SALE is $5000. Assume the commission
      was $100.00.</para>

      <table>
        <title>Selling Shares at loss Split Transaction Scheme</title>

        <?dbhtml table-width="50%" ?>

        <?dbfo table-width="50%" ?>

        <tgroup cols="5">
          <tbody>
            <row>
              <entry><emphasis>Account</emphasis></entry>

              <entry><emphasis>Shares</emphasis></entry>

              <entry><emphasis>Price</emphasis></entry>

              <entry><emphasis>Buy</emphasis></entry>

              <entry><emphasis>Sell</emphasis></entry>
            </row>

            <row>
              <entry>Assets:Bank</entry>

              <entry></entry>

              <entry></entry>

              <entry>4900.00</entry>

              <entry></entry>
            </row>

            <row>
              <entry>Assets:Stock:SYMBOL</entry>

              <entry>-100</entry>

              <entry>50.00</entry>

              <entry></entry>

              <entry>5000.00</entry>
            </row>

            <row>
              <entry>Assets:Stock:SYMBOL</entry>

              <entry>0</entry>

              <entry>0</entry>

              <entry></entry>

              <entry>5000.00</entry>
            </row>

            <row>
              <entry>Income:Capital Gains</entry>

              <entry></entry>

              <entry></entry>

              <entry>5000.</entry>

              <entry>0</entry>
            </row>

            <row>
              <entry>Expenses:Commissions</entry>

              <entry></entry>

              <entry></entry>

              <entry>100</entry>

              <entry></entry>
            </row>
          </tbody>
        </tgroup>
      </table>

      <para>Note: You may either enter the loss as a positive number in the
      <quote>buy</quote> column or as a negative number in the <quote>sell</quote>
      column, GnuCash will move the <quote>negative profit</quote> to the other column.</para>

      <screenshot id="invest-sellstockLoss">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_sellstockLoss.png" format="PNG"
                       srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>Selling Stock at loss Example</phrase>
          </textobject>

          <caption><para>Above is a screenshot of the example of selling
          stock. You bought 100 shares for $100.00 per share, and sold for
          $50.</para></caption>
        </mediaobject>
      </screenshot>

      <screenshot id="invest-sellstockLoss2">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_sellstockLoss2.png"
                       format="PNG" srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>Selling Stock at loss Example</phrase>
          </textobject>

          <caption><para>An image of the account tree after the example of
          selling stock for loss. </para></caption>
        </mediaobject>
      </screenshot>
    </sect2>
  </sect1>

  <sect1 id="invest-dividends1">
    <title>Dividends</title>

    <para>Some companies or mutual funds pay periodic dividends to
    shareholders. Dividends are typically given in one of two ways, either
    they are automatically reinvested into the commodity or they are given as
    cash. Mutual funds are often setup to automatically reinvest the dividend,
    while common stock dividends usually pay cash.</para>

      <sect2 id="invest-dividendcash">
        <title>Dividends in Cash</title>

      <para>If the dividend is presented as cash, you should record the
      transaction directly in the asset account that received the money, as
      income from <quote>Income::Dividends</quote> with a note mentioning from which
      commodity it was derived. There is no simple way to show this transaction
      from within the stock or mutual fund account itself.</para>

      <para>As an example consider the following; a purchase of IBM stock with the dividends
      deposited as cash into the Broker Account.</para>

      <screenshot id="invest-dividendcash1">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_dividendcash.png"
                       format="PNG" srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>Example of cash dividend transactions</phrase>
          </textobject>

          <caption><para>An image of the Brokerage Account register after a series of cash
          dividends. </para></caption>
        </mediaobject>
      </screenshot>

    <note>
      <para>If you want to track dividends on a per-stock basis, you would
      need to create an Income:Dividends:STOCKSYMBOL account for each stock
      you own that pays dividends.</para>
    </note>

    </sect2>

    <sect2 id="invest-dividendreinvest">
      <title>Dividends Re-Invested</title>

      <para>If you receive the dividend in the form of an automatic
      reinvestment, the transaction for this should be handled within
      the stock or mutual fund account as income from <quote>Income:Dividend</quote> for the
      appropriate number of reinvested shares.  This type of reinvest account is often referred
      to as a DRIP (Dividend Re-Investment Program).</para>

      <para>As an example consider the following; purchase of NSTAR (NST) stock with the
      dividends reinvested into a DRIP Account.  Mutual fund re-investments would be the same.
      </para>

      <para>Starting with the purchase of 100 shares on Jan. 3, 2005, all dividends will be
      reinvested and an account is created to track the dividend to the specific stock.  GnuCash
      simplifies the entry by allowing calculations within the cells of the transaction.  If the
      first dividend is $.29/share, enter $53.38 in the share price and 100*.29 in the Buy cell.
      </para>

      <screenshot id="invest-dividendreinvest1">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_dividendreinvest1.png"
                       format="PNG" srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>Example of dividend reinvestment transactions</phrase>
          </textobject>

          <caption><para>An image of the Stock Account register after a series of
          dividends reinvestment. </para></caption>
        </mediaobject>
      </screenshot>

      <screenshot id="invest-dividendreinvest2">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_dividendreinvest2.png"
                       format="PNG" srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>Example of dividend reinvestment transactions</phrase>
          </textobject>

          <caption><para>An image of the Accounts tree after a series of
          dividends reinvestment. </para></caption>
        </mediaobject>
      </screenshot>

    </sect2>

  </sect1>

<!--  Stock Splits - Simple

-->

  <sect1 id="invest-splitsnmergers1">
    <title>Splits and Mergers</title>

    <para>Companies may split their stock for many reasons but the most common
    is that the price has risen higher than management thinks is a reasonable price for
    many investors. Some of these splits are simple exchanges (eg 2 for 1 or 3 for 2)
    and some are complex exchanges with cash distributions.  Splits may also result in
    fewer shares if the exchange rate is a reverse split (1 for 3 or .75 for 1).

    </para>

      <sect2 id="invest-simplesplit">
        <title>Simple Stock Split</title>

      <para>As an example, our holding of NST stock declared a 2 for 1 stock split effective
      June 6, 2005.  The process for entering this transaction is; select 
      <guimenu>Action</guimenu> -&gt; <guimenu>Stock Split</guimenu> to start
      the druid.</para>

      <screenshot id="invest-split1">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_split1.png"
                       format="PNG" srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>An image of the stock split druid at step 1. </phrase>
          </textobject>

          <caption><para>An image of the selection of the stock split druid. </para></caption>
        </mediaobject>
      </screenshot>

      <para>The first screen is an Introduction, select <guimenu>Forward</guimenu> to
      display the selection of the account and stock for the split.  You will need to
      create an entry for each <emphasis>Account:Stock</emphasis> combination you hold.</para>

      <screenshot id="invest-split2">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_split2.png"
                       format="PNG" srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>An image of the stock split druid at step 2 - Selection of Account/Stock.
            </phrase>
          </textobject>

          <caption><para>An image of the stock split druid at step 2 - Selection of 
           Account/Stock.</para></caption>
        </mediaobject>
      </screenshot>


      <para>Select the <quote>Assets:Investments:DRIPs:NST</quote> and click on
      <guimenu>Forward</guimenu>.</para>

      <para>The next screen presents 5 fields in the Stock Splits Details window:</para>

      <itemizedlist>
        <listitem>
          <para><guilabel>Date</guilabel> - Enter the date of the split.</para>
        </listitem>

        <listitem>
          <para><guilabel>Shares</guilabel> -  The number of shares increased (or decreased)
          in the transaction.</para>
          <para>In our example it is a 2 for 1 split so the number of additional shares
          is the number of shares currently in the register.</para>
        </listitem>

        <listitem>
          <para><guilabel>Description</guilabel> - The Description should give a brief
          explanation of the transaction.</para>
        </listitem>

        <listitem>
          <para><guilabel>New Price</guilabel> - If desired the new price of the stock,
          after the split, may be entered.</para>
        </listitem>

        <listitem>
          <para><guilabel>Currency</guilabel> - The currency of the transaction
          is required.  This should be the same as the stock purchase currency.</para>
        </listitem>

      </itemizedlist>
            
      <para>Click on the <guimenu>Forward</guimenu> button.</para>

      <screenshot id="invest-split3">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_split3.png"
                       format="PNG" srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>An image of the stock split druid at step 3 - Split Details. </phrase>
          </textobject>

          <caption><para>An image of the stock split druid at step 3 - Split Details. </para>
          </caption>
        </mediaobject>
      </screenshot>


      <para>The next screen will be skipped in this example as there was no
      <quote>Cash in Lieu</quote>.
      </para>

      <screenshot id="invest-split4">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_split4.png"
                       format="PNG" srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>An image of the stock split druid at step 4 - Cash in Lieu. </phrase>
          </textobject>

          <caption><para>An image of the stock split druid at step 4 - Cash in Lieu. </para>
          </caption>
        </mediaobject>
      </screenshot>

      <para>A final <quote>Finish</quote> screen will give a last option to;
       <guimenu>Cancel</guimenu>, <guimenu>Back</guimenu> to modify any data entered or
       <guimenu>Apply</guimenu> to complete the stock split with the data entered. </para>

      <screenshot id="invest-simplesplit1">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_simplesplit1.png"
                       format="PNG" srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>Example of simple stock split transaction in the stock's register</phrase>
          </textobject>

          <caption><para>An image of the <quote>Assets:Investments:DRIPs:NST</quote>
          register after a simple stock split transaction. </para></caption>
        </mediaobject>
      </screenshot>

    </sect2>

<!--  Moderately Complex Stock Merger

-->

      <sect2 id="invest-merger1">
        <title>Moderately Complex Stock Merger</title>

      <para>As an example, assume you held AT&amp;T stock during the Nov. 18, 2005 merger of SBC
      with AT&amp;T. For this example you will have purchased AT&amp;T on April 1, 2005, any
      dividends will have been paid in cash, therefore not entered into the AT&amp;T
      stock register. </para>

      <para> The conditions of the merger were .77942 share of SBC stock were exchanged for
      each share of AT&amp;T stock.  The merged company continued to use the symbol
      <quote>T</quote> from AT&amp;T.</para>

      <para>AT&amp;T paid a <quote>dividend</quote> of $1.20/share on the transaction date,
      however this will not appear in the stock account as it was a cash distribution.</para>

      <para>The process for entering this transaction is identical to the simple split until
      the <quote>Details</quote> screen.  You will need to create an split entry in each
      <emphasis>Investment Account:Stock</emphasis> account combination that has shares
      splitting.</para>

      <screenshot id="invest-merge2">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_merge2.png"
                       format="PNG" srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>An image of the stock split druid at step 2. </phrase>
          </textobject>

          <caption><para>An image of the stock split druid at step 2 - Selection of 
           Account/Stock (Investment Account:T).</para></caption>
        </mediaobject>
      </screenshot>


      <para>Select the <quote>Assets:Investments:Brokerage Account:Stock:T</quote> and click on
      <guimenu>Forward</guimenu>.</para>

      <para>The next screen presents 5 fields in the Stock Splits Details window:</para>

      <itemizedlist>
        <listitem>
          <para><guilabel>Date</guilabel> - Enter the date of the split.  Here we'll enter
           November 18, 2005.</para>
        </listitem>

        <listitem>
          <para><guilabel>Shares</guilabel> -  The number of shares increased (or decreased)
          in the transaction.</para>
          <para>In our example it is a .77942 for 1 split so the number of shares will
          decrease from the number of shares currently in the register.  You may use GnuCash's
          ability to preform calculations on an entry form by entering data directly
          (E.g. <quote>(.77942*100)-100</quote>) to calculate the decrease in shares
          from the split.</para>
        </listitem>

        <listitem>
          <para><guilabel>Description</guilabel> - The Description should give a brief
          explanation of the transaction.</para>
        </listitem>

        <listitem>
          <para><guilabel>New Price</guilabel> - If desired the new price of the stock,
          after the split, may be entered.</para>
        </listitem>

        <listitem>
          <para><guilabel>Currency</guilabel> - The currency of the transaction
          is required.  This should be the same as the stock purchase currency.</para>
        </listitem>

      </itemizedlist>
            
      <para>Click on the <guimenu>Forward</guimenu> button.</para>

      <screenshot id="invest-merge3">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_merge3.png"
                       format="PNG" srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>An image of the stock split druid at step 3. </phrase>
          </textobject>

          <caption><para>An image of the stock split druid at step 3 - Split Details. </para></caption>
        </mediaobject>
      </screenshot>

      <para>The next screen will be skipped in this example as there was no
      <quote>Cash in Lieu</quote>.
      </para>

      <para>A final <quote>Finish</quote> screen will give a last option to
      <guimenu>Back</guimenu> to modify any data entered or <guimenu>Apply</guimenu>
      to complete the stock split with the data entered. </para>

      <screenshot id="invest-stockmerge1">
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/invest_stockmerge1.png"
                       format="PNG" srccredit="Dave Herman" ></imagedata>
          </imageobject>

          <textobject>
            <phrase>Example of moderate stock split transaction in the stock's register</phrase>
          </textobject>

          <caption><para>An image of the Investment Account:T register after a
           stock split transaction that decreases the shares. </para></caption>
        </mediaobject>
      </screenshot>

    </sect2>

  </sect1>


<!--  Working Location  !!!!!!!!!!!!
  <sect1 id="invest-todo1">
    <title>To-do</title>

    <para>These are the remaining documentation sections that originally
    appeared in the 1.8.4 documentation which require being written up.</para>

    <itemizedlist>



-->

<!--
      <listitem>
        <para>Recording Stock Splits and Mergers (How-To)</para>
      </listitem>
      <listitem>
        <para>Reconciling with the Brokerage Statement (How-To)</para>
      </listitem>

      <listitem>
        <para>Recording Employee Stock Plans (Discussion)</para>
      </listitem>

      <listitem>
        <para>Stock Options (How-To)</para>
      </listitem>

    </itemizedlist>
  </sect1>
-->
</chapter>
