"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "guide/C/ch_invest.xml" between
gnucash-docs-4.12.tar.gz and gnucash-docs-4.13.tar.gz

About: GnuCash is a personal and small business finance application (documentation).

ch_invest.xml  (gnucash-docs-4.12)	:	ch_invest.xml  (gnucash-docs-4.13)
skipping to change at line 330		skipping to change at line 330
in). Assuming only investment accounts were selected, this will create a n account hierarchy		in). Assuming only investment accounts were selected, this will create a n account hierarchy
as shown below.		as shown below.
</para>		</para>
<tip>		<tip>
<para>You can also run the <guilabel>New Account Hierarchy Setup</guilab el> assistant by creating a new		<para>You can also run the <guilabel>New Account Hierarchy Setup</guilab el> assistant by creating a new
&app; file.		&app; file.
</para>		</para>
</tip>		</tip>
<screenshot id="invest_accountspredef">		<figure>
<mediaobject>		<title>A New File Containinng Only The Default Investment Accounts</titl
<imageobject role="html">		e>
<imagedata fileref="figures/invest_AccountsPredef.png"		<screenshot id="invest_accountspredef">
srccredit="Cristian Marchi" width="510px"/>		<mediaobject>
</imageobject>		<imageobject>
		<imagedata fileref="figures/invest_AccountsPredef.png"
<imageobject role="fo">		srccredit="Cristian Marchi"/>
<imagedata fileref="figures/invest_AccountsPredef.png"		</imageobject>
srccredit="Cristian Marchi"/>		<caption>
</imageobject>		<para>This is a screen image of the <guilabel>Accounts</guilabel>
		tab after creating a new file and
<textobject>		selecting only the default investment accounts.
<phrase>Setup Interest Investment</phrase>		</para>
</textobject>		</caption>
		</mediaobject>
<caption>		</screenshot>
<para>This is a screen image of the <guilabel>Accounts</guilabel> ta		</figure>
b 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> a ccount to the <emphasis>Assets</emphasis> account and		<para>You will probably at least want to add a <emphasis>Bank</emphasis> a ccount to the <emphasis>Assets</emphasis> account and
probably an <emphasis>Equity:Opening Balances</emphasis> account, as we have done in		probably an <emphasis>Equity:Opening Balances</emphasis> account, as we have done in
previous chapters. Don&rsquo;t forget to save your new account file with a relevant name!		previous chapters. Don&rsquo;t forget to save your new account file with a relevant name!
</para>		</para>
</sect2>		</sect2>
<sect2 id="invest_creating2">		<sect2 id="invest_creating2">
<title>Creating Investment Accounts Manually</title>		<title>Creating Investment Accounts Manually</title>
skipping to change at line 503		skipping to change at line 496
<sect2 id="invest-intex2">		<sect2 id="invest-intex2">
<title>Example</title>		<title>Example</title>
<para>Now let&rsquo;s populate these accounts with real numbers. Let&rsquo ;s assume that you start with		<para>Now let&rsquo;s populate these accounts with real numbers. Let&rsquo ;s assume that you start with
$10,000 in your bank account, which pays 1% interest and you buy a $5,00 0 certificate of		$10,000 in your bank account, which pays 1% interest and you buy a $5,00 0 certificate of
deposit with a 6 month maturity date and a 2% yield. Clearly, it is much better to keep your		deposit with a 6 month maturity date and a 2% yield. Clearly, it is much better to keep your
money in the certificate of deposit than in the savings account. After t he initial purchase, your accounts		money in the certificate of deposit than in the savings account. After t he initial purchase, your accounts
should look something like this:		should look something like this:
</para>		</para>
<screenshot id="invest-int">		<figure>
<mediaobject>		<title>The Chart Of Accounts After Investing In A Certificate Of Deposit
<imageobject role="html">		</title>
<imagedata fileref="figures/invest_int1.png"		<screenshot id="invest-int">
srccredit="Cristian Marchi" width="510px"/>		<mediaobject>
</imageobject>		<imageobject>
		<imagedata fileref="figures/invest_int1.png"
<imageobject role="fo">		srccredit="Cristian Marchi"/>
<imagedata fileref="figures/invest_int1.png"		</imageobject>
srccredit="Cristian Marchi"/>		<caption>
</imageobject>		<para>This is an image of the account register after creating and
		investing in a certificate of deposit investment.
<textobject>		</para>
<phrase>Setup Interest Investment</phrase>		</caption>
</textobject>		</mediaobject>
		</screenshot>
<caption>		</figure>
<para>This is an image of the account register after creating and in
vesting in a certificate of deposit investment.
</para>
</caption>
</mediaobject>
</screenshot>
<para>Now, during the course of the next 6 months, you receive monthly ban k statements which describe the		<para>Now, during the course of the next 6 months, you receive monthly ban k statements which describe the
activity of your account. In our fictional example, we do nothing with t he money at this		activity of your account. In our fictional example, we do nothing with t he money at this
bank, so the only activity is income from interest and bank charges. The monthly bank		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 certificate of deposit and for the savings account		charges are $2. After 6 months, the register window for the certificate of deposit and for the savings account
should look like these:		should look like these:
</para>		</para>
<screenshot id="invest-int2">		<figure>
<mediaobject>		<title>The CD Account After 6 Months</title>
<imageobject role="html">		<screenshot id="invest-int2">
<imagedata fileref="figures/invest_int2.png"		<mediaobject>
srccredit="Cristian Marchi" width="510px"/>		<imageobject role="html">
</imageobject>		<imagedata fileref="figures/invest_int2.png"
		srccredit="Cristian Marchi" width="&img-w;"/>
<imageobject role="fo">		</imageobject>
<imagedata fileref="figures/invest_int2.png"		<imageobject role="fo">
srccredit="Cristian Marchi"/>		<imagedata fileref="figures/invest_int2.png"
</imageobject>		srccredit="Cristian Marchi"/>
		</imageobject>
<textobject>		<caption>
<phrase>Setup Interest Investment</phrase>		<para>This is an image of the register of the certificate of depos
</textobject>		it account after 6 months.
		</para>
<caption>		</caption>
<para>This is an image of the register of the certificate of deposit		</mediaobject>
account after 6 months.		</screenshot>
</para>		</figure>
</caption>
</mediaobject>
</screenshot>
<screenshot id="invest-int2-1">
<mediaobject>
<imageobject role="html">
<imagedata fileref="figures/invest_int2-1.png"
srccredit="Cristian Marchi" width="510px"/>
</imageobject>
<imageobject role="fo">
<imagedata fileref="figures/invest_int2-1.png"
srccredit="Cristian Marchi"/>
</imageobject>
<textobject>
<phrase>Setup Interest Investment</phrase>
</textobject>
<caption>		<figure>
<para>This is an image of the register of the Savings account after		<title>The Savings Account After 6 Months</title>
6 months.		<screenshot id="invest-int2-1">
</para>		<mediaobject>
</caption>		<imageobject role="html">
</mediaobject>		<imagedata fileref="figures/invest_int2-1.png"
</screenshot>		srccredit="Cristian Marchi" width="&img-w;"/>
		</imageobject>
		<imageobject role="fo">
		<imagedata fileref="figures/invest_int2-1.png"
		srccredit="Cristian Marchi"/>
		</imageobject>
		<caption>
		<para>This is an image of the register of the Savings account afte
		r 6 months.
		</para>
		</caption>
		</mediaobject>
		</screenshot>
		</figure>
<para>And this is the main &app; account window:		<para>And this is the main &app; account window:
</para>		</para>
<screenshot id="invest-int3">		<figure>
<mediaobject>		<title>The Chart Of Accounts After 6 months</title>
<imageobject role="html">		<screenshot id="invest-int3">
<imagedata fileref="figures/invest_int3.png"		<mediaobject>
srccredit="Cristian Marchi" width="510px"/>		<imageobject>
</imageobject>		<imagedata fileref="figures/invest_int3.png"
		srccredit="Cristian Marchi"/>
<imageobject role="fo">		</imageobject>
<imagedata fileref="figures/invest_int3.png"		<caption>
srccredit="Cristian Marchi"/>		<para>This a screen capture of the accounts after 6 months.
</imageobject>		</para>
		</caption>
<textobject>		</mediaobject>
<phrase>Setup Interest Investment</phrase>		</screenshot>
</textobject>		</figure>
<caption>
<para>This a screen capture of the accounts after 6 months.
</para>
</caption>
</mediaobject>
</screenshot>
<para>From the above image of the main &app; account window you see a nice summary of what happened to		<para>From the above image of the main &app; account window you see a nice summary of what happened to
these investments over the 6 months. While the yield on the certificate of deposit is double that of the savings		these investments over the 6 months. While the yield on the certificate of deposit is double that of the savings
account, the return on the certificate of deposit was $50.21 versus $13. 03 for the savings account, or almost 4		account, the return on the certificate of deposit 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 savin gs account (which		times more. Why? Because of the pesky $2 bank charges that hit the savin gs account (which
counted for $12 over 6 months).		counted for $12 over 6 months).
</para>		</para>
<para>After this 6 month period, the certificate of deposit has reached ma turity which means you may sell it with no early		<para>After this 6 month period, the certificate of deposit has reached ma turity which means you may sell it with no early
withdrawal penalty. To do so, simply transfer the $5,050.21 from the cer tificate of deposit account into the		withdrawal penalty. To do so, simply transfer the $5,050.21 from the cer tificate of deposit account into the
skipping to change at line 685		skipping to change at line 658
<para>As an example, let&rsquo;s assume that you currently own 100 shares of Amazon stock. First, create		<para>As an example, let&rsquo;s assume that you currently own 100 shares of Amazon stock. First, create
the stock account AMZN by selecting the <guilabel>Stock</guilabel> accou nt and click on the		the stock account AMZN by selecting the <guilabel>Stock</guilabel> accou nt and click on the
menu		menu
<menuchoice>		<menuchoice>
<guimenu>Actions</guimenu><guimenu>New Account...</guimenu>		<guimenu>Actions</guimenu><guimenu>New Account...</guimenu>
</menuchoice>.		</menuchoice>.
The New Account dialog will appear, follow the steps, in the sequence be low to setup your		The New Account dialog will appear, follow the steps, in the sequence be low to setup your
new stock account.		new stock account.
</para>		</para>
<screenshot id="invest-newaccount">		<figure>
<mediaobject>		<title>The <quote>New Account</quote> Window For AMZN</title>
<imageobject role="html">		<screenshot id="invest-newaccount">
<imagedata fileref="figures/invest_newaccount.png"		<mediaobject>
srccredit="Cristian Marchi" width="510px"/>		<imageobject>
</imageobject>		<imagedata fileref="figures/invest_newaccount.png"
		srccredit="Cristian Marchi"/>
<imageobject role="fo">		</imageobject>
<imagedata fileref="figures/invest_newaccount.png"		</mediaobject>
srccredit="Cristian Marchi"/>		</screenshot>
</imageobject>		</figure>
<textobject>
<phrase>New Account Window</phrase>
</textobject>
<caption>
<para>New Account Window
</para>
</caption>
</mediaobject>
</screenshot>
<orderedlist>		<orderedlist>
<listitem>		<listitem>
<para><emphasis>Account Name</emphasis> - Usually, use the stock ticke r abbreviation, like		<para><emphasis>Account Name</emphasis> - Usually, use the stock ticke r abbreviation, like
<quote><userinput>AMZN</userinput></quote>.		<quote><userinput>AMZN</userinput></quote>.
</para>		</para>
</listitem>		</listitem>
<listitem>		<listitem>
<para><emphasis>Account Code</emphasis> - Optional field, use CUSIP, t he newspaper listing symbol, mutual		<para><emphasis>Account Code</emphasis> - Optional field, use CUSIP, t he newspaper listing symbol, mutual
skipping to change at line 768		skipping to change at line 730
</listitem>		</listitem>
<listitem>		<listitem>
<para><emphasis>Type</emphasis> - Select the exchange where the se curity/commodity is traded (in this		<para><emphasis>Type</emphasis> - Select the exchange where the se curity/commodity is traded (in this
example NASDAQ).		example NASDAQ).
</para>		</para>
<para>Select the <guibutton>New</guibutton> button to open the <gu ilabel>New Security</guilabel> window.		<para>Select the <guibutton>New</guibutton> button to open the <gu ilabel>New Security</guilabel> window.
</para>		</para>
<screenshot id="invest-selectsecurity">		<figure>
<mediaobject>		<title>The <quote>Select Security</quote> Window</title>
<imageobject role="html">		<screenshot id="invest-selectsecurity">
<imagedata fileref="figures/invest_selectsecurity.png"		<mediaobject>
srccredit="Cristian Marchi"/>		<imageobject>
</imageobject>		<imagedata fileref="figures/invest_selectsecurity.png"
		srccredit="Cristian Marchi"/>
<imageobject role="fo">		</imageobject>
<imagedata fileref="figures/invest_selectsecurity.png"		</mediaobject>
srccredit="Cristian Marchi"/>		</screenshot>
</imageobject>		</figure>
<textobject>
<phrase>Select Security Window</phrase>
</textobject>
<caption>
<para>Select Security Window
</para>
</caption>
</mediaobject>
</screenshot>
</listitem>		</listitem>
<listitem>		<listitem>
<para><emphasis>Create the Security</emphasis> - Click on the <gui button>New...</guibutton> button and		<para><emphasis>Create the Security</emphasis> - Click on the <gui button>New...</guibutton> button and
enter the appropriate information for this stock on the new form <guilabel>New		enter the appropriate information for this stock on the new form <guilabel>New
Security</guilabel>.		Security</guilabel>.
</para>		</para>
<!-- Open inner most loop (#3)		<!-- Open inner most loop (#3)
-->		-->
<itemizedlist>		<itemizedlist>
<listitem>		<listitem>
<para>The <guilabel>Full name:</guilabel> is <userinput>Amazon .com</userinput>.		<para>The <guilabel>Full name:</guilabel> is <userinput>Amazon .com</userinput>.
</para>		</para>
</listitem>		</listitem>
<listitem>		<listitem>
<para>The <guilabel>Symbol/abbreviation:</guilabel> is <userin put>AMZN</userinput>. The symbol is the stock ticker		<para>The <guilabel>Symbol/abbreviation:</guilabel> is <userin put>AMZN</userinput>. The symbol is the stock ticker
used in your quote source several lines down on the form.		used in your quote source several lines down on the form.
<note><para>		<note><para>
Different symbols will be used on different price sources fo r the same stock, an		Different symbols will be used on different price sources fo r the same stock, an
example is Ericsson on the Stockholm Exchange is ERIC-B whil e on Yahoo it is		example is Ericsson on the Stockholm Exchange is ERIC-B whil e on Yahoo it is
ERRICB.ST.</para>		ERRICB.ST.</para>
</note>		</note>
</para>		</para>
</listitem>		</listitem>
<listitem>		<listitem>
<para>The <guilabel>Type:</guilabel> should already be <guilab el>NASDAQ</guilabel>, because this is what		<para>The <guilabel>Type:</guilabel> should already be <guilab el>NASDAQ</guilabel>, because this is what
was selected in the security selector, but you can change it here, including		was selected in the security selector, but you can change it here, including
skipping to change at line 845		skipping to change at line 795
<listitem>		<listitem>
<para>The checkbox <quote>Get Online Quotes</quote>, the quote source and the timezone should be selected		<para>The checkbox <quote>Get Online Quotes</quote>, the quote source and the timezone should be selected
to define the sources for updating prices on-line. See also		to define the sources for updating prices on-line. See also
<xref linkend="invest-stockprice-auto2" />.		<xref linkend="invest-stockprice-auto2" />.
</para>		</para>
<note>		<note>
<para>If the <guibutton>Get Online Quotes</guibutton> button is not highlighted, and it is not tickable,		<para>If the <guibutton>Get Online Quotes</guibutton> button is not highlighted, and it is not tickable,
then the &app-fq; package is not installed.		then the &app-fq; package is not installed.
See the section on <xref linkend="invest-stockprice-auto-i nstall3"/>.		See the chapter <ulink url="&url-docs;C/gnucash-help/finan ce-quote.html">Setting Up the Quote Retrieval</ulink> in the manual.
</para>		</para>
</note>		</note>
<para>Below is what this window should look like when finished :		<para>Below is what this window should look like when finished :
<screenshot id="invest-newsecurity">
<mediaobject>
<imageobject role="html">
<imagedata fileref="figures/invest_newsecurity.png"
srccredit="Cristian Marchi" width="510px"/>
</imageobject>
<imageobject role="fo">
<imagedata fileref="figures/invest_newsecurity.png"
srccredit="Cristian Marchi"/>
</imageobject>
<textobject>
<phrase>New Security Window</phrase>
</textobject>
<caption>
<para>New Security Window
</para>
</caption>
</mediaobject>
</screenshot>
</para>		</para>
		<figure>
		<title>The <quote>New Security</quote> Window</title>
		<screenshot id="invest-newsecurity">
		<mediaobject>
		<imageobject>
		<imagedata fileref="figures/invest_newsecurity.png"
		srccredit="Cristian Marchi"/>
		</imageobject>
		</mediaobject>
		</screenshot>
		</figure>
</listitem>		</listitem>
<listitem>		<listitem>
<para><emphasis>Save Security</emphasis> - Click on the <guibu tton>OK</guibutton> button to save this new		<para><emphasis>Save Security</emphasis> - Click on the <guibu tton>OK</guibutton> button to save this new
security, this will close the <guilabel>New Security</guilab el> window and		security, this will close the <guilabel>New Security</guilab el> window and
return to the <guilabel>New Account</guilabel> window.		return to the <guilabel>New Account</guilabel> window.
</para>		</para>
</listitem>		</listitem>
</itemizedlist>		</itemizedlist>
<!-- Close inner most loop		<!-- Close inner most loop
skipping to change at line 938		skipping to change at line 877
</listitem>		</listitem>
<!--		<!--
Outer list can now be closed		Outer list can now be closed
-->		-->
</orderedlist>		</orderedlist>
<para>You have now created the Amazon stock account, your main account sho uld look something like this		<para>You have now created the Amazon stock account, your main account sho uld look something like this
(notice that there are a few extra accounts here, a bank account, and an equity account):		(notice that there are a few extra accounts here, a bank account, and an equity account):
</para>		</para>
<screenshot id="invest-setup-current">		<figure>
<mediaobject>		<title>The Chart of Accounts After The Creation Of The First Stock Accou
<imageobject role="html">		nt</title>
<imagedata fileref="figures/invest_setup_current.png"		<screenshot id="invest-setup-current">
srccredit="Cristian Marchi" width="510px"/>		<mediaobject>
</imageobject>		<imageobject>
		<imagedata fileref="figures/invest_setup_current.png"
<imageobject role="fo">		srccredit="Cristian Marchi"/>
<imagedata fileref="figures/invest_setup_current.png"		</imageobject>
srccredit="Cristian Marchi"/>		<caption>
</imageobject>		<para>This image is after the creation of the first stock account
		(AMZN).
<textobject>		</para>
<phrase>Setup Current Portfolio</phrase>		</caption>
</textobject>		</mediaobject>
		</screenshot>
<caption>		</figure>
<para>This image is after the creation of the first stock account (A
MZN).
</para>
</caption>
</mediaobject>
</screenshot>
<para>Open the account register window for this AMZN stock account (double click on it). Here you see the		<para>Open the account register window for this AMZN stock account (double click on it). Here you see the
<emphasis		<emphasis
role="strong">Commodity</emphasis> view. This gives you an overview of the		role="strong">Commodity</emphasis> view. This gives you an overview of the
transactions in this commodity including the number of units (shares for a stock or mutual		transactions in this commodity including the number of units (shares for a stock or mutual
fund) bought or sold, the net price per unit, and the total amount. Obvi ously, we have not		fund) bought or sold, the net price per unit, and the total amount. Obvi ously, we have not
bought or sold any shares of AMZN yet, so the register should not contai n any transactions.		bought or sold any shares of AMZN yet, so the register should not contai n any transactions.
</para>		</para>
</sect2>		</sect2>
</sect1>		</sect1>
skipping to change at line 1000		skipping to change at line 932
<guilabel>Buy</guilabel> from the other 2 columns. But to avoid roundi ng errors, it is		<guilabel>Buy</guilabel> from the other 2 columns. But to avoid roundi ng errors, it is
better to automatically calculate <guilabel>Price</guilabel>.		better to automatically calculate <guilabel>Price</guilabel>.
</para>		</para>
</note>		</note>
<para><keycap>Tab</keycap> to the second split line, enter transfer from a ccount <emphasis>Equity:Opening		<para><keycap>Tab</keycap> to the second split line, enter transfer from a ccount <emphasis>Equity:Opening
Balances</emphasis>. For simplicity, this example assumed there were no commissions on this		Balances</emphasis>. For simplicity, this example assumed there were no commissions on this
transaction. Your AMZN Commodity view should now appear like this:		transaction. Your AMZN Commodity view should now appear like this:
</para>		</para>
<screenshot id="invest-setup-portfolio1">		<figure>
<mediaobject>		<title>The Transaction Register Of The AMZN Account After The First Purc
<imageobject role="html">		hase</title>
<imagedata fileref="figures/invest_setup_portfolio1.png"		<screenshot id="invest-setup-portfolio1">
srccredit="Cristian Marchi" width="510px"/>		<mediaobject>
</imageobject>		<imageobject role="html">
		<imagedata fileref="figures/invest_setup_portfolio1.png"
<imageobject role="fo">		srccredit="Cristian Marchi" width="&img-w;"/>
<imagedata fileref="figures/invest_setup_portfolio1.png"		</imageobject>
srccredit="Cristian Marchi"/>		<imageobject role="fo">
</imageobject>		<imagedata fileref="figures/invest_setup_portfolio1.png"
		srccredit="Cristian Marchi"/>
<textobject>		</imageobject>
<phrase>Setup Current Portfolio</phrase>		<caption>
</textobject>		<para>This image is the transaction register of the AMZN account a
		fter the first stock
<caption>		<quote>purchase</quote>.
<para>This image is the transaction register of the AMZN account aft		</para>
er the first stock		</caption>
<quote>purchase</quote>.		</mediaobject>
</para>		</screenshot>
</caption>		</figure>
</mediaobject>
</screenshot>
<para>Notice that the <guilabel>Balance</guilabel> (last column) is in the units of the commodity (AMZN		<para>Notice that the <guilabel>Balance</guilabel> (last column) is in the units of the commodity (AMZN
shares) not in currency units. Thus, the balance is 100 (AMZN units) rat her than $2,000. This		shares) not in currency units. Thus, the balance is 100 (AMZN units) rat her than $2,000. This
is how it should be.		is how it should be.
</para>		</para>
</sect2>		</sect2>
<sect2 id="invest-buy-new2">		<sect2 id="invest-buy-new2">
<title id="invest-buy-new2.title">Buying New Shares</title>		<title id="invest-buy-new2.title">Buying New Shares</title>
skipping to change at line 1103		skipping to change at line 1032
Purchase). On the first split line, enter <userinput>50</userinput> in <guilabel>Shares</guilabel>, delete		Purchase). On the first split line, enter <userinput>50</userinput> in <guilabel>Shares</guilabel>, delete
<guilabel>Price</guilabel> (leave it empty so it will be calculated), and enter <userinput>5000</userinput> in		<guilabel>Price</guilabel> (leave it empty so it will be calculated), and enter <userinput>5000</userinput> in
<guilabel>Buy</guilabel>. You do not need to fill in the <guilabel>Pri ce</guilabel>		<guilabel>Buy</guilabel>. You do not need to fill in the <guilabel>Pri ce</guilabel>
column, as it will be calculated for you when you <keycap>Tab</keycap> to the next split.		column, as it will be calculated for you when you <keycap>Tab</keycap> to the next split.
The next line in the split transaction will be <emphasis>Expenses:Comm issions</emphasis>		The next line in the split transaction will be <emphasis>Expenses:Comm issions</emphasis>
and fill <userinput>100</userinput> in <guilabel>Buy</guilabel>. The t hird split line will be to transfer $5,100 from		and fill <userinput>100</userinput> in <guilabel>Buy</guilabel>. The t hird split line will be to transfer $5,100 from
<emphasis>Assets:Bank ABC</emphasis> account to balance the transactio n. Your IBM		<emphasis>Assets:Bank ABC</emphasis> account to balance the transactio n. Your IBM
Commodity view should now appear like this:		Commodity view should now appear like this:
</para>		</para>
<screenshot id="invest-setup-portfolio2">		<figure>
<mediaobject>		<title>The Transaction Register Of The IBM Account After The First Sto
<imageobject role="html">		ck Purchase</title>
<imagedata fileref="figures/invest_SetupPortfolio2.png"		<screenshot id="invest-setup-portfolio2">
srccredit="Chris Good" width="510px"/>		<mediaobject>
</imageobject>		<imageobject role="html">
		<imagedata fileref="figures/invest_SetupPortfolio2.png"
<imageobject role="fo">		srccredit="Chris Good" width="&img-w;"/>
<imagedata fileref="figures/invest_SetupPortfolio2.png"		</imageobject>
srccredit="Chris Good"/>		<imageobject role="fo">
</imageobject>		<imagedata fileref="figures/invest_SetupPortfolio2.png"
		srccredit="Chris Good"/>
<textobject>		</imageobject>
<phrase>Setup Current Portfolio</phrase>		<caption>
</textobject>		<para>This image is of the transaction register of the IBM accou
		nt after the first stock
<caption>		<quote>purchase</quote> with a commission.
<para>This image is of the transaction register of the IBM account		</para>
after the first stock		</caption>
<quote>purchase</quote> with a commission.		</mediaobject>
</para>		</screenshot>
</caption>		</figure>
</mediaobject>
</screenshot>
</sect3>		</sect3>
<sect3 id="invest-buy-net">		<sect3 id="invest-buy-net">
<title>Example: Buying Shares with Net Pricing</title>		<title>Example: Buying Shares with Net Pricing</title>
<para>Repeating the previous example using Net Pricing instead of Gross Pricing, in Transaction Journal		<para>Repeating the previous example using Net Pricing instead of Gross Pricing, in Transaction Journal
view.		view.
</para>		</para>
<para>Purchase $5,000 of IBM stock being 50 Shares for $100.00 each, plu s a commission of $100.		<para>Purchase $5,000 of IBM stock being 50 Shares for $100.00 each, plu s a commission of $100.
</para>		</para>
<para>Now for the transaction, on the first (transaction) line, enter th e <guilabel>Date</guilabel> of the		<para>Now for the transaction, on the first (transaction) line, enter th e <guilabel>Date</guilabel> of the
purchase (for example, Jan. 3, 2005) and <guilabel>Description</guilab el> (for example, Initial IBM		purchase (for example, Jan. 3, 2005) and <guilabel>Description</guilab el> (for example, Initial IBM
Purchase). On the first split line, optionally enter more details in < guilabel>Memo		Purchase). On the first split line, optionally enter more details in < guilabel>Memo
</guilabel>, then <userinput>50</userinput> in <guilabel>Shares</guila bel>, delete anything in		</guilabel>, then <userinput>50</userinput> in <guilabel>Shares</guila bel>, delete anything in
<guilabel>Price</guilabel> (so it will be calculated by dividing <guil abel>Buy</guilabel>		<guilabel>Price</guilabel> (so it will be calculated by dividing <guil abel>Buy</guilabel>
by <guilabel>Shares</guilabel> when you <keycap>Tab</keycap> out of th e split), 5100 in		by <guilabel>Shares</guilabel> when you <keycap>Tab</keycap> out of th e split), &img-w;0 in
<guilabel>Buy</guilabel> (50 * $100.00 + $100). Alternatively use &app ; to calculate		<guilabel>Buy</guilabel> (50 * $100.00 + $100). Alternatively use &app ; to calculate
<guilabel>Buy</guilabel> by entering the formula <userinput>5000 + 100 </userinput> or		<guilabel>Buy</guilabel> by entering the formula <userinput>5000 + 100 </userinput> or
<userinput>(50 * 100) + 100</userinput> in <guilabel>Buy</guilabel> (		<userinput>(50 * 100) + 100</userinput> in <guilabel>Buy</guilabel> (
<guilabel>Buy</guilabel> will be calculated when you <keycap>Tab</keyc ap> out of the		<guilabel>Buy</guilabel> will be calculated when you <keycap>Tab</keyc ap> out of the
column.) Use the <keycap>Tab</keycap> key as many times as needed to p roceed to the next		column.) Use the <keycap>Tab</keycap> key as many times as needed to p roceed to the next
split.		split.
</para>		</para>
<para>Do <emphasis>not</emphasis> enter a separate split for Commission as it has already been included in		<para>Do <emphasis>not</emphasis> enter a separate split for Commission as it has already been included in
the <guilabel>Buy</guilabel> value. The second split line will be to t ransfer $5,100 from		the <guilabel>Buy</guilabel> value. The second split line will be to t ransfer $5,100 from
<emphasis>Assets:Bank ABC</emphasis> account to balance the transactio n. After the splits		<emphasis>Assets:Bank ABC</emphasis> account to balance the transactio n. After the splits
are all correct, use the <keycap function="enter">Enter</keycap> key t o save the		are all correct, use the <keycap function="enter">Enter</keycap> key t o save the
transaction. Your IBM Commodity view should now appear like this:		transaction. Your IBM Commodity view should now appear like this:
</para>		</para>
<screenshot id="invest-setup-portfolio3">		<figure>
<mediaobject>		<title>The IBM Account After The First Stock Purchase With A Commissio
<imageobject role="html">		n</title>
<imagedata fileref="figures/invest_SetupPortfolio3.png"		<screenshot id="invest-setup-portfolio3">
srccredit="Chris Good" width="510px"/>		<mediaobject>
</imageobject>		<imageobject role="html">
		<imagedata fileref="figures/invest_SetupPortfolio3.png"
<imageobject role="fo">		srccredit="Chris Good" width="&img-w;"/>
<imagedata fileref="figures/invest_SetupPortfolio3.png"		</imageobject>
srccredit="Chris Good"/>		<imageobject role="fo">
</imageobject>		<imagedata fileref="figures/invest_SetupPortfolio3.png"
		srccredit="Chris Good"/>
<textobject>		</imageobject>
<phrase>Setup Current Portfolio</phrase>		<caption>
</textobject>		<para>This image is of the transaction register of the IBM accou
		nt after the first stock
<caption>		<quote>purchase</quote> with a commission.
<para>This image is of the transaction register of the IBM account		</para>
after the first stock		</caption>
<quote>purchase</quote> with a commission.		</mediaobject>
</para>		</screenshot>
</caption>		</figure>
</mediaobject>
</screenshot>
</sect3>		</sect3>
</sect2>		</sect2>
</sect1>		</sect1>
<sect1 id="invest-stockprice1">		<sect1 id="invest-stockprice1">
<title>Setting Share Price</title>		<title>Setting Share Price</title>
<para>The value of a commodity, such as a stock, must be explicitly set. The stock accounts track the		<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 <e mphasis>Price		quantity of stocks you own, but the value of the stock is stored in the <e mphasis>Price
Database</emphasis>. The values set in the <guilabel>Price Database</guila bel> can be updated		Database</emphasis>. The values set in the <guilabel>Price Database</guila bel> can be updated
manually or automatically.		manually or automatically.
</para>		</para>
<sect2 id="invest-stockprice-initial2">		<sect2 id="invest-stockprice-initial2">
<title>Initial Price Database Setup</title>		<title>Initial Price Database Setup</title>
<para>To use the <guilabel>Price Database</guilabel> to track a stock valu e, you must initially insert the		<para>To use the <guilabel>Price Database</guilabel> to track a stock valu e, you must initially insert the
stock. To do so, open the <guilabel>Price Database</guilabel>		stock. To do so, open the <guilabel>Price Database</guilabel> (<menuchoi
(<menuchoice>		ce>
<guimenu>Tools</guimenu><guimenuitem>Price Database</guimenuitem>		<guimenu>Tools</guimenu><guimenuitem>Price Database</guimenuitem>
</menuchoice>)		</menuchoice>)
and click on <guibutton>Add</guibutton> button. The first time a Commodi ty/Stock is		and click on <guibutton>Add</guibutton> button. The first time a Commodi ty/Stock is
entered this window will be blank except for the control buttons on the bottom. Select the		entered this window will be blank except for the control buttons on the bottom. Select the
appropriate Commodity you want to insert into the <guilabel>Price Databa se</guilabel>. At this		appropriate Commodity you want to insert into the <guilabel>Price Databa se</guilabel>. At this
point, you can input the price of the commodity manually. There are 6 fi elds in the New		point, you can input the price of the commodity manually. There are 6 fi elds in the New
Commodity window:		Commodity window:
</para>		</para>
<variablelist>		<variablelist>
skipping to change at line 1276		skipping to change at line 1198
<para>The price of one unit of this commodity.		<para>The price of one unit of this commodity.
</para>		</para>
</listitem>		</listitem>
</varlistentry>		</varlistentry>
</variablelist>		</variablelist>
<para>As an example of adding the AMZN commodity to the price database, wi th an initial value of $40.50 per		<para>As an example of adding the AMZN commodity to the price database, wi th an initial value of $40.50 per
share.		share.
</para>		</para>
<screenshot id="invest-peditor">		<figure>
<mediaobject>		<title>Entering A Price Into The Database</title>
<imageobject role="html">		<screenshot id="invest-peditor">
<imagedata fileref="figures/invest_peditor.png"		<mediaobject>
srccredit="Cristian Marchi"/>		<imageobject>
</imageobject>		<imagedata fileref="figures/invest_peditor.png"
		srccredit="Cristian Marchi"/>
<imageobject role="fo">		</imageobject>
<imagedata fileref="figures/invest_peditor.png"		<caption>
srccredit="Cristian Marchi"/>		<para>Adding the AMZN commodity to the price database, with an ini
</imageobject>		tial value of $40.50 per share.
		</para>
<textobject>		</caption>
<phrase>Price Database</phrase>		</mediaobject>
</textobject>		</screenshot>
		</figure>
<caption>
<para>Adding the AMZN commodity to the price database, with an initi
al value of $40.50 per share.
</para>
</caption>
</mediaobject>
</screenshot>
<para>Click <guibutton>OK</guibutton> when finished. Once you have perform ed this initial placement of the		<para>Click <guibutton>OK</guibutton> when finished. Once you have perform ed this initial placement of the
commodity into the <guilabel>Price Database</guilabel>, you will not hav e to do it again, even		commodity into the <guilabel>Price Database</guilabel>, you will not hav e to do it again, even
if you use the same commodity in another account.		if you use the same commodity in another account.
</para>		</para>
<note>		<note>
<para>If you have online retrieval of quotes activated (see		<para>If you have online retrieval of quotes activated (see
<xref linkend="invest-stockprice-auto2" />), you can initialize a comm odity		<xref linkend="invest-stockprice-auto2" />), you can initialize a comm odity
without manually making an entry. When you initially add the security in the		without manually making an entry. When you initially add the security in the
skipping to change at line 1324		skipping to change at line 1239
</sect2>		</sect2>
<sect2 id="invest-stockprice-manual2">		<sect2 id="invest-stockprice-manual2">
<title>Setting Stock Price Manually</title>		<title>Setting Stock Price Manually</title>
<para>If the value of the commodity (stock) changes, you can adjust the va lue by entering the		<para>If the value of the commodity (stock) changes, you can adjust the va lue by entering the
<guilabel>Price Database</guilabel>, selecting the commodity, clicking o n		<guilabel>Price Database</guilabel>, selecting the commodity, clicking o n
<guibutton>Edit</guibutton> and entering the new price.		<guibutton>Edit</guibutton> and entering the new price.
</para>		</para>
<screenshot id="invest-peditor2">		<figure>
<mediaobject>		<title>The Price Database With The List Of All Known Commodities</title>
<imageobject role="html">		<screenshot id="invest-peditor2">
<imagedata fileref="figures/invest_peditor2.png"		<mediaobject>
srccredit="Cristian Marchi" width="510px"/>		<imageobject role="html">
</imageobject>		<imagedata fileref="figures/invest_peditor2.png"
		srccredit="Cristian Marchi" width="&img-w;"/>
<imageobject role="fo">		</imageobject>
<imagedata fileref="figures/invest_peditor2.png"		<imageobject role="fo">
srccredit="Cristian Marchi"/>		<imagedata fileref="figures/invest_peditor2.png"
</imageobject>		srccredit="Cristian Marchi"/>
		</imageobject>
<textobject>		<caption>
<phrase>Price Database</phrase>		<para>The main price database window, showing the list of all know
</textobject>		n commodities.
		</para>
<caption>		</caption>
<para>The main price database window, showing the list of all known		</mediaobject>
commodities.		</screenshot>
</para>		</figure>
</caption>
</mediaobject>
</screenshot>
</sect2>		</sect2>
<sect2 id="invest-stockprice-auto2">		<sect2 id="invest-stockprice-auto2">
<title>Configuring for Automatic Retrieval of Quotes</title>		<title>Configuring for Automatic Retrieval of Quotes</title>
<para>If you have more than a couple of commodities, you will tire of havi ng to update their prices		<para>If you have more than a couple of commodities, you will tire of havi ng to update their prices
constantly. &app; has the ability to automatically download the most rec ent price for your		constantly. &app; has the ability to automatically download the most rec ent price for your
commodities using the Internet. This is accomplished through the		commodities using the Internet. This is accomplished through the
<application>Perl</application> module &app-fq;, which must		<application>Perl</application> module &app-fq;, which must
be installed in order to activate this feature.		be installed in order to activate this feature.
</para>		</para>
<para>To determine if the <application>Perl</application> module &app-fq;		<para>See the chapter
is already installed on your system, type <command>perldoc Finance::Quot		<ulink url="&url-docs;C/gnucash-help/finance-quote.html">Setting Up the
e</command> in a		Quote Retrieval</ulink>
terminal window and check to see if there is any documentation available		in the manual.
. If you see the
documentation, then the module is installed, if you do not see the docum
entation, then it
has not been installed.
</para>		</para>
<sect3 id="invest-stockprice-auto-install3">
<title>Installing &app-fq;</title>
<para>The process of installing &app-fq; depends on the system. </para>
<procedure>
<title>Installing &app-fq; on &lin;</title>
<step><simpara>Close &app;.</simpara></step>
<step><simpara>Run the command <command>which gnc-fq-update</command>
to check <filename>gnc-fq-update</filename> program is in your PATH environment
variable.<footnote><simpara>If you&rsquo;ve installed &app; packages
provided by your distribution, <filename>gnc-fq-update</filename> must be on yo
ur PATH.</simpara></footnote>
</simpara>
<substeps><step id="gnc-fq-update-not-found">
<simpara>If <filename>gnc-fq-update</filename> is not in your PA
TH, search the folder where &app; is
installed.</simpara>
</step>
</substeps>
</step>
<step><simpara>Run the command <command>sudo gnc-fq-update</command> o
r <command>su -c gnc-fq-update</command> in order to run it with root privilege.
It depends on your distribution.
If <filename>gnc-fq-update</filename> is not in your PATH, specify ful
l path of <filename>gnc-fq-update</filename>
instead, which is found by <xref linkend="gnc-fq-update-not-found" /
>.</simpara>
<para>
This will launch a <application>Perl</application> <acronym><ulink
url="https://www.cpan.org/">CPAN</ulink></acronym><footnote>
<simpara>See <ulink url="https://www.cpan.org/misc/cpan-faq.html
">CPAN Frequently Asked Questions</ulink> for details.</simpara></footnote>
module internally. When you launch the CPAN module for the first t
ime, you must setup and configure it. However, on the most systems if you accept
the default settings
or answer the first question <computeroutput>Are you ready for man
ual
configuration? [yes]</computeroutput> with <userinput>no</userinpu
t>, you will be able to install &app-fq; successfully.
</para>
</step>
<step><simpara>Run <command>gnc-fq-dump</command> to check &app-fq; wo
rks properly.</simpara></step>
</procedure>
<procedure>
<title>Installing &app-fq; on &mac;</title>
<step><simpara>Close &app;.</simpara></step>
<step><simpara>Install Xcode if it is not installed.</simpara>
<simpara>XCode is an optional item from your &mac; distribution DV
D.</simpara>
</step>
<step><simpara>Run the <emphasis>Update Finance Quote</emphasis> app i
n the &app; dmg.</simpara>
<para>You can run it from the dmg or copy it to the same
folder to which you copied &app;.
It will open a Terminal window and run a script for you
which will ask lots of questions. Accept the default for each un
less you know what
you&rsquo;re doing.
</para>
</step>
</procedure>
<procedure>
<title>Installing &app-fq; on &win;</title>
<step><simpara>Close &app;.</simpara></step>
<step><simpara>Run <menuchoice>
<guimenu>Start</guimenu>
<guisubmenu>&app;</guisubmenu>
<guimenuitem>Install Online Price Retrieval</guim
enuitem></menuchoice>.
</simpara>
</step>
</procedure>
<note>
<para>If you feel uncomfortable about performing any of these steps, p
lease either email the &app;-user
mailing list (<email>gnucash-user@gnucash.org</email>) for help or c
ome to the &app; IRC
channel on irc.gnome.org. You can also leave out this step and manua
lly update your
stock prices.
</para>
</note>
</sect3>
<sect3 id="invest-stockprice-auto-configure3">		<sect3 id="invest-stockprice-auto-configure3">
<title>Configuring Securities for Online Quotes</title>		<title>Configuring Securities for Online Quotes</title>
<para>With &app-fq; installed and functioning correctly, you must		<para>With &app-fq; installed and functioning correctly, you must
configure your &app; securities to use this feature to obtain updated price information		configure your &app; securities to use this feature to obtain updated price information
automatically. Whether creating new securities or modifying securities that have already		automatically. Whether creating new securities or modifying securities that have already
been setup, use the		been setup, use the
<menuchoice>		<menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Security Editor</guimenuitem>		<guimenu>Tools</guimenu><guimenuitem>Security Editor</guimenuitem>
</menuchoice>,		</menuchoice>,
to edit the security and check the <guilabel>Get Online Quotes</guilab el> box. You will		to edit the security and check the <guilabel>Get Online Quotes</guilab el> box. You will
now be able to modify the radio buttons for <guilabel>Type of quote so urce</guilabel>, the		now be able to modify the radio buttons for <guilabel>Type of quote so urce</guilabel>, the
pull-down menus to specify the specific source(s) and <guilabel>The ti mezone for these		pull-down menus to specify the specific source(s) and <guilabel>The ti mezone for these
quotes</guilabel>. When finished editing, <guilabel>Close</guilabel> t he Security Editor		quotes</guilabel>. When finished editing, <guilabel>Close</guilabel> t he Security Editor
to return to the <guilabel>Price Database</guilabel> and click on the <guibutton>Get		to return to the <guilabel>Price Database</guilabel> and click on the <guibutton>Get
Quotes</guibutton> button to update your stock prices on the Internet.		Quotes</guibutton> button to update your stock prices on the Internet.
</para>		</para>
<para>The command <command>gnucash-cli --quotes get <filename><replaceab
le>${HOME}/gnucash-filename</replaceable></filename></command><footnote>
<simpara>The Online Quotes Retrieval command has been changed from &ap
p; 4.0. The old command
<command>gnucash --add-price-quotes <filename><replaceable>${HOME}/g
nucash-filename</replaceable></filename></command> is
still available, but it is deprecated and will be removed in the fut
ure release.
If you've upgraded from &app; 3.11 or previous version,
it is recommended to use the new command <command>gnucash-cli</comma
nd>.</simpara>
</footnote> can be used to
fetch the current prices of your stocks. The file specified
<filename><replaceable>${HOME}/gnucash-filename</replaceable></filenam
e> will depend on the name and
location of your data file. This can be determined by the name display
ed in the top frame
of the &app; window, before the <quote>-</quote>. The file name can al
so be found under
<guimenu>File</guimenu> in the recently opened file list; the first it
em, numbered 1, is
the name of the currently open file.
</para>
</sect3>		</sect3>
<sect3 id="invest-stockprice-auto-scheduler">		<sect3 id="invest-stockprice-auto-scheduler">
<title>Configuring for Getting Online Quotes Periodically</title>		<title>Configuring for Getting Online Quotes Periodically</title>
<para>You have to register the <command>gnucash-cli</command> with a sch		<para>After you have verified the proper fetching of Online Quotes for y
eduler in order to get Online Quotes automatically and periodically.		our commodities,
The method depends on your OS. For example, suppose you want to update		you can tell your operating system to fetch the quotes periodically. Se
your file on 16:00 on every Friday.		e the section
</para>		<ulink url="&url-docs;C/gnucash-help/finance-quote-scheduler.html">Confi
		guring for Getting Quotes Periodically</ulink>
<procedure>		in the manual.
<title>Register <command>gnucash-cli</command> with <application>cron<
/application> on &lin; and &mac;</title>
<step><simpara>Run <command>crontab -e</command>.</simpara></step>
<step><para>Add the following line to your crontab:
<informalexample>
<screen>0 16 * * 5 gnucash-cli --quotes get <replaceable>${HOME}/g
nucash-filename</replaceable> &gt; /dev/null 2&gt;&amp;1</screen>
</informalexample></para>
</step>
</procedure>
<procedure>
<title>Register <command>gnucash-cli</command> with Task Scheduler on
&win;</title>
<step><simpara>Select <menuchoice><guimenu>Start</guimenu><guisubmenu>
Windows Administrative Tools</guisubmenu><guimenuitem>Task Scheduler</guimenuite
m></menuchoice>.</simpara></step>
<step><simpara>Select <guimenuitem>Create Task</guimenuitem>.</simpara
></step>
<step><simpara>Enter the appropirate items on <guilabel>Create Task</g
uilabel> Window.</simpara></step>
</procedure>
<para>See <ulink url="&url-docs-C;help/acct-create.html#Online-price-set
up">GnuCash Help Manual</ulink>
and <ulink url="&url-wiki-OQ;#Updating_enabled_Quotes_from_outside_Gnu
Cash">Online Quotes Page on GnuCash Wiki</ulink> for more details.
</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
<acronym>NAV</acronym>s are downloaded before the current days <acrony
m>NAV</acronym>s are
determined, yesterday&rsquo;s <acronym>NAV</acronym>s are retrieved.
</para>		</para>
</sect3>		</sect3>
</sect2>		</sect2>
<sect2 id="invest-stockprice-view2">		<sect2 id="invest-stockprice-view2">
<title>Displaying Share Value</title>		<title>Displaying Share Value</title>
<para>The main account window, by default, only shows the quantity of each commodity that you own, under		<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, th is commodity is the		the column heading <guilabel>Total</guilabel>. In the case of stocks, th is commodity is the
number of shares. Often, however, you will want to see the value of your stocks expressed in		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,		terms of some monetary unit. This is easily accomplished by entering the main window,
selecting the <guilabel>Accounts</guilabel> tab, by clicking on the		selecting the <guilabel>Accounts</guilabel> tab, by clicking on the
<emphasis>Titlebar</emphasis> <guibutton>Options</guibutton> button (the small down pointing		<emphasis>Titlebar</emphasis> <guibutton>Options</guibutton> button (the small down pointing
arrow on the right side of the main account window titles bar), and sele cting the option to		arrow on the right side of the main account window titles bar), and sele cting the option to
display the account total field <quote>Total (USD)</quote>. You will see a new column in the		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		main window entitled <guilabel>Total (USD)</guilabel> that will express the value of all
commodities in the report currency.		commodities in the report currency.
</para>		</para>
<screenshot id="invest-stockvalue">		<figure>
<mediaobject>		<title>Displaying Stock Values in the Chart of Accounts</title>
<imageobject role="html">		<screenshot id="invest-stockvalue">
<imagedata fileref="figures/invest_stockvalue.png"		<mediaobject>
srccredit="Cristian Marchi" width="510px"/>		<imageobject>
</imageobject>		<imagedata fileref="figures/invest_stockvalue.png"
		srccredit="Cristian Marchi"/>
<imageobject role="fo">		</imageobject>
<imagedata fileref="figures/invest_stockvalue.png"		<caption>
srccredit="Cristian Marchi"/>		<para>Viewing the value of a stock commodity in the main window us
</imageobject>		ing the Total in Report Currency option.
		</para>
<textobject>		</caption>
<phrase>Viewing Stock Value</phrase>		</mediaobject>
</textobject>		</screenshot>
		</figure>
<caption>
<para>Viewing the value of a stock commodity in the main window usin
g the Total in Report Currency option.
</para>
</caption>
</mediaobject>
</screenshot>
</sect2>		</sect2>
<sect2 id="invest-stockprice-report">		<sect2 id="invest-stockprice-report">
<title>The <quote>Price Source</quote> in Reports</title>		<title>The <quote>Price Source</quote> in Reports</title>
<para>Most &app; reports have options to set/modify a number of parameters for the report. The Options		<para>Most &app; reports have options to set/modify a number of parameters for the report. The Options
dialog box is displayed by selecting the report tab, then ether clicking on the		dialog box is displayed by selecting the report tab, then ether clicking on the
<guibutton>Options</guibutton> icon in the <emphasis>Menubar</emphasis> or selecting		<guibutton>Options</guibutton> icon in the <emphasis>Menubar</emphasis> or selecting
<menuchoice>		<menuchoice>
<guimenu>Edit</guimenu><guimenuitem>Report Options</guimenuitem>		<guimenu>Edit</guimenu><guimenuitem>Report Options</guimenuitem>
</menuchoice>.		</menuchoice>.
<guilabel>Price Source</guilabel> determines how accounts denominated in commodities		<guilabel>Price Source</guilabel> determines how accounts denominated in commodities
different from the report currency are converted to the report currency. Depending on the		different from the report currency are converted to the report currency. Depending on the
report the selector may appear in either the <guilabel>General</guilabel >, the		report the selector may appear in either the <guilabel>General</guilabel >, the
<guilabel>Commodities</guilabel>, or the <guilabel>Display</guilabel> ta b of the		<guilabel>Commodities</guilabel>, or the <guilabel>Display</guilabel> ta b of the
<guilabel>Report Options</guilabel> dialog box.		<guilabel>Report Options</guilabel> dialog box.
<note>
<simpara>In the example the report can be customized using the
<menuchoice><guimenu>Reports</guimenu><guisubmenu>Assets &amp; Liabi
lities</guisubmenu><guimenuitem>Average Balance</guimenuitem></menuchoice> menu.
</simpara>
</note>
</para>		</para>
		<note>
		<simpara>In the example the report can be customized using the
		<menuchoice><guimenu>Reports</guimenu><guisubmenu>Assets &amp; Liabili
		ties</guisubmenu><guimenuitem>Average Balance</guimenuitem></menuchoice> menu.
		</simpara>
		</note>
		<!-- ToDo: unshrink -->
		<figure>
		<title>Determining The Source Of The Stock Price/Currency Exchange Rate
		in Reports</title>
<screenshot id="invest-stockvalue-report-options">		<screenshot id="invest-stockvalue-report-options">
<mediaobject>		<mediaobject>
<imageobject>		<imageobject>
<imagedata fileref="figures/invest_stockvalue_report_options.png"		<imagedata fileref="figures/invest_stockvalue_report_options.png"
srccredit="John Ralls"/>		srccredit="John Ralls"/>
</imageobject>		</imageobject>
<textobject>
<phrase>Determining Stock Price/Currency Exchange Rate Source in R
eports</phrase>
</textobject>
<caption>		<caption>
<para>Determining the value of a stock commodity or a currency oth er than the report currency in a report		<para>Determining the value of a stock commodity or a currency oth er than the report currency in a report
by setting the Price Source option.		by setting the Price Source option.
</para>		</para>
</caption>		</caption>
</mediaobject>		</mediaobject>
</screenshot>		</screenshot>
		</figure>
<variablelist>		<variablelist>
<varlistentry>		<varlistentry>
<term><guilabel>Weighted Average</guilabel></term>		<term><guilabel>Weighted Average</guilabel></term>
<listitem><para>Calculates the price by summing the absolute value of th		<listitem><para>Calculates the price by summing the absolute value of
e		the
amount and the absolute value of every split in every account deno		amount and the absolute value of every split in every account denomi
minated in the		nated in the
commodity, excluding those splits with a zero amount, and dividing		commodity, excluding those splits with a zero amount, and dividing t
the sum of values		he sum of values
by the sum of amounts to obtain a price. For example, if you had a		by the sum of amounts to obtain a price. For example, if you had a b
buy transaction for		uy transaction for
200 shares of XYZ for a total of 2000 and a sell of 100 for 1300 t		200 shares of XYZ for a total of 2000 and a sell of 100 for 1300 the
he weighted average		weighted average
would be 3300/300 or 11/share.		would be 3300/300 or 11/share.
		</para>
<note>		<note>
<para>Gain/Loss splits have an amount of 0 and are <emphasis>not</ emphasis> included in this calculation.		<para>Gain/Loss splits have an amount of 0 and are <emphasis>not</ emphasis> included in this calculation.
</para>		</para>
</note>		</note>
</para>		</listitem>
</listitem>		</varlistentry>
</varlistentry>
<varlistentry>		<varlistentry>
<term><guilabel>Average Cost</guilabel></term>		<term><guilabel>Average Cost</guilabel></term>
<listitem><para>Calculates the price by summing the amounts and values o		<listitem><para>Calculates the price by summing the amounts and values
f every		of every
split in every account denominated in the commodity, including the z ero amount splits.		split in every account denominated in the commodity, including the z ero amount splits.
In the example above, with an additional split (either part of the s ale transaction or		In the example above, with an additional split (either part of the s ale transaction or
in a separate transaction) booking the gain at 0 shares and a 300 ga in, the average		in a separate transaction) booking the gain at 0 shares and a 300 ga in, the average
cost is 1000/100 (2000 original cost &minus; 1300 proceeds from the sale + 300 gain)/(200 &minus;		cost is 1000/100 (2000 original cost &minus; 1300 proceeds from the sale + 300 gain)/(200 &minus;
100) shares or 10/share.		100) shares or 10/share.
		</para>
<note>		<note>
<itemizedlist>		<itemizedlist>
<listitem><simpara>Gain/Loss splits <emphasis>are</emphasis> inc luded in this calculation.</simpara></listitem>		<listitem><simpara>Gain/Loss splits <emphasis>are</emphasis> inc luded in this calculation.</simpara></listitem>
<listitem><simpara>This is the <emphasis>only</emphasis> <guilab el>Price Source</guilabel> that will balance the		<listitem><simpara>This is the <emphasis>only</emphasis> <guilab el>Price Source</guilabel> that will balance the
<guilabel>Trial Balance Report</guilabel> and in order for it to b alance you		<guilabel>Trial Balance Report</guilabel> and in order for it to b alance you
<emphasis>must</emphasis> correctly book your gains and losses.</s impara></listitem>		<emphasis>must</emphasis> correctly book your gains and losses.</s impara></listitem>
</itemizedlist>		</itemizedlist>
</note>		</note>
</para>		</listitem>
</listitem>		</varlistentry>
</varlistentry>
<varlistentry>		<varlistentry>
<term><guilabel>Most Recent</guilabel></term>		<term><guilabel>Most Recent</guilabel></term>
<listitem><para>Uses the latest price from the price database.</para></l		<listitem><para>Uses the latest price from the price database.</para><
istitem>		/listitem>
</varlistentry>		</varlistentry>
<varlistentry>		<varlistentry>
<term><guilabel>Nearest in time</guilabel></term>		<term><guilabel>Nearest in time</guilabel></term>
<listitem><para>Uses the price nearest in time to the report date&mdash;		<listitem><para>Uses the price nearest in time to the report date&mdas
the		h;the
datum date for time series reports like <guilabel>Assets Over		datum date for time series reports like <guilabel>Assets Over
Time</guilabel>&mdash;from the price database.		Time</guilabel>&mdash;from the price database.
<note>		<note>
<simpara>The nearest date isn&rsquo;t necessarily before the dat e in question.</simpara>		<simpara>The nearest date isn&rsquo;t necessarily before the dat e in question.</simpara>
</note>		</note>
</para>		</para>
</listitem>		</listitem>
</varlistentry>		</varlistentry>
</variablelist>		</variablelist>
<screenshot id="invest-stockvalue-report">		<figure>
<mediaobject>		<title>An Asset Barchart Report Based On The <quote>Nearest In Time</quo
<imageobject>		te> Price Source</title>
<imagedata fileref="figures/invest_stockvalue_report.png"		<screenshot id="invest-stockvalue-report">
srccredit="Dave Herman"/>		<mediaobject>
</imageobject>		<imageobject>
		<imagedata fileref="figures/invest_stockvalue_report.png"
<textobject>		srccredit="Dave Herman"/>
<phrase>An Asset Barchart Report based on the <guilabel>Nearest in t		</imageobject>
ime</guilabel> Price		<caption>
Source.</phrase>		<para>Tracking what value your stocks would&rsquo;ve had on the st
</textobject>		ock exchanges.
		</para>
<caption>		</caption>
<para>Tracking what value your stocks would&rsquo;ve had on the stoc		</mediaobject>
k exchanges.		</screenshot>
</para>		</figure>
</caption>
</mediaobject>
</screenshot>
</sect2>		</sect2>
</sect1>		</sect1>
<sect1 id="invest-sell1">		<sect1 id="invest-sell1">
<title>Selling Shares</title>		<title>Selling Shares</title>
<para>Entering an investment sale transaction is done in a similar way to en tering a buy transaction (see		<para>Entering an investment sale transaction is done in a similar way to en tering a buy transaction (see
<xref linkend="invest-buy-new2" />) except the amount entered in the		<xref linkend="invest-buy-new2" />) except the amount entered in the
<guilabel>Shares</guilabel> column is negative and the proceeds of the tra nsaction is entered		<guilabel>Shares</guilabel> column is negative and the proceeds of the tra nsaction is entered
in the <guilabel>Sell</guilabel> column. The net proceeds from the sale sh ould be transferred		in the <guilabel>Sell</guilabel> column. The net proceeds from the sale sh ould be transferred
skipping to change at line 1816		skipping to change at line 1605
</para>		</para>
<sect4 id="invest-sell-man-comb-gr">		<sect4 id="invest-sell-man-comb-gr">
<title>Combined, Gross Pricing</title>		<title>Combined, Gross Pricing</title>
<table>		<table>
<title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are C ombined, Gross Pricing</title>		<title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are C ombined, Gross Pricing</title>
<tgroup cols="5">		<tgroup cols="5">
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<tbody>		<tbody>
<row>		<row>
<entry>		<entry>
<emphasis>Account</emphasis>		<emphasis>Account</emphasis>
</entry>		</entry>
<entry>		<entry>
<emphasis>Number of Shares</emphasis>		<emphasis>Number of Shares</emphasis>
skipping to change at line 1943		skipping to change at line 1728
</entry>		</entry>
<entry>		<entry>
GROSS_PROFIT		GROSS_PROFIT
</entry>		</entry>
</row>		</row>
</tbody>		</tbody>
</tgroup>		</tgroup>
</table>		</table>
<example>		<example>
		<title>Sale of Shares with Profit, Manual Profit/Loss Calculation, S
<title>Sale of Shares with Profit, Manual Profit/Loss Calculation, Sale		ale &amp; Profit Combined,
&amp; Profit Combined,		Gross Pricing</title>
Gross Pricing</title>
		<simpara>In this example, we will use the AMZN account created in <x
<simpara>In this example, we will use the AMZN account created in <xref		ref linkend="invest-setup-example2" />.</simpara>
linkend="invest-setup-example2" />.</simpara>		<para>You bought 100 shares of AMZN for $20 per share, then later se
<para>		ll them all for $36
You bought 100 shares of AMZN for $20 per share, then later sell them al		per share with a commission of $75. The split transaction scheme i
l for $36		s as follows:
per share with a commission of $75. The split transaction scheme is as		<itemizedlist>
follows:		<listitem><simpara>GROSS_BUY_PRICE is $20 (the original buying p
<itemizedlist>		rice),</simpara></listitem>
<listitem><simpara>GROSS_BUY_PRICE is $20 (the original buying price		<listitem><simpara>NUM_SHARES is 100,</simpara></listitem>
),</simpara></listitem>		<listitem><simpara>GROSS_BUY is $2,000 (the original buying cost
<listitem><simpara>NUM_SHARES is 100,</simpara></listitem>		),</simpara></listitem>
<listitem><simpara>GROSS_BUY is $2,000 (the original buying cost),</		<listitem><simpara>GROSS_SALE is $3,600,</simpara></listitem>
simpara></listitem>		<listitem><simpara>and finally GROSS_PROFIT is $1,600 (GROSS_SAL
<listitem><simpara>GROSS_SALE is $3,600,</simpara></listitem>		E &minus; GROSS_BUY).</simpara></listitem>
<listitem><simpara>and finally GROSS_PROFIT is $1,600 (GROSS_SALE &m		</itemizedlist>
inus; GROSS_BUY).</simpara></listitem>
</itemizedlist>
</para>
<para>
<table>
<title>Selling Shares Split Scheme, Sale &amp; Gain Combined, Gross Pr
icing</title>
<?dbfo table-width="70%" ?>
<tgroup cols="5">
<colspec colnum="1" colwidth="4*"/>
<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="1*"/>
<colspec colnum="1" colwidth="1*"/>
<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 ABC
</entry>
<entry></entry>
<entry></entry>
<entry>
3525.00
</entry>
<entry></entry>
</row>
<row>
<entry>
Assets:Brokerage Account:Stock:AMZN
</entry>
<entry>
0
</entry>
<entry>
0
</entry>
<entry>
1600.00
</entry>
<entry></entry>
</row>
<row>
<entry>
Expenses:Commission
</entry>
<entry></entry>
<entry></entry>
<entry>
75.00
</entry>
<entry></entry>
</row>
<row>
<entry>
Assets:Brokerage Account:Stock:AMZN
</entry>
<entry>
&minus;100
</entry>
<entry>
36.00
</entry>
<entry></entry>
<entry>
3600.00
</entry>
</row>
<row>
<entry>
Income:Capital Gain (Long Term):AMZN
</entry>
<entry></entry>
<entry></entry>
<entry></entry>
<entry>
1600.00
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para>
<figure pgwide="1">
<title>Selling Shares, Gain Combined, Gross Pricing</title>
<screenshot id="invest-sellstockManProfComb">
<mediaobject>
<imageobject role="html">
<imagedata fileref="figures/invest_sellstock.png"
srccredit="Chris Good" width="510px"/>
</imageobject>
<imageobject role="fo">
<imagedata fileref="figures/invest_sellstock.png"
srccredit="Chris Good"/>
</imageobject>
<textobject><phrase>Selling Shares,Gain Combined, Gross Pricing</p
hrase></textobject>
</mediaobject>
</screenshot>
</figure>
<note>
<para>In the above screenshot, it appears there are 2 transactions f
or Mar. 21, 2006. This is because the
register is in <guilabel> Auto-Split Ledger</guilabel> view and th
ere are 2 splits for
the register account in the 1 transaction. <guilabel>Transaction J
ournal</guilabel>
view may be clearer. Refer to <xref linkend="txns-registers-txntyp
es" />. As there are 2
splits for the register account in the sale transaction, this tran
saction must be
entered in <guilabel>Auto-Split Ledger</guilabel> or <guilabel>Tra
nsaction
Journal</guilabel> view. It cannot be entered in <guilabel>Basic L
edger</guilabel> view.
</para>		</para>
</note>		<para><!-- Hack to get a figure inside of an example -->
</para>		<table>
<para>		<title>Selling Shares Split Scheme, Sale &amp; Gain Combined, Gr
<figure pgwide="1">		oss Pricing</title>
<title>the Account Tree after the Example of Selling Shares for a Ga		<?dbfo table-width="70%" ?>
in</title>		<tgroup cols="5">
<screenshot id="invest-sellstockManProfComb2">		<colspec colnum="1" colwidth="4*"/>
<mediaobject>		<colspec colnum="1" colwidth="2*"/>
<imageobject role="html">		<colspec colnum="1" colwidth="2*"/>
<imagedata fileref="figures/invest_sellstock2.png"		<colspec colnum="1" colwidth="1*"/>
srccredit="Chris Good" width="510px"/>		<colspec colnum="1" colwidth="1*"/>
</imageobject>
		<tbody>
<imageobject role="fo">		<row>
<imagedata fileref="figures/invest_sellstock2.png"		<entry>
srccredit="Chris Good"/>		<emphasis>Account</emphasis>
</imageobject>		</entry>
<textobject><phrase>Selling Shares Example</phrase></textobjec		<entry>
t>		<emphasis>Shares</emphasis>
		</entry>
</mediaobject>
</screenshot>		<entry>
</figure>		<emphasis>Price</emphasis>
</para>		</entry>
</example>		<entry>
		<emphasis>Buy</emphasis>
		</entry>
		<entry>
		<emphasis>Sell</emphasis>
		</entry>
		</row>
		<row>
		<entry>
		Assets:Bank ABC
		</entry>
		<entry></entry>
		<entry></entry>
		<entry>
		3525.00
		</entry>
		<entry></entry>
		</row>
		<row>
		<entry>
		Assets:Brokerage Account:Stock:AMZN
		</entry>
		<entry>
		0
		</entry>
		<entry>
		0
		</entry>
		<entry>
		1600.00
		</entry>
		<entry></entry>
		</row>
		<row>
		<entry>
		Expenses:Commission
		</entry>
		<entry></entry>
		<entry></entry>
		<entry>
		75.00
		</entry>
		<entry></entry>
		</row>
		<row>
		<entry>
		Assets:Brokerage Account:Stock:AMZN
		</entry>
		<entry>
		&minus;100
		</entry>
		<entry>
		36.00
		</entry>
		<entry></entry>
		<entry>
		3600.00
		</entry>
		</row>
		<row>
		<entry>
		Income:Capital Gain (Long Term):AMZN
		</entry>
		<entry></entry>
		<entry></entry>
		<entry></entry>
		<entry>
		1600.00
		</entry>
		</row>
		</tbody>
		</tgroup>
		</table>
		<figure pgwide="1">
		<title>Selling Shares, Gain Combined, Gross Pricing</title>
		<screenshot id="invest-sellstockManProfComb">
		<mediaobject>
		<imageobject role="html">
		<imagedata fileref="figures/invest_sellstock.png"
		srccredit="Chris Good" width="&img-w;"/>
		</imageobject>
		<imageobject role="fo">
		<imagedata fileref="figures/invest_sellstock.png"
		srccredit="Chris Good"/>
		</imageobject>
		</mediaobject>
		</screenshot>
		</figure>
		<note>
		<para>In the above screenshot, it appears there are 2 transactio
		ns for Mar. 21, 2006. This is because the
		register is in <guilabel> Auto-Split Ledger</guilabel> view an
		d there are 2 splits for
		the register account in the 1 transaction. <guilabel>Transacti
		on Journal</guilabel>
		view may be clearer. Refer to <xref linkend="txns-registers-tx
		ntypes" />. As there are 2
		splits for the register account in the sale transaction, this
		transaction must be
		entered in <guilabel>Auto-Split Ledger</guilabel> or <guilabel
		>Transaction
		Journal</guilabel> view. It cannot be entered in <guilabel>Bas
		ic Ledger</guilabel> view.
		</para>
		</note>
		<figure pgwide="1">
		<title>The Account Tree after the Example of Selling Shares for
		a Gain</title>
		<screenshot id="invest-sellstockManProfComb2">
		<mediaobject>
		<imageobject role="html">
		<imagedata fileref="figures/invest_sellstock2.png"
		srccredit="Chris Good" width="&img-w;"/>
		</imageobject>
		<imageobject role="fo">
		<imagedata fileref="figures/invest_sellstock2.png"
		srccredit="Chris Good"/>
		</imageobject>
		</mediaobject>
		</screenshot>
		</figure>
		</para>
		</example>
</sect4>		</sect4>
<sect4 id="invest-sell-man-comb-net">		<sect4 id="invest-sell-man-comb-net">
<title>Combined, Net Pricing</title>		<title>Combined, Net Pricing</title>
<table>		<table>
<title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are C ombined, Net Pricing</title>		<title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are C ombined, Net Pricing</title>
<tgroup cols="5">		<tgroup cols="5">
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<tbody>		<tbody>
<row>		<row>
<entry>		<entry>
<emphasis>Account</emphasis>		<emphasis>Account</emphasis>
</entry>		</entry>
<entry>		<entry>
<emphasis>Number of Shares</emphasis>		<emphasis>Number of Shares</emphasis>
skipping to change at line 2266		skipping to change at line 2026
</entry>		</entry>
<entry>		<entry>
NET_PROFIT		NET_PROFIT
</entry>		</entry>
</row>		</row>
</tbody>		</tbody>
</tgroup>		</tgroup>
</table>		</table>
<example>		<example>
<title>Sale of Shares with Profit, Manual Profit/Loss Calculation, Sale		<title>Sale of Shares with Profit, Manual Profit/Loss Calculation, S
&amp; Profit Combined, Net Pricing</title>		ale &amp; Profit Combined, Net Pricing</title>
<simpara>In this example, we will use the AMZN account created in <xref		<simpara>In this example, we will use the AMZN account created in <x
linkend="invest-setup-example2" />.</simpara>		ref linkend="invest-setup-example2" />.</simpara>
<para>You bought 100 shares of AMZN for $20 per share (including commiss		<para>You bought 100 shares of AMZN for $20 per share (including com
ions), then later		missions), then later
sell them all for $36 per share with a commission of $75. The split tr		sell them all for $36 per share with a commission of $75. The spli
ansaction scheme		t transaction scheme
is as follows:		is as follows:
<itemizedlist>		<itemizedlist>
<listitem><simpara>NUM_SHARES is 100,</simpara></listitem>		<listitem><simpara>NUM_SHARES is 100,</simpara></listitem>
<listitem><simpara>NET_BUY_PRICE is $20 (the original buying price),		<listitem><simpara>NET_BUY_PRICE is $20 (the original buying pri
</simpara></listitem>		ce),</simpara></listitem>
<listitem><simpara>NET_BUY is $2,000 (the original buying cost),</si		<listitem><simpara>NET_BUY is $2,000 (the original buying cost),
mpara></listitem>		</simpara></listitem>
<listitem><simpara>NET_SELL_PRICE is $35.25 (($3600 &minus; $75) / 1		<listitem><simpara>NET_SELL_PRICE is $35.25 (($3600 &minus; $75)
00)),</simpara></listitem>		/ 100)),</simpara></listitem>
<listitem><simpara>GROSS_SALE is $3,600, NET_SALE is $3,525,</simpar		<listitem><simpara>GROSS_SALE is $3,600, NET_SALE is $3,525,</si
a></listitem>		mpara></listitem>
<listitem><simpara>and finally NET_PROFIT is $1,525 (NET_SALE &minus		<listitem><simpara>and finally NET_PROFIT is $1,525 (NET_SALE &m
; NET_BUY).</simpara></listitem>		inus; NET_BUY).</simpara></listitem>
</itemizedlist>		</itemizedlist>
</para>		</para>
<para>
<table>
<title>Selling Shares Split Scheme, Sale &amp; Gain Combined, Net
Pricing</title>
<?dbfo table-width="70%" ?>
<tgroup cols="5">
<colspec colnum="1" colwidth="4*"/>
<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="1*"/>
<colspec colnum="1" colwidth="1*"/>
<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 ABC
</entry>
<entry></entry>
<entry></entry>
<entry>
3525.00
</entry>
<entry></entry>
</row>
<row>
<entry>
Assets:Brokerage Account:Stock:AMZN
</entry>
<entry>
0
</entry>
<entry>
0
</entry>
<entry>
1525.00
</entry>
<entry></entry>
</row>
<row>
<entry>
Assets:Brokerage Account:Stock:AMZN
</entry>
<entry>
&minus;100
</entry>
<entry>
35.25
</entry>
<entry></entry>
<entry>
3525.00
</entry>
</row>
<row>
<entry>
Income:Capital Gain (Long Term):AMZN
</entry>
<entry></entry>
<entry></entry>
<entry></entry>
<entry>
1525.00
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para>
<figure pgwide="1">
<title>Selling Shares for Gain using Net Pricing in Transaction Jour
nal View</title>
<screenshot id="invest-sellstockManProfCombNet">
<mediaobject>
<imageobject role="html">
<imagedata fileref="figures/invest_sellstockManProfCombNet.png
"
srccredit="Chris Good" width="510px"/>
</imageobject>
<imageobject role="fo">
<imagedata fileref="figures/invest_sellstockManProfCombNet.png
"
srccredit="Chris Good"/>
</imageobject>
<textobject><phrase>Selling Shares Example</phrase></textobject>
</mediaobject>		<para><!-- Hack to get a figures and tables inside of an example -->
</screenshot>		<table>
</figure>		<title>Selling Shares Split Scheme, Sale &amp; Gain Combined, Ne
</para>		t Pricing</title>
</example>		<?dbfo table-width="70%" ?>
		<tgroup cols="5">
		<colspec colnum="1" colwidth="4*"/>
		<colspec colnum="1" colwidth="2*"/>
		<colspec colnum="1" colwidth="2*"/>
		<colspec colnum="1" colwidth="1*"/>
		<colspec colnum="1" colwidth="1*"/>
		<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 ABC
		</entry>
		<entry></entry>
		<entry></entry>
		<entry>
		3525.00
		</entry>
		<entry></entry>
		</row>
		<row>
		<entry>
		Assets:Brokerage Account:Stock:AMZN
		</entry>
		<entry>
		0
		</entry>
		<entry>
		0
		</entry>
		<entry>
		1525.00
		</entry>
		<entry></entry>
		</row>
		<row>
		<entry>
		Assets:Brokerage Account:Stock:AMZN
		</entry>
		<entry>
		&minus;100
		</entry>
		<entry>
		35.25
		</entry>
		<entry></entry>
		<entry>
		3525.00
		</entry>
		</row>
		<row>
		<entry>
		Income:Capital Gain (Long Term):AMZN
		</entry>
		<entry></entry>
		<entry></entry>
		<entry></entry>
		<entry>
		1525.00
		</entry>
		</row>
		</tbody>
		</tgroup>
		</table>
		<figure pgwide="1">
		<title>Selling Shares for Gain using Net Pricing in Transaction
		Journal View</title>
		<screenshot id="invest-sellstockManProfCombNet">
		<mediaobject>
		<imageobject role="html">
		<imagedata fileref="figures/invest_sellstockManProfCombNet
		.png"
		srccredit="Chris Good" width="&img-w;"/>
		</imageobject>
		<imageobject role="fo">
		<imagedata fileref="figures/invest_sellstockManProfCombNet
		.png"
		srccredit="Chris Good"/>
		</imageobject>
		</mediaobject>
		</screenshot>
		</figure>
		</para>
		</example>
</sect4>		</sect4>
</sect3>		</sect3>
<sect3 id="invest-sell-man-sep">		<sect3 id="invest-sell-man-sep">
<title>Separate the Capital Gain/Loss Transaction from the Sale Transact ion</title>		<title>Separate the Capital Gain/Loss Transaction from the Sale Transact ion</title>
<para>This is <emphasis>required</emphasis> if using <emphasis>scrubbing </emphasis> to		<para>This is <emphasis>required</emphasis> if using <emphasis>scrubbing </emphasis> to
calculate and create capital gain/loss transactions automatically. Oth erwise scrubbing will not detect		calculate and create capital gain/loss transactions automatically. Oth erwise scrubbing will not detect
them and will create an incorrectly valued capital gain/loss transacti on.		them and will create an incorrectly valued capital gain/loss transacti on.
</para>		</para>
<sect4 id="invest-sell-man-sep-gr">		<sect4 id="invest-sell-man-sep-gr">
<title>Separated, Gross Pricing</title>		<title>Separated, Gross Pricing</title>
<table>		<table>
<title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are S eparate Transactions, Sale Transaction</title>		<title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are S eparate Transactions, Sale Transaction</title>
<tgroup cols="5">		<tgroup cols="5">
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<tbody>		<tbody>
<row>		<row>
<entry>		<entry>
<emphasis>Account</emphasis>		<emphasis>Account</emphasis>
</entry>		</entry>
<entry>		<entry>
<emphasis>Number of Shares</emphasis>		<emphasis>Number of Shares</emphasis>
skipping to change at line 2531		skipping to change at line 2277
</tbody>		</tbody>
</tgroup>		</tgroup>
</table>		</table>
<table>		<table>
<title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are S eparate Transactions, Capital Gain/Loss		<title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are S eparate Transactions, Capital Gain/Loss
Transaction</title>		Transaction</title>
<tgroup cols="5">		<tgroup cols="5">
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<tbody>		<tbody>
<row>		<row>
<entry>		<entry>
<emphasis>Account</emphasis>		<emphasis>Account</emphasis>
</entry>		</entry>
<entry>		<entry>
<emphasis>Number of Shares</emphasis>		<emphasis>Number of Shares</emphasis>
skipping to change at line 2605		skipping to change at line 2347
(Loss)		(Loss)
</entry>		</entry>
<entry>		<entry>
GROSS_PROFIT		GROSS_PROFIT
</entry>		</entry>
</row>		</row>
</tbody>		</tbody>
</tgroup>		</tgroup>
</table>		</table>
<example>		<example>
<title>Sale of Shares with Profit, Manual Profit/Loss Calculation, Sale		<title>Sale of Shares with Profit, Manual Profit/Loss Calculation, S
&amp; Profit Separated, Gross Pricing</title>		ale &amp; Profit Separated, Gross Pricing</title>
<simpara>In this example, we will use the AMZN account created in <xref		<simpara>In this example, we will use the AMZN account created in <x
linkend="invest-setup-example2" />.</simpara>		ref linkend="invest-setup-example2" />.</simpara>
<para>You bought 100 shares of AMZN for $20 per share and commissions $2
0, then later sell them all for
$36 per share with a commission of $75. The split transaction scheme i
s as follows:
<itemizedlist>
<listitem><simpara>GROSS_BUY_PRICE is $20 (the original buying price
),</simpara></listitem>
<listitem><simpara>NUM_SHARES is 100,</simpara></listitem>
<listitem><simpara>GROSS_BUY is $2,000 (the original buying cost),</
simpara></listitem>
<listitem><simpara>GROSS_SALE is $3,600,</simpara></listitem>
<listitem><simpara>finally GROSS_PROFIT is $1,600 (GROSS_SALE &minus
; GROSS_BUY).</simpara></listitem>
</itemizedlist>
</para>
<para>
<table>
<title>Selling Shares Split Scheme, Sale Transaction, Gross Pricing</t
itle>
<?dbfo table-width="70%" ?>
<tgroup cols="5">
<colspec colnum="1" colwidth="4*"/>
<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="1*"/>
<colspec colnum="1" colwidth="1*"/>
<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 ABC
</entry>
<entry></entry>
<entry></entry>
<entry>
3525.00
</entry>
<entry></entry>
</row>
<row>
<entry>
Expenses:Commission
</entry>
<entry></entry>
<entry></entry>
<entry>
75.00
</entry>
<entry></entry>
</row>
<row>
<entry>
Assets:Brokerage Account:Stock:AMZN
</entry>
<entry>
&minus;100
</entry>
<entry>
36.00
</entry>
<entry></entry>
<entry>
3600.00
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para>
<table>
<title>Selling Shares Split Scheme, Gain Transaction, Gross Pricing</t
itle>
<?dbfo table-width="70%" ?>
<tgroup cols="5">
<colspec colnum="1" colwidth="4*"/>
<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="1*"/>
<colspec colnum="1" colwidth="1*"/>
<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:Brokerage Account:Stock:AMZN
</entry>
<entry>
0
</entry>
<entry>
0
</entry>
<entry>
1600.00
</entry>
<entry></entry>
</row>
<row>
<entry>
Income:Capital Gain (Long Term):AMZN
</entry>
<entry></entry>
<entry></entry>
<entry></entry>
<entry>
1600.00
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para>
<figure pgwide="1">
<title>Selling Shares for Gain Where the Sale and Gain are Recorded in S
eparate Transactions,
in <guilabel>Transaction Journal</guilabel> View</title>
<screenshot id="invest-sellstockManProfSep">
<mediaobject>
<imageobject role="html">
<imagedata fileref="figures/invest_sellstockManProfSep.png"
srccredit="Chris Good" width="510px"/>
</imageobject>
<imageobject role="fo">
<imagedata fileref="figures/invest_sellstockManProfSep.png"
srccredit="Chris Good"/>
</imageobject>
<textobject><phrase>Selling Shares Example</phrase></textobject>		<para>You bought 100 shares of AMZN for $20 per share and commission
		s $20, then later sell them all for
</mediaobject>		$36 per share with a commission of $75. The split transaction sche
</screenshot>		me is as follows:
</figure>		<itemizedlist>
</para>		<listitem><simpara>GROSS_BUY_PRICE is $20 (the original buying p
</example>		rice),</simpara></listitem>
		<listitem><simpara>NUM_SHARES is 100,</simpara></listitem>
		<listitem><simpara>GROSS_BUY is $2,000 (the original buying cost
		),</simpara></listitem>
		<listitem><simpara>GROSS_SALE is $3,600,</simpara></listitem>
		<listitem><simpara>finally GROSS_PROFIT is $1,600 (GROSS_SALE &m
		inus; GROSS_BUY).</simpara></listitem>
		</itemizedlist>
		</para>
		<para>
		<table>
		<title>Selling Shares Split Scheme, Sale Transaction, Gross Pric
		ing</title>
		<?dbfo table-width="70%" ?>
		<tgroup cols="5">
		<colspec colnum="1" colwidth="4*"/>
		<colspec colnum="1" colwidth="2*"/>
		<colspec colnum="1" colwidth="2*"/>
		<colspec colnum="1" colwidth="1*"/>
		<colspec colnum="1" colwidth="1*"/>
		<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 ABC
		</entry>
		<entry></entry>
		<entry></entry>
		<entry>
		3525.00
		</entry>
		<entry></entry>
		</row>
		<row>
		<entry>
		Expenses:Commission
		</entry>
		<entry></entry>
		<entry></entry>
		<entry>
		75.00
		</entry>
		<entry></entry>
		</row>
		<row>
		<entry>
		Assets:Brokerage Account:Stock:AMZN
		</entry>
		<entry>
		&minus;100
		</entry>
		<entry>
		36.00
		</entry>
		<entry></entry>
		<entry>
		3600.00
		</entry>
		</row>
		</tbody>
		</tgroup>
		</table>
		<table>
		<title>Selling Shares Split Scheme, Gain Transaction, Gross Pric
		ing</title>
		<?dbfo table-width="70%" ?>
		<tgroup cols="5">
		<colspec colnum="1" colwidth="4*"/>
		<colspec colnum="1" colwidth="2*"/>
		<colspec colnum="1" colwidth="2*"/>
		<colspec colnum="1" colwidth="1*"/>
		<colspec colnum="1" colwidth="1*"/>
		<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:Brokerage Account:Stock:AMZN
		</entry>
		<entry>
		0
		</entry>
		<entry>
		0
		</entry>
		<entry>
		1600.00
		</entry>
		<entry></entry>
		</row>
		<row>
		<entry>
		Income:Capital Gain (Long Term):AMZN
		</entry>
		<entry></entry>
		<entry></entry>
		<entry></entry>
		<entry>
		1600.00
		</entry>
		</row>
		</tbody>
		</tgroup>
		</table>
		<figure pgwide="1">
		<title>Selling Shares for Gain Where the Sale and Gain are Recor
		ded in Separate Transactions,
		in <guilabel>Transaction Journal</guilabel> View</title>
		<screenshot id="invest-sellstockManProfSep">
		<mediaobject>
		<imageobject role="html">
		<imagedata fileref="figures/invest_sellstockManProfSep.png
		"
		srccredit="Chris Good" width="&img-w;"/>
		</imageobject>
		<imageobject role="fo">
		<imagedata fileref="figures/invest_sellstockManProfSep.png
		"
		srccredit="Chris Good"/>
		</imageobject>
		</mediaobject>
		</screenshot>
		</figure>
		</para>
		</example>
</sect4>		</sect4>
<sect4 id="invest-sell-man-sep-net">		<sect4 id="invest-sell-man-sep-net">
<title>Separated, Net Pricing</title>		<title>Separated, Net Pricing</title>
<table>		<table>
<title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are S eparate Transactions, Sale Transaction</title>		<title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are S eparate Transactions, Sale Transaction</title>
<tgroup cols="5">		<tgroup cols="5">
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<tbody>		<tbody>
<row>		<row>
<entry>		<entry>
<emphasis>Account</emphasis>		<emphasis>Account</emphasis>
</entry>		</entry>
<entry>		<entry>
<emphasis>Number of Shares</emphasis>		<emphasis>Number of Shares</emphasis>
skipping to change at line 2902		skipping to change at line 2622
</tbody>		</tbody>
</tgroup>		</tgroup>
</table>		</table>
<table>		<table>
<title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are S eparate Transactions, Capital Gain/Loss		<title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are S eparate Transactions, Capital Gain/Loss
Transaction</title>		Transaction</title>
<tgroup cols="5">		<tgroup cols="5">
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<tbody>		<tbody>
<row>		<row>
<entry>		<entry>
<emphasis>Account</emphasis>		<emphasis>Account</emphasis>
</entry>		</entry>
<entry>		<entry>
<emphasis>Number of Shares</emphasis>		<emphasis>Number of Shares</emphasis>
skipping to change at line 2999		skipping to change at line 2715
<listitem><simpara>and finally NET_PROFIT is $1,525 (NET_SALE &minus ; NET_BUY).</simpara></listitem>		<listitem><simpara>and finally NET_PROFIT is $1,525 (NET_SALE &minus ; NET_BUY).</simpara></listitem>
</itemizedlist>		</itemizedlist>
</para>		</para>
<para>		<para>
<table>		<table>
<title>Selling Shares Split Scheme, Sale Transaction, Net Pricing</tit le>		<title>Selling Shares Split Scheme, Sale Transaction, Net Pricing</tit le>
<?dbfo table-width="70%" ?>		<?dbfo table-width="70%" ?>
<tgroup cols="5">		<tgroup cols="5">
<colspec colnum="1" colwidth="4*"/>		<colspec colnum="1" colwidth="4*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="1*"/>		<colspec colnum="1" colwidth="1*"/>
<colspec colnum="1" colwidth="1*"/>		<colspec colnum="1" colwidth="1*"/>
<tbody>		<tbody>
<row>		<row>
<entry>		<entry>
<emphasis>Account</emphasis>		<emphasis>Account</emphasis>
</entry>		</entry>
<entry>		<entry>
<emphasis>Shares</emphasis>		<emphasis>Shares</emphasis>
skipping to change at line 3077		skipping to change at line 2789
</tgroup>		</tgroup>
</table>		</table>
</para>		</para>
<para>		<para>
<table>		<table>
<title>Selling Shares Split Scheme, Gain Transaction, Net Pricing</tit le>		<title>Selling Shares Split Scheme, Gain Transaction, Net Pricing</tit le>
<?dbfo table-width="70%" ?>		<?dbfo table-width="70%" ?>
<tgroup cols="5">		<tgroup cols="5">
<colspec colnum="1" colwidth="4*"/>		<colspec colnum="1" colwidth="4*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="2*"/>		<colspec colnum="1" colwidth="2*"/>
<colspec colnum="1" colwidth="1*"/>		<colspec colnum="1" colwidth="1*"/>
<colspec colnum="1" colwidth="1*"/>		<colspec colnum="1" colwidth="1*"/>
<tbody>		<tbody>
<row>		<row>
<entry>		<entry>
<emphasis>Account</emphasis>		<emphasis>Account</emphasis>
</entry>		</entry>
<entry>		<entry>
<emphasis>Shares</emphasis>		<emphasis>Shares</emphasis>
skipping to change at line 3147		skipping to change at line 2855
<entry></entry>		<entry></entry>
<entry>		<entry>
1525.00		1525.00
</entry>		</entry>
</row>		</row>
</tbody>		</tbody>
</tgroup>		</tgroup>
</table>		</table>
</para>
<para>
<figure pgwide="1">		<figure pgwide="1">
<title>Selling Shares for Gain Where the Sale and Gain are Recorded in Separate Transactions,		<title>Selling Shares for Gain Where the Sale and Gain are Recorded in Separate Transactions,
in <guilabel>Transaction Journal</guilabel> View</title>		in <guilabel>Transaction Journal</guilabel> View</title>
<screenshot id="invest-sellstockManProfSepNet">		<screenshot id="invest-sellstockManProfSepNet">
<mediaobject>		<mediaobject>
<imageobject role="html">		<imageobject role="html">
<imagedata fileref="figures/invest_sellstockManProfSepNet.png"		<imagedata fileref="figures/invest_sellstockManProfSepNet.png"
srccredit="Chris Good" width="510px"/>		srccredit="Chris Good" width="&img-w;"/>
</imageobject>		</imageobject>
<imageobject role="fo">		<imageobject role="fo">
<imagedata fileref="figures/invest_sellstockManProfSep.png"		<imagedata fileref="figures/invest_sellstockManProfSep.png"
srccredit="Chris Good"/>		srccredit="Chris Good"/>
</imageobject>		</imageobject>
<textobject><phrase>Selling Shares Example</phrase>
</textobject>
</mediaobject>		</mediaobject>
</screenshot>		</screenshot>
</figure>		</figure>
</para>		</para>
</example>		</example>
</sect4>		</sect4>
</sect3>		</sect3>
</sect2>		</sect2>
<sect2 id="invest-sellLots">		<sect2 id="invest-sellLots">
<title>Selling Shares with Automatic Calculation of Capital Gain or Loss U sing Lots</title>		<title>Selling Shares with Automatic Calculation of Capital Gain or Loss U sing Lots</title>
<sect3 id="invest-sellLotsIntro">		<sect3 id="invest-sellLotsIntro">
<title>Introduction</title>		<title>Introduction</title>
<para><ulink url="&url-wp-en;Lot">Wikipedia</ulink> includes the followi		<para><ulink url="&url-wp-en;Lot">Wikipedia</ulink> includes the followi
ng definition of a lot.		ng definition of a lot:
		<blockquote>
		<simpara>a set of goods for sale together in an auction; or a quanti
		ty of a financial instrument</simpara>
		</blockquote>
</para>		</para>
<blockquote>
<simpara>a set of goods for sale together in an auction; or a quantity
of a financial instrument</simpara>
</blockquote>
<para>&app; has a built-in lot management facility that can be used to k eep track of capital gains or		<para>&app; has a built-in lot management facility that can be used to k eep track of capital gains or
losses resulting from security sales. Buy and sell transactions are pu t into lots for the		losses resulting from security sales. Buy and sell transactions are pu t into lots for the
purpose of calculating the cost of the sale. More specifically, a lot is used to link		purpose of calculating the cost of the sale. More specifically, a lot is used to link
particular buy and sell transaction splits. Lots can be automatically or manually created		particular buy and sell transaction splits. Lots can be automatically or manually created
and linked. Capital gain or loss can be automatically calculated and t ransaction(s)		and linked. Capital gain or loss can be automatically calculated and t ransaction(s)
created for the difference between the sale value and the cost of the securities sold.		created for the difference between the sale value and the cost of the securities sold.
&app; refers to this process as <emphasis>scrubbing</emphasis>.		&app; refers to this process as <emphasis>scrubbing</emphasis>.
</para>		</para>
<para>The term <emphasis>scrub</emphasis> is used because security accou nts need to be cleaned after sales		<para>The term <emphasis>scrub</emphasis> is used because security accou nts need to be cleaned after sales
to ensure the difference between the cost paid for securities, and val ue received from		to ensure the difference between the cost paid for securities, and val ue received from
selling them, is accounted for as capital gain or loss. If the capital gain/loss is not		selling them, is accounted for as capital gain or loss. If the capital gain/loss is not
correct, the <guimenuitem>Trial Balance</guimenuitem> bottom line tota l debits will not balance to total credits.		correct, the <guimenuitem>Trial Balance</guimenuitem> bottom line tota l debits will not balance to total credits.
To see the <guimenuitem>Trial Balance</guimenuitem>, select <menuchoic e>		To see the <guimenuitem>Trial Balance</guimenuitem>, select <menuchoic e>
<guimenu>Reports</guimenu> <guisubmenu>Income &amp; Expense</guisubm enu>		<guimenu>Reports</guimenu> <guisubmenu>Income &amp; Expense</guisubm enu>
<guimenuitem>Trial Balance</guimenuitem>		<guimenuitem>Trial Balance</guimenuitem>
</menuchoice>.		</menuchoice>. </para>
</para>
<note>		<note>
<para>If you make an error, you can delete the lot(s) and capital gain /loss transaction(s) and retry.		<para>If you make an error, you can delete the lot(s) and capital gain /loss transaction(s) and retry.
Ensure you delete the lot, or at least unlink sale transactions from the lot, before you		Ensure you delete the lot, or at least unlink sale transactions from the lot, before you
delete a capital gain/loss transaction. Otherwise, the <guilabel>Lot s in		delete a capital gain/loss transaction. Otherwise, the <guilabel>Lot s in
Account</guilabel> screen will recreate the capital gain/loss transa ction when you		Account</guilabel> screen will recreate the capital gain/loss transa ction when you
select the lot.		select the lot.
</para>		</para>
</note>		</note>
skipping to change at line 3253		skipping to change at line 2951
<para>The <guilabel>Lots in Account SSSS</guilabel> window, where SSSS i s a security account, is used to		<para>The <guilabel>Lots in Account SSSS</guilabel> window, where SSSS i s a security account, is used to
manually or automatically link security transaction splits to lots and create capital		manually or automatically link security transaction splits to lots and create capital
gain/loss transactions to account for the difference between the costs of buying a		gain/loss transactions to account for the difference between the costs of buying a
security and the value received by selling it.		security and the value received by selling it.
</para>		</para>
<para>To open the <guilabel>Lots in Account</guilabel> window, open the security account register, then		<para>To open the <guilabel>Lots in Account</guilabel> window, open the security account register, then
select		select
<menuchoice>		<menuchoice>
<guimenu>Actions</guimenu> <guimenuitem>View Lots</guimenuitem>		<guimenu>Actions</guimenu><guimenuitem>View Lots</guimenuitem>
</menuchoice>.		</menuchoice>.
</para>		</para>
<figure pgwide="1">		<figure pgwide="1">
<title>Selling Shares - Capital Gains - Lots in Account window</title> <screenshot id="tool-lotsInAcct">		<title>Selling Shares - Capital Gains - Lots in Account window</title> <screenshot id="tool-lotsInAcct">
<mediaobject>		<mediaobject>
<imageobject role="html">		<imageobject role="html">
<imagedata fileref="figures/investLots2_BeforeScrub1Lot.png"		<imagedata fileref="figures/investLots2_BeforeScrub1Lot.png"
srccredit="Chris Good" width="510px"/>		srccredit="Chris Good" width="&img-w;"/>
</imageobject>		</imageobject>
<imageobject role="fo">		<imageobject role="fo">
<imagedata fileref="figures/investLots2_BeforeScrub1Lot.png"		<imagedata fileref="figures/investLots2_BeforeScrub1Lot.png"
srccredit="Chris Good"/>		srccredit="Chris Good"/>
</imageobject>		</imageobject>
<textobject>
<phrase>Example of Lots in Account window</phrase>
</textobject>
<caption>		<caption>
<para>An image of the <emphasis>Lots in Account</emphasis> windo w.		<para>An image of the <emphasis>Lots in Account</emphasis> windo w.
</para>		</para>
</caption>		</caption>
</mediaobject>		</mediaobject>
</screenshot>		</screenshot>
</figure>		</figure>
<para>Refer to the Help Manual, Chapter 8 Tools &amp; Assistants,		<para>Refer to the Help Manual, Chapter 8 Tools &amp; Assistants,
<ulink		<ulink url="&url-docs;/C/gnucash-help/tool-lots.html">Lots in Account<
url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html		/ulink>
">		for details of the Lots in Account screen elements.
Lots in Account </ulink> for details of the Lots in Account screen ele
ments.
</para>		</para>
</sect3>		</sect3>
<sect3 id="invest-sellProcedure">		<sect3 id="invest-sellProcedure">
<title>Procedure Summary</title>		<title>Procedure Summary</title>
<para>Using the lot management facility for the automatic calculation of capital gain or loss typically		<para>Using the lot management facility for the automatic calculation of capital gain or loss typically
follows these steps:		follows these steps:
<orderedlist>		<orderedlist>
skipping to change at line 3390		skipping to change at line 3081
<para>See <xref linkend="invest-sellChgCapGainsAcctExample" />.		<para>See <xref linkend="invest-sellChgCapGainsAcctExample" />.
</para>		</para>
</sect3>		</sect3>
<sect3 id="invest-sellTrialBal">		<sect3 id="invest-sellTrialBal">
<title>Run a Trial Balance</title>		<title>Run a Trial Balance</title>
<para>Running a Trial Balance report (		<para>Running a Trial Balance report (
<menuchoice>		<menuchoice>
<guimenu>Reports</guimenu> <guisubmenu>Income &amp; Expense</guisubm enu>		<guimenu>Reports</guimenu><guisubmenu>Income &amp; Expense</guisubme nu>
<guimenuitem>Trial Balance</guimenuitem>		<guimenuitem>Trial Balance</guimenuitem>
</menuchoice>		</menuchoice>
) after creating capital gain/loss transactions, is a basic check that capital		) after creating capital gain/loss transactions, is a basic check that capital
gains/losses are correctly accounting for the difference between the c ost paid for		gains/losses are correctly accounting for the difference between the c ost paid for
securities, and value received from selling them. At the end of the re port, total debits		securities, and value received from selling them. At the end of the re port, total debits
should equal total credits.		should equal total credits.
</para>		</para>
<tip>		<tip>
<para>A Trial Balance may not balance due to some other problem. To de termine if the cause of an imbalance		<para>A Trial Balance may not balance due to some other problem. To de termine if the cause of an imbalance
skipping to change at line 3627		skipping to change at line 3318
<procedure>		<procedure>
<step>		<step>
<simpara>Open the security account's register.</simpara>		<simpara>Open the security account's register.</simpara>
<figure pgwide="1">		<figure pgwide="1">
<title>Selling Shares - Capital Gains - Security register before s crubbing a single lot</title><screenshot id="invest-lots0reg">		<title>Selling Shares - Capital Gains - Security register before s crubbing a single lot</title><screenshot id="invest-lots0reg">
<mediaobject>		<mediaobject>
<imageobject role="html">		<imageobject role="html">
<imagedata fileref="figures/investLots0_RegB4Scrub.png"		<imagedata fileref="figures/investLots0_RegB4Scrub.png"
srccredit="Chris Good" width="510px"/>		srccredit="Chris Good" width="&img-w;"/>
</imageobject>		</imageobject>
<imageobject role="fo">		<imageobject role="fo">
<imagedata fileref="figures/investLots0_RegB4Scrub.png"		<imagedata fileref="figures/investLots0_RegB4Scrub.png"
srccredit="Chris Good"/>		srccredit="Chris Good"/>
</imageobject>		</imageobject>
<textobject>
<phrase>Example of security register before lot scrubbing</p
hrase>
</textobject>
<caption>		<caption>
<simpara>An image of the Security Account register in transa ction journal view, before lot scrubbing.</simpara>		<simpara>An image of the Security Account register in transa ction journal view, before lot scrubbing.</simpara>
</caption>		</caption>
</mediaobject>		</mediaobject>
</screenshot>		</screenshot>
</figure>		</figure>
</step>		</step>
<step>		<step>
<simpara>Ensure all previous capital gain/loss transactions are sepa rate transactions to the sell		<simpara>Ensure all previous capital gain/loss transactions are sepa rate transactions to the sell
transactions which record the reduction in the number of shares an d the value		transactions which record the reduction in the number of shares an d the value
received.</simpara>		received.</simpara>
</step>		</step>
<step><simpara>Select		<step><simpara>Select
<menuchoice>		<menuchoice>
<guimenu>Actions</guimenu> <guimenuitem>View Lots</guimenuitem>		<guimenu>Actions</guimenu><guimenuitem>View Lots</guimenuitem>
</menuchoice>		</menuchoice>
to open the <guilabel>Lots in Account SSSS</guilabel> window where SSSS is the		to open the <guilabel>Lots in Account SSSS</guilabel> window where SSSS is the
security account.		security account.
</simpara>		</simpara>
<figure pgwide="1">		<figure pgwide="1">
<title>Selling Shares - Capital Gains - Lots before scrubbing a si ngle lot</title><screenshot id="invest-lots1B4CreateLot">		<title>Selling Shares - Capital Gains - Lots before scrubbing a si ngle lot</title><screenshot id="invest-lots1B4CreateLot">
<mediaobject>		<mediaobject>
<imageobject role="html">		<imageobject role="html">
<imagedata fileref="figures/investLots1_BeforeCreateLot.png"		<imagedata fileref="figures/investLots1_BeforeCreateLot.png"
srccredit="Chris Good" width="510px"/>		srccredit="Chris Good" width="&img-w;"/>
</imageobject>		</imageobject>
<imageobject role="fo">		<imageobject role="fo">
<imagedata fileref="figures/investLots1_BeforeCreateLot.png"		<imagedata fileref="figures/investLots1_BeforeCreateLot.png"
srccredit="Chris Good"/>		srccredit="Chris Good"/>
</imageobject>		</imageobject>
<textobject>
<phrase>Example of Lots in Account window before lot scrubbi
ng</phrase>
</textobject>
<caption>		<caption>
<para>An image of the <emphasis>Lots in Account</emphasis> w indow before lot scrubbing.		<para>An image of the <emphasis>Lots in Account</emphasis> w indow before lot scrubbing.
</para>		</para>
</caption>		</caption>
</mediaobject>		</mediaobject>
</screenshot>		</screenshot>
</figure>		</figure>
</step>		</step>
<step><simpara>Create a new lot using the <guibutton>New Lot</guibutto n> button. Initially this lot is not linked to		<step><simpara>Create a new lot using the <guibutton>New Lot</guibutto n> button. Initially this lot is not linked to
skipping to change at line 3730		skipping to change at line 3407
should be zero as the number of securities sold in the lot, is mat ched with the same		should be zero as the number of securities sold in the lot, is mat ched with the same
number of security buys.		number of security buys.
</simpara>		</simpara>
<figure pgwide="1">		<figure pgwide="1">
<title>Selling Shares - Capital Gains - Lots before scrubbing a si ngle lot, after manual linking</title>		<title>Selling Shares - Capital Gains - Lots before scrubbing a si ngle lot, after manual linking</title>
<screenshot id="invest-lots2B4Scrub1Lot">		<screenshot id="invest-lots2B4Scrub1Lot">
<mediaobject>		<mediaobject>
<imageobject role="html">		<imageobject role="html">
<imagedata fileref="figures/investLots2_BeforeScrub1Lot.png"		<imagedata fileref="figures/investLots2_BeforeScrub1Lot.png"
srccredit="Chris Good" width="510px"/>		srccredit="Chris Good" width="&img-w;"/>
</imageobject>		</imageobject>
<imageobject role="fo">		<imageobject role="fo">
<imagedata fileref="figures/investLots2_BeforeScrub1Lot.png"		<imagedata fileref="figures/investLots2_BeforeScrub1Lot.png"
srccredit="Chris Good"/>		srccredit="Chris Good"/>
</imageobject>		</imageobject>
<textobject>
<phrase>Example of Lots in Account window before scrubbing a
single lot</phrase>
</textobject>
<caption>		<caption>
<simpara>An image of the <emphasis>Lots in Account</emphasis > window before scrubbing a single lot.</simpara>		<simpara>An image of the <emphasis>Lots in Account</emphasis > window before scrubbing a single lot.</simpara>
</caption>		</caption>
</mediaobject>		</mediaobject>
</screenshot>		</screenshot>
</figure>		</figure>
</step>		</step>
<step>		<step>
<simpara>Click the <guibutton>Scrub</guibutton> button (<emphasis>no t</emphasis> the <guibutton>Scrub Account</guibutton> button.)		<simpara>Click the <guibutton>Scrub</guibutton> button (<emphasis>no t</emphasis> the <guibutton>Scrub Account</guibutton> button.)
skipping to change at line 3769		skipping to change at line 3440
<simpara>Close the <guilabel>Lots in Account SSSS</guilabel> window and return to the security account		<simpara>Close the <guilabel>Lots in Account SSSS</guilabel> window and return to the security account
register.		register.
</simpara>		</simpara>
<figure pgwide="1">		<figure pgwide="1">
<title>Selling Shares - Capital Gains - Register after manual link ing and scrubbing a single lot</title>		<title>Selling Shares - Capital Gains - Register after manual link ing and scrubbing a single lot</title>
<screenshot id="invest-lots2RegAftScrub1Lot">		<screenshot id="invest-lots2RegAftScrub1Lot">
<mediaobject>		<mediaobject>
<imageobject role="html">		<imageobject role="html">
<imagedata fileref="figures/investLots2_RegAfterScrub1Lot.pn g"		<imagedata fileref="figures/investLots2_RegAfterScrub1Lot.pn g"
srccredit="Chris Good" width="510px"/>		srccredit="Chris Good" width="&img-w;"/>
</imageobject>		</imageobject>
<imageobject role="fo">		<imageobject role="fo">
<imagedata fileref="figures/investLots2_RegAfterScrub1Lot.pn g"		<imagedata fileref="figures/investLots2_RegAfterScrub1Lot.pn g"
srccredit="Chris Good"/>		srccredit="Chris Good"/>
</imageobject>		</imageobject>
<textobject>
<phrase>Example of Register after scrubbing a single lot</ph
rase>
</textobject>
<caption>		<caption>
<simpara>An image of the Register after scrubbing a single l ot.</simpara>		<simpara>An image of the Register after scrubbing a single l ot.</simpara>
</caption>		</caption>
</mediaobject>		</mediaobject>
</screenshot>		</screenshot>
</figure>		</figure>
</step>		</step>
<step>		<step>
<simpara>Continue to <xref linkend="invest-sellChgCapGainsAcct" />.< /simpara>		<simpara>Continue to <xref linkend="invest-sellChgCapGainsAcct" />.< /simpara>
skipping to change at line 3866		skipping to change at line 3531
<para>Here is an example of <acronym>FIFO</acronym> scrubbing without ma nual lot creation. In this example, the transactions		<para>Here is an example of <acronym>FIFO</acronym> scrubbing without ma nual lot creation. In this example, the transactions
for 2 sales are scrubbed at once but usually scrubbing would be perfor med after each sale.		for 2 sales are scrubbed at once but usually scrubbing would be perfor med after each sale.
One reason for scrubbing 2 sales at once, could be because there were multiple sales on		One reason for scrubbing 2 sales at once, could be because there were multiple sales on
the same day.		the same day.
<figure pgwide="1">		<figure pgwide="1">
<title>Selling Shares - Capital Gains - Register before Scrub Accoun t</title>		<title>Selling Shares - Capital Gains - Register before Scrub Accoun t</title>
<screenshot id="invest2-lots0reg">		<screenshot id="invest2-lots0reg">
<mediaobject>		<mediaobject>
<imageobject role="html">		<imageobject role="html">
<imagedata fileref="figures/invest2Lots0RegB4Scrub.png"		<imagedata fileref="figures/invest2Lots0RegB4Scrub.png"
srccredit="Chris Good" width="510px"/>		srccredit="Chris Good" width="&img-w;"/>
</imageobject>		</imageobject>
<imageobject role="fo">		<imageobject role="fo">
<imagedata fileref="figures/invest2Lots0RegB4Scrub.png"		<imagedata fileref="figures/invest2Lots0RegB4Scrub.png"
srccredit="Chris Good"/>		srccredit="Chris Good"/>
</imageobject>		</imageobject>
<textobject>
<phrase>Example of security register before Scrub Account is u
sed. </phrase>
</textobject>
<caption>		<caption>
<simpara>An image of the Security Account register in transact ion journal view, before Scrub Account is used.</simpara>		<simpara>An image of the Security Account register in transact ion journal view, before Scrub Account is used.</simpara>
</caption>		</caption>
</mediaobject>		</mediaobject>
</screenshot>		</screenshot>
</figure>		</figure>
</para>		</para>
<procedure>		<procedure>
<step><simpara>Select		<step><simpara>Select
<menuchoice>		<menuchoice>
<guimenu>Actions</guimenu> <guimenuitem>View Lots</guimenuitem>		<guimenu>Actions</guimenu><guimenuitem>View Lots</guimenuitem>
</menuchoice>		</menuchoice>
to open the <guilabel>Lots in Account SSSS</guilabel> window where SSSS is the		to open the <guilabel>Lots in Account SSSS</guilabel> window where SSSS is the
security account.</simpara>		security account.</simpara>
<figure pgwide="1">		<figure pgwide="1">
<title>Selling Shares - Capital Gains - Lots before Scrub Account< /title>		<title>Selling Shares - Capital Gains - Lots before Scrub Account< /title>
<screenshot id="invest2-lots1B4ScrubAcct">		<screenshot id="invest2-lots1B4ScrubAcct">
<mediaobject>		<mediaobject>
<imageobject role="html">		<imageobject role="html">
<imagedata fileref="figures/invest2Lots1B4Scrub.png"		<imagedata fileref="figures/invest2Lots1B4Scrub.png"
srccredit="Chris Good" width="510px"/>		srccredit="Chris Good" width="&img-w;"/>
</imageobject>		</imageobject>
<imageobject role="fo">		<imageobject role="fo">
<imagedata fileref="figures/invest2Lots1B4Scrub.png"		<imagedata fileref="figures/invest2Lots1B4Scrub.png"
srccredit="Chris Good"/>		srccredit="Chris Good"/>
</imageobject>		</imageobject>
<textobject>
<phrase>Example of Lots in Account window before Scrub Accou
nt is used.
</phrase>
</textobject>
<caption>		<caption>
<simpara>An image of the <emphasis>Lots in Account</emphasis > window before Scrub Account is used.</simpara>		<simpara>An image of the <emphasis>Lots in Account</emphasis > window before Scrub Account is used.</simpara>
</caption>		</caption>
</mediaobject>		</mediaobject>
</screenshot>		</screenshot>
</figure>		</figure>
</step>		</step>
<step>		<step>
<simpara>Click the <guilabel>Scrub Account</guilabel> button.</simpa ra>		<simpara>Click the <guilabel>Scrub Account</guilabel> button.</simpa ra>
<figure pgwide="1">		<figure pgwide="1">
<title>Selling Shares - Capital Gains - Lots after Scrub Account</ title>		<title>Selling Shares - Capital Gains - Lots after Scrub Account</ title>
<screenshot id="invest2-lots2AftScrubAcct">		<screenshot id="invest2-lots2AftScrubAcct">
<mediaobject>		<mediaobject>
<imageobject role="html">		<imageobject role="html">
<imagedata fileref="figures/invest2Lots2LotsAftScrubAcct.png "		<imagedata fileref="figures/invest2Lots2LotsAftScrubAcct.png "
srccredit="Chris Good" width="510px"/>		srccredit="Chris Good" width="&img-w;"/>
</imageobject>		</imageobject>
<imageobject role="fo">		<imageobject role="fo">
<imagedata fileref="figures/invest2Lots2LotsAftScrubAcct.png "		<imagedata fileref="figures/invest2Lots2LotsAftScrubAcct.png "
srccredit="Chris Good"/>		srccredit="Chris Good"/>
</imageobject>		</imageobject>
<textobject>
<phrase>Example of Lots in Account window after using Scrub
Account</phrase>
</textobject>
<caption>		<caption>
<para>An image of the <emphasis>Lots in Account </emphasis> window after using Scrub Account.		<para>An image of the <emphasis>Lots in Account </emphasis> window after using Scrub Account.
</para>		</para>
</caption>		</caption>
</mediaobject>		</mediaobject>
</screenshot>		</screenshot>
</figure>		</figure>
<note>		<note>
<para>After using the <guilabel>Scrub Account</guilabel> button on ly the last lot is shown, so the above		<para>After using the <guilabel>Scrub Account</guilabel> button on ly the last lot is shown, so the above
skipping to change at line 3964		skipping to change at line 3610
</step>		</step>
<step>		<step>
<simpara>Close the <guilabel>Lots in Account SSSS</guilabel> window and return to the security account register.</simpara>		<simpara>Close the <guilabel>Lots in Account SSSS</guilabel> window and return to the security account register.</simpara>
<figure pgwide="1">		<figure pgwide="1">
<title>Selling Shares - Capital Gains - Register after Scrub Accou nt</title>		<title>Selling Shares - Capital Gains - Register after Scrub Accou nt</title>
<screenshot id="invest2-lots3AftScrubAcct">		<screenshot id="invest2-lots3AftScrubAcct">
<mediaobject>		<mediaobject>
<imageobject role="html">		<imageobject role="html">
<imagedata fileref="figures/invest2Lots3RegAftScrubAcct.png"		<imagedata fileref="figures/invest2Lots3RegAftScrubAcct.png"
srccredit="Chris Good" width="510px"/>		srccredit="Chris Good" width="&img-w;"/>
</imageobject>		</imageobject>
<imageobject role="fo">		<imageobject role="fo">
<imagedata fileref="figures/invest2Lots3RegAftScrubAcct.png"		<imagedata fileref="figures/invest2Lots3RegAftScrubAcct.png"
srccredit="Chris Good"/>		srccredit="Chris Good"/>
</imageobject>		</imageobject>
<textobject>
<phrase>Example of security register after using Scrub Accou
nt</phrase>
</textobject>
<caption>		<caption>
<para>An image of the <emphasis>security register</emphasis> after using Scrub Account.		<para>An image of the <emphasis>security register</emphasis> after using Scrub Account.
</para>		</para>
</caption>		</caption>
</mediaobject>		</mediaobject>
</screenshot>		</screenshot>
</figure>		</figure>
<note>		<note>
<para>The security splits in the sell transactions have been split into subsplits, one subsplit per lot,		<para>The security splits in the sell transactions have been split into subsplits, one subsplit per lot,
skipping to change at line 4013		skipping to change at line 3653
XYZ were bought for $10.00 each, there was a simple 2 for 1 stock spli t for zero cost (so		XYZ were bought for $10.00 each, there was a simple 2 for 1 stock spli t for zero cost (so
the holding was then 200 shares @ $5.00 each), then all 200 shares wer e sold for $6.00		the holding was then 200 shares @ $5.00 each), then all 200 shares wer e sold for $6.00
each.		each.
</para>		</para>
<para>		<para>
<figure pgwide="1">		<figure pgwide="1">
<title>Selling Shares - Capital Gains - Register after Scrub Account</ title><screenshot id="investLotsSplitReg">		<title>Selling Shares - Capital Gains - Register after Scrub Account</ title><screenshot id="investLotsSplitReg">
<mediaobject>		<mediaobject>
<imageobject role="html">		<imageobject role="html">
<imagedata fileref="figures/investLotsSplitReg.png"		<imagedata fileref="figures/investLotsSplitReg.png"
srccredit="Chris Good" width="510px"/>		srccredit="Chris Good" width="&img-w;"/>
</imageobject>		</imageobject>
<imageobject role="fo">		<imageobject role="fo">
<imagedata fileref="figures/investLotsSplitReg.png"		<imagedata fileref="figures/investLotsSplitReg.png"
srccredit="Chris Good"/>		srccredit="Chris Good"/>
</imageobject>		</imageobject>
<textobject>
<phrase>Example of security register after Scrub Account is used
. </phrase>
</textobject>
<caption>		<caption>
<para>An image of the Security Account register in transaction j ournal view, after Scrub Account is used.		<para>An image of the Security Account register in transaction j ournal view, after Scrub Account is used.
</para>		</para>
</caption>		</caption>
</mediaobject>		</mediaobject>
</screenshot>		</screenshot>
</figure>		</figure>
<figure pgwide="1">		<figure pgwide="1">
<title>Selling Shares - Capital Gains - Lot 0 after Scrub Account</tit le><screenshot id="investLotsSplitLot0">		<title>Selling Shares - Capital Gains - Lot 0 after Scrub Account</tit le><screenshot id="investLotsSplitLot0">
<mediaobject>		<mediaobject>
<imageobject role="html">		<imageobject role="html">
<imagedata fileref="figures/investLotsSplitLot0.png"		<imagedata fileref="figures/investLotsSplitLot0.png"
srccredit="Chris Good" width="510px"/>		srccredit="Chris Good" width="&img-w;"/>
</imageobject>		</imageobject>
<imageobject role="fo">		<imageobject role="fo">
<imagedata fileref="figures/investLotsSplitLot0.png"		<imagedata fileref="figures/investLotsSplitLot0.png"
srccredit="Chris Good"/>		srccredit="Chris Good"/>
</imageobject>		</imageobject>
<textobject>
<phrase>Example of security register after Scrub Account is used
. </phrase>
</textobject>
<caption>		<caption>
<para>An image of the Security Account register in transaction j ournal view, after Scrub Account is used.		<para>An image of the Security Account register in transaction j ournal view, after Scrub Account is used.
</para>		</para>
</caption>		</caption>
</mediaobject>		</mediaobject>
</screenshot>		</screenshot>
</figure>		</figure>
<figure pgwide="1">		<figure pgwide="1">
<title>Selling Shares - Capital Gains - Lot 1 after Scrub Account</tit le><screenshot id="investLotsSplitLot1">		<title>Selling Shares - Capital Gains - Lot 1 after Scrub Account</tit le><screenshot id="investLotsSplitLot1">
<mediaobject>		<mediaobject>
<imageobject role="html">		<imageobject role="html">
<imagedata fileref="figures/investLotsSplitLot1.png"		<imagedata fileref="figures/investLotsSplitLot1.png"
srccredit="Chris Good" width="510px"/>		srccredit="Chris Good" width="&img-w;"/>
</imageobject>		</imageobject>
<imageobject role="fo">		<imageobject role="fo">
<imagedata fileref="figures/investLotsSplitLot1.png"		<imagedata fileref="figures/investLotsSplitLot1.png"
srccredit="Chris Good"/>		srccredit="Chris Good"/>
</imageobject>		</imageobject>
<textobject>
<phrase>Example of security register after Scrub Account is used
. </phrase>
</textobject>
<caption>		<caption>
<para>An image of the Security Account register in transaction j ournal view, after Scrub Account is used.		<para>An image of the Security Account register in transaction j ournal view, after Scrub Account is used.
</para>		</para>
</caption>		</caption>
</mediaobject>		</mediaobject>
</screenshot>		</screenshot>
</figure>		</figure>
</para>		</para>
<para>The above screenshots show that scrubbing created:		<para>The above screenshots show that scrubbing created:
<itemizedlist>		<itemizedlist>
skipping to change at line 4121		skipping to change at line 3743
<title>Changing the Orphaned Gains-CCC to Gain/Loss Account</title>		<title>Changing the Orphaned Gains-CCC to Gain/Loss Account</title>
<procedure>		<procedure>
<step>		<step>
<simpara>Close the <guilabel>Lots in Account SSSS</guilabel> window if open and return to the security		<simpara>Close the <guilabel>Lots in Account SSSS</guilabel> window if open and return to the security
account register.</simpara>		account register.</simpara>
<figure pgwide="1">		<figure pgwide="1">
<title>Selling Shares - Capital Gains - Register after scrubbing a single lot</title><screenshot id="invest-lots4AftScrub1LotReg">		<title>Selling Shares - Capital Gains - Register after scrubbing a single lot</title><screenshot id="invest-lots4AftScrub1LotReg">
<mediaobject>		<mediaobject>
<imageobject role="html">		<imageobject role="html">
<imagedata fileref="figures/investLots2_RegAfterScrub1Lot.pn g"		<imagedata fileref="figures/investLots2_RegAfterScrub1Lot.pn g"
srccredit="Chris Good" width="510px"/>		srccredit="Chris Good" width="&img-w;"/>
</imageobject>		</imageobject>
<imageobject role="fo">		<imageobject role="fo">
<imagedata fileref="figures/investLots2_RegAfterScrub1Lot.pn g"		<imagedata fileref="figures/investLots2_RegAfterScrub1Lot.pn g"
srccredit="Chris Good"/>		srccredit="Chris Good"/>
</imageobject>		</imageobject>
<textobject>
<phrase>Example of security register after scrubbing a singl
e lot </phrase>
</textobject>
<caption>		<caption>
<para>An image of the <emphasis>security register</emphasis> after scrubbing a single lot.		<para>An image of the <emphasis>security register</emphasis> after scrubbing a single lot.
</para>		</para>
</caption>		</caption>
</mediaobject>		</mediaobject>
</screenshot>		</screenshot>
</figure>		</figure>
</step>		</step>
<step>		<step>
<simpara>Find each new <emphasis>Realized Gain/Loss</emphasis> trans action in the security account register		<simpara>Find each new <emphasis>Realized Gain/Loss</emphasis> trans action in the security account register
(they will have the same date as the sell transactions).		(they will have the same date as the sell transactions).
</simpara>		</simpara>
</step>		</step>
<step>		<step>
<simpara>Edit the <emphasis>Orphaned Gains-CCC</emphasis> transactio n split to re-assign the income account to a more		<simpara>Edit the <emphasis>Orphaned Gains-CCC</emphasis> transactio n split to re-assign the income account to a more
meaningful income (or expense) gain or loss account (for example, <emphasis>Income:Capital Gain (Long Term):IBM</emphasis>).</simpara>		meaningful income (or expense) gain or loss account (for example, <emphasis>Income:Capital Gain (Long Term):IBM</emphasis>).</simpara>
<tip>		<tip>
<simpara>You may like to split the capital gain/loss into taxable and non taxable parts if that is in accord		<simpara>You may like to split the capital gain/loss into taxable and non taxable parts if that is in accord
with your tax laws.		with your tax laws.
</simpara>		</simpara>
</tip>		</tip>
</step>		</step>
</procedure>		</procedure>
</example>		</example>
</sect3>		</sect3>
</sect2>		</sect2>
</sect1>		</sect1>
<sect1 id="invest-dividends1">		<sect1 id="invest-dividends1">
<title>Dividends</title>		<title>Dividends</title>
<para>Some companies or mutual funds pay periodic dividends to shareholders. Dividends are typically given		<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 comm odity or they are		in one of two ways, either they are automatically reinvested into the comm odity or they are
skipping to change at line 4186		skipping to change at line 3801
<para>If the dividend is presented as cash, you should record the transact ion in the asset account that		<para>If the dividend is presented as cash, you should record the transact ion in the asset account that
received the money, as income from <emphasis>Income:Dividends</emphasis> . Additionally if		received the money, as income from <emphasis>Income:Dividends</emphasis> . Additionally if
you want to tie the cash dividend to a particular stock holding then add a dummy transaction		you want to tie the cash dividend to a particular stock holding then add a dummy transaction
split to the stock account with quantity 0 price 1 value 0.		split to the stock account with quantity 0 price 1 value 0.
</para>		</para>
<para>As an example consider the following; the dividends deposited as cas h into the		<para>As an example consider the following; the dividends deposited as cas h into the
<emphasis>Broker</emphasis> Account with a tie to the stock account.		<emphasis>Broker</emphasis> Account with a tie to the stock account.
</para>		</para>
<screenshot id="invest-dividendcash1">		<!-- ToDo: unshrink -->
		<figure>
		<title>Example Of Cash Dividend Transactions</title>
		<screenshot id="invest-dividendcash1">
<mediaobject>		<mediaobject>
<imageobject role="html">		<imageobject>
<imagedata fileref="figures/invest_dividendcash.png"
srccredit="Daniel Dodson" width="510px"/>
</imageobject>
<imageobject role="fo">
<imagedata fileref="figures/invest_dividendcash.png"		<imagedata fileref="figures/invest_dividendcash.png"
srccredit="Daniel Dodson"/>		srccredit="Daniel Dodson"/>
</imageobject>		</imageobject>
<textobject>
<phrase>Example of cash dividend transactions</phrase>
</textobject>
<caption>		<caption>
<para>An image of the <emphasis>Brokerage</emphasis> Account registe r after a series of cash dividends.		<para>An image of the <emphasis>Brokerage</emphasis> Account registe r after a series of cash dividends.
</para>		</para>
</caption>		</caption>
</mediaobject>		</mediaobject>
</screenshot>		</screenshot>
		</figure>
<note>		<note>
<para>If you want to track dividends on a per-stock basis, you would nee d to create an		<para>If you want to track dividends on a per-stock basis, you would nee d to create an
<emphasis>Income:Dividends:STOCKSYMBOL</emphasis> account for each sto ck you own that pays		<emphasis>Income:Dividends:STOCKSYMBOL</emphasis> account for each sto ck you own that pays
dividends.		dividends.
</para>		</para>
</note>		</note>
</sect2>		</sect2>
<sect2 id="invest-dividendreinvest">		<sect2 id="invest-dividendreinvest">
skipping to change at line 4238		skipping to change at line 3847
</para>		</para>
<para>Starting with the purchase of 100 shares on Jan. 3, 2005, all divide nds will be reinvested and an		<para>Starting with the purchase of 100 shares on Jan. 3, 2005, all divide nds will be reinvested and an
account is created to track the dividend to the specific stock. &app; si mplifies the entry		account is created to track the dividend to the specific stock. &app; si mplifies the entry
by allowing calculations within the cells of the transaction. If the fir st dividend is		by allowing calculations within the cells of the transaction. If the fir st dividend is
$0.29/share, enter <userinput>53.28</userinput> (purchase price + divide nd) in the share <guilabel>Price</guilabel>		$0.29/share, enter <userinput>53.28</userinput> (purchase price + divide nd) in the share <guilabel>Price</guilabel>
cell and <userinput>100*0.29</userinput> in the <guilabel>Buy</guilabel> cell. &app; will calculate for you the		cell and <userinput>100*0.29</userinput> in the <guilabel>Buy</guilabel> cell. &app; will calculate for you the
corresponding number of <guilabel>Shares</guilabel>.		corresponding number of <guilabel>Shares</guilabel>.
</para>		</para>
<screenshot id="invest-dividendreinvest1">		<figure>
<mediaobject>		<title>Example Of Dividend Reinvestment Transactions</title>
<imageobject role="html">		<screenshot id="invest-dividendreinvest1">
<imagedata fileref="figures/invest_dividendreinvest1.png"		<mediaobject>
srccredit="Cristian Marchi" width="510px"/>		<imageobject role="html">
</imageobject>		<imagedata fileref="figures/invest_dividendreinvest1.png"
		srccredit="Cristian Marchi" width="&img-w;"/>
<imageobject role="fo">		</imageobject>
<imagedata fileref="figures/invest_dividendreinvest1.png"		<imageobject role="fo">
srccredit="Cristian Marchi"/>		<imagedata fileref="figures/invest_dividendreinvest1.png"
</imageobject>		srccredit="Cristian Marchi"/>
		</imageobject>
<textobject>		<caption>
<phrase>Example of dividend reinvestment transactions</phrase>		<para>An image of the NST Stock Account register after a dividend
</textobject>		reinvestment.
		</para>
<caption>		</caption>
<para>An image of the NST Stock Account register after a dividend re		</mediaobject>
investment.		</screenshot>
</para>		</figure>
</caption>
</mediaobject>
</screenshot>
</sect2>		</sect2>
</sect1>		</sect1>
<sect1 id="invest-retofcap">		<sect1 id="invest-retofcap">
<title>Return of Capital</title>		<title>Return of Capital</title>
<para>This refers to a transaction where an investment returns capital to th e investor and doesn't have		<para>This refers to a transaction where an investment returns capital to th e investor and doesn't have
any accounting implications other than reducing the cost basis. The number of shares held is		any accounting implications other than reducing the cost basis. The number of shares held is
not changed.		not changed.
</para>		</para>
skipping to change at line 4314		skipping to change at line 3920
Return of Capital value		Return of Capital value
</entry>		</entry>
</row>		</row>
</tbody>		</tbody>
</tgroup>		</tgroup>
</informaltable>		</informaltable>
<para>The other side of the double entry would usually be a debit to the bro kerage bank account.		<para>The other side of the double entry would usually be a debit to the bro kerage bank account.
</para>		</para>
<screenshot id="invest-ret-of-cap">		<figure>
<mediaobject>		<title>Example Of Return Of Capital Transactions</title>
<imageobject role="html">		<screenshot id="invest-ret-of-cap">
<imagedata fileref="figures/invest_ret_of_cap.png"		<mediaobject>
srccredit="Chris Good" width="510px"/>		<imageobject role="html">
</imageobject>		<imagedata fileref="figures/invest_ret_of_cap.png"
		srccredit="Chris Good" width="&img-w;"/>
<imageobject role="fo">		</imageobject>
<imagedata fileref="figures/invest_ret_of_cap.png"		<imageobject role="fo">
srccredit="Chris Good"/>		<imagedata fileref="figures/invest_ret_of_cap.png"
</imageobject>		srccredit="Chris Good"/>
		</imageobject>
<textobject>		<caption>
<phrase>Example of return of capital transactions</phrase>		<para>An image of the Stock Account register after a return of capit
</textobject>		al.
		</para>
<caption>		</caption>
<para>An image of the Stock Account register after a return of capital		</mediaobject>
.		</screenshot>
</para>		</figure>
</caption>
</mediaobject>
</screenshot>
<note>		<note>
<para>It is not possible to use the Stock Split Assistant to do this type of transaction.		<para>It is not possible to use the Stock Split Assistant to do this type of transaction.
</para>		</para>
</note>		</note>
<tip>		<tip>
<para>If you accidentally entered a non-zero price in the stock split, &ap p; may have created an unwanted		<para>If you accidentally entered a non-zero price in the stock split, &ap p; may have created an unwanted
price database entry which could cause reports to be wrong. Check for an d remove such an		price database entry which could cause reports to be wrong. Check for an d remove such an
unwanted entry from the price database using		unwanted entry from the price database using
<menuchoice>		<menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Price Database</guimenuitem>		<guimenu>Tools</guimenu><guimenuitem>Price Database</guimenuitem>
</menuchoice>.		</menuchoice>.
</para>		</para>
</tip>		</tip>
</sect1>		</sect1>
<!-- Stock Splits - Simple
<sect1 id="invest-splitsnmergers1">		<sect1 id="invest-splitsnmergers1">
<title>Splits and Mergers</title>		<title>Splits and Mergers</title>
<para>Companies may split their stock for many reasons but the most common i s that the price has risen		<para>Companies may split their stock for many reasons but the most common i s that the price has risen
higher than management thinks is a reasonable price for many investors. So me of these splits		higher than management thinks is a reasonable price for many investors. So me of these splits
are simple exchanges (for example, 2 for 1 or 3 for 2) and some are comple x exchanges with cash		are simple exchanges (for example, 2 for 1 or 3 for 2) and some are comple x exchanges with cash
distributions. Splits may also result in fewer shares if the exchange rate is a reverse split		distributions. Splits may also result in fewer shares if the exchange rate is a reverse split
(1 for 3 or 0.75 for 1).		(1 for 3 or 0.75 for 1).
</para>		</para>
skipping to change at line 4376		skipping to change at line 3977
<title>Simple Stock Split</title>		<title>Simple Stock Split</title>
<para>As an example, our holding of NST stock declared a 2 for 1 stock spl it effective June 6, 2005. The		<para>As an example, our holding of NST stock declared a 2 for 1 stock spl it effective June 6, 2005. The
process for entering this transaction is; select		process for entering this transaction is; select
<menuchoice>		<menuchoice>
<guimenu>Actions</guimenu><guimenuitem>Stock Split</guimenuitem>		<guimenu>Actions</guimenu><guimenuitem>Stock Split</guimenuitem>
</menuchoice>		</menuchoice>
to start the assistant.		to start the assistant.
</para>		</para>
<screenshot id="invest-split1">		<!-- ToDo: unshrink -->
<mediaobject>		<figure>
<imageobject>		<title>Activation Of The <quote>Stock Split</quote> Assistant</title>
<imagedata fileref="figures/invest_split1.png"		<screenshot id="invest-split1">
srccredit="Dave Herman"/>		<mediaobject>
</imageobject>		<imageobject>
		<imagedata fileref="figures/invest_split1.png"
<textobject>		srccredit="Dave Herman"/>
<phrase>An image of the stock split assistant at step 1. </phrase>		</imageobject>
</textobject>		<caption>
		<para>An image of the selection of the stock split assistant.
<caption>		</para>
<para>An image of the selection of the stock split assistant.		</caption>
</para>		</mediaobject>
</caption>		</screenshot>
</mediaobject>		</figure>
</screenshot>
<para>The first screen is an Introduction, select <guibutton>Forward</guib utton> to display the selection		<para>The first screen is an Introduction, select <guibutton>Forward</guib utton> to display the selection
of the account and stock for the split. You will need to create an entry for each		of the account and stock for the split. You will need to create an entry for each
<emphasis>Account:Stock</emphasis> combination you hold.		<emphasis>Account:Stock</emphasis> combination you hold.
</para>		</para>
<screenshot id="invest-split2">		<figure>
<mediaobject>		<title>Selection Of A Stock Account In The <quote>Stock Split</quote> As
<imageobject>		sistant</title>
<imagedata fileref="figures/invest_split2.png"		<screenshot id="invest-split2">
srccredit="Dave Herman"/>		<mediaobject>
</imageobject>		<imageobject>
		<imagedata fileref="figures/invest_split2.png"
<textobject>		srccredit="Dave Herman"/>
<phrase>An image of the stock split assistant at step 2 - Selection		</imageobject>
of Account/Stock.		<caption>
</phrase>		<para>An image of the stock split assistant at step 2 - Selection
</textobject>		of Account/Stock.
		</para>
<caption>		</caption>
<para>An image of the stock split assistant at step 2 - Selection of		</mediaobject>
Account/Stock.		</screenshot>
</para>		</figure>
</caption>
</mediaobject>
</screenshot>
<para>Select the <emphasis>Assets:Investments:DRIPs:NST</emphasis> and cli ck on		<para>Select the <emphasis>Assets:Investments:DRIPs:NST</emphasis> and cli ck on
<guibutton>Forward</guibutton>.		<guibutton>Forward</guibutton>.
</para>		</para>
<para>The next screen presents 5 fields in the Stock Splits Details window :		<para>The next screen presents 5 fields in the Stock Splits Details window :
</para>		</para>
<variablelist>		<variablelist>
<varlistentry>		<varlistentry>
skipping to change at line 4459		skipping to change at line 4056
<varlistentry>		<varlistentry>
<term>Currency</term>		<term>Currency</term>
<listitem><simpara>The currency of the transaction is required. This sho uld be the same as the stock purchase currency.</simpara></listitem>		<listitem><simpara>The currency of the transaction is required. This sho uld be the same as the stock purchase currency.</simpara></listitem>
</varlistentry>		</varlistentry>
</variablelist>		</variablelist>
<para>Click on the <guibutton>Forward</guibutton> button.		<para>Click on the <guibutton>Forward</guibutton> button.
</para>		</para>
<screenshot id="invest-split3">		<figure>
<mediaobject>		<title>Split Details In The <quote>Stock Split</quote> Assistant</title>
<imageobject>		<screenshot id="invest-split3">
<imagedata fileref="figures/invest_split3.png"		<mediaobject>
srccredit="Dave Herman"/>		<imageobject>
</imageobject>		<imagedata fileref="figures/invest_split3.png"
		srccredit="Dave Herman"/>
<textobject>		</imageobject>
<phrase>An image of the stock split assistant at step 3 - Split Deta		<caption>
ils. </phrase>		<para>An image of the stock split assistant at step 3 - Split Deta
</textobject>		ils.
		</para>
<caption>		</caption>
<para>An image of the stock split assistant at step 3 - Split Detail		</mediaobject>
s.		</screenshot>
</para>		</figure>
</caption>
</mediaobject>
</screenshot>
<para>The next screen will be skipped in this example as there was no <quo te>Cash in Lieu</quote>.		<para>The next screen will be skipped in this example as there was no <quo te>Cash in Lieu</quote>.
</para>		</para>
<screenshot id="invest-split4">		<figure>
<mediaobject>		<title><quote>Cash In Lieu</quote> In The <quote>Stock Split</quote> Ass
<imageobject>		istant</title>
<imagedata fileref="figures/invest_split4.png"		<screenshot id="invest-split4">
srccredit="Dave Herman"/>		<mediaobject>
</imageobject>		<imageobject>
		<imagedata fileref="figures/invest_split4.png"
<textobject>		srccredit="Dave Herman"/>
<phrase>An image of the stock split assistant at step 4 - Cash in Li		</imageobject>
eu. </phrase>		<caption>
</textobject>		<para>An image of the stock split assistant at step 4 - Cash in Li
		eu.
<caption>		</para>
<para>An image of the stock split assistant at step 4 - Cash in Lieu		</caption>
.		</mediaobject>
</para>		</screenshot>
</caption>		</figure>
</mediaobject>
</screenshot>
<para>A final <guilabel>Finish</guilabel> screen will give a last option t o;		<para>A final <guilabel>Finish</guilabel> screen will give a last option t o;
<guibutton>Cancel</guibutton>, <guibutton>Back</guibutton> to modify any data entered or		<guibutton>Cancel</guibutton>, <guibutton>Back</guibutton> to modify any data entered or
<guibutton>Apply</guibutton> to complete the stock split with the data e ntered.		<guibutton>Apply</guibutton> to complete the stock split with the data e ntered.
</para>		</para>
<screenshot id="invest-simplesplit1">		<!-- ToDo: unshrink -->
<mediaobject>		<figure>
<imageobject>		<title>The NST Account After A Simple Stock Split</title>
<imagedata fileref="figures/invest_simplesplit1.png"		<screenshot id="invest-simplesplit1">
srccredit="Dave Herman"/>		<mediaobject>
</imageobject>		<imageobject>
		<imagedata fileref="figures/invest_simplesplit1.png"
<textobject>		srccredit="Dave Herman"/>
<phrase>Example of simple stock split transaction in the stock&rsquo		</imageobject>
;s register</phrase>		<caption>
</textobject>		<para>An image of the <emphasis>Assets:Investments:DRIPs:NST</emph
		asis> register after a simple stock
<caption>		split transaction.
<para>An image of the <emphasis>Assets:Investments:DRIPs:NST</emphas		</para>
is> register after a simple stock		</caption>
split transaction.		</mediaobject>
</para>		</screenshot>
</caption>		</figure>
</mediaobject>
</screenshot>
</sect2>		</sect2>
<!-- Moderately Complex Stock Merger
<sect2 id="invest-merger1">		<sect2 id="invest-merger1">
<title>Moderately Complex Stock Merger</title>		<title>Moderately Complex Stock Merger</title>
<para>As an example, assume you held AT&amp;T stock during the Nov. 18, 20 05 merger of SBC with AT&amp;T.		<para>As an example, assume you held AT&amp;T stock during the Nov. 18, 20 05 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		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 registe r.		been paid in cash, therefore not entered into the AT&amp;T stock registe r.
</para>		</para>
<para>The conditions of the merger were 0.77942 share of SBC stock were ex changed for each share of		<para>The conditions of the merger were 0.77942 share of SBC stock were ex changed for each share of
AT&amp;T stock. The merged company continued to use the symbol <quote>T< /quote> from		AT&amp;T stock. The merged company continued to use the symbol <quote>T< /quote> from
skipping to change at line 4547		skipping to change at line 4137
<para>AT&amp;T paid a <quote>dividend</quote> of $1.20/share on the transa ction date, however this will		<para>AT&amp;T paid a <quote>dividend</quote> of $1.20/share on the transa ction date, however this will
not appear in the stock account as it was a cash distribution.		not appear in the stock account as it was a cash distribution.
</para>		</para>
<para>The process for entering this transaction is identical to the simple split until the		<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		<quote>Details</quote> screen. You will need to create an split entry in each
<emphasis>Investment Account:Stock</emphasis> account combination that h as shares splitting.		<emphasis>Investment Account:Stock</emphasis> account combination that h as shares splitting.
</para>		</para>
<screenshot id="invest-merge2">		<figure>
<mediaobject>		<title>Selection Of A Stock Account In The <quote>Stock Split</quote> As
<imageobject>		sistant—Moderate</title>
<imagedata fileref="figures/invest_merge2.png"		<screenshot id="invest-merge2">
srccredit="Dave Herman"/>		<mediaobject>
</imageobject>		<imageobject>
		<imagedata fileref="figures/invest_merge2.png"
<textobject>		srccredit="Dave Herman"/>
<phrase>An image of the stock split assistant at step 2. </phrase>		</imageobject>
</textobject>		<caption>
		<para>An image of the stock split assistant at step 2 - Selection
<caption>		of Account/Stock (<emphasis>Investment
<para>An image of the stock split assistant at step 2 - Selection of		Account:T</emphasis>).
Account/Stock (<emphasis>Investment		</para>
Account:T</emphasis>).		</caption>
</para>		</mediaobject>
</caption>		</screenshot>
</mediaobject>		</figure>
</screenshot>
<para>Select the <emphasis>Assets:Investments:Brokerage Account:Stock:T</e mphasis> and click on		<para>Select the <emphasis>Assets:Investments:Brokerage Account:Stock:T</e mphasis> and click on
<guibutton>Forward</guibutton>.		<guibutton>Forward</guibutton>.
</para>		</para>
<para>The next screen presents 5 fields in the Stock Splits Details window :		<para>The next screen presents 5 fields in the Stock Splits Details window :
</para>		</para>
<variablelist>		<variablelist>
<varlistentry>		<varlistentry>
skipping to change at line 4609		skipping to change at line 4197
<varlistentry>		<varlistentry>
<term>Currency</term>		<term>Currency</term>
<listitem><simpara>The currency of the transaction is required. This sho uld be the same as the stock purchase currency.</simpara></listitem>		<listitem><simpara>The currency of the transaction is required. This sho uld be the same as the stock purchase currency.</simpara></listitem>
</varlistentry>		</varlistentry>
</variablelist>		</variablelist>
<para>Click on the <guibutton>Forward</guibutton> button.		<para>Click on the <guibutton>Forward</guibutton> button.
</para>		</para>
<screenshot id="invest-merge3">		<figure>
<mediaobject>		<title>Split Details In The <quote>Stock Split</quote> Assistant—Moderat
<imageobject>		e</title>
<imagedata fileref="figures/invest_merge3.png"		<screenshot id="invest-merge3">
srccredit="Dave Herman"/>		<mediaobject>
</imageobject>		<imageobject>
		<imagedata fileref="figures/invest_merge3.png"
<textobject>		srccredit="Dave Herman"/>
<phrase>An image of the stock split assistant at step 3. </phrase>		</imageobject>
</textobject>		<caption>
		<para>An image of the stock split assistant at step 3 - Split Deta
<caption>		ils.
<para>An image of the stock split assistant at step 3 - Split Detail		</para>
s.		</caption>
</para>		</mediaobject>
</caption>		</screenshot>
</mediaobject>		</figure>
</screenshot>
<para>The next screen will be skipped in this example as there was no <quo te>Cash in Lieu</quote>.		<para>The next screen will be skipped in this example as there was no <quo te>Cash in Lieu</quote>.
</para>		</para>
<para>A final <quote>Finish</quote> screen will give a last option to <gui		<para>A final <quote>Finish</quote> screen will give a last option to <gui
menu>Back</guimenu> to modify		button>Back</guibutton> to modify
any data entered or <guimenu>Apply</guimenu> to complete the stock split		any data entered or <guibutton>Apply</guibutton> to complete the stock s
with the data		plit with the data
entered.		entered.
</para>		</para>
<screenshot id="invest-stockmerge1">		<!-- ToDo: unshrink -->
<mediaobject>		<figure>
<imageobject>		<title>The T Account After A Moderate Stock Split</title>
<imagedata fileref="figures/invest_stockmerge1.png"		<screenshot id="invest-stockmerge1">
srccredit="Dave Herman"/>		<mediaobject>
</imageobject>		<imageobject>
		<imagedata fileref="figures/invest_stockmerge1.png"
<textobject>		srccredit="Dave Herman"/>
<phrase>Example of moderate stock split transaction in the stock&rsq		</imageobject>
uo;s		<caption>
register</phrase>		<para>An image of the <emphasis>Investment Account:T</emphasis> re
</textobject>		gister after a stock split transaction
		that decreases the shares.
<caption>		</para>
<para>An image of the <emphasis>Investment Account:T</emphasis> regi		</caption>
ster after a stock split transaction		</mediaobject>
that decreases the shares.		</screenshot>
</para>		</figure>
</caption>
</mediaobject>
</screenshot>
</sect2>		</sect2>
</sect1>		</sect1>
<!-- Working Location !!!!!!!!!!!!		<!-- Working Location !!!!!!!!!!!!
<sect1 id="invest-todo1">		<sect1 id="invest-todo1">
<title>To-do</title>		<title>To-do</title>
<para>These are the remaining documentation sections that originally		<para>These are the remaining documentation sections that originally
appeared in the 1.8.4 documentation which require being written up.</para>		appeared in the 1.8.4 documentation which require being written up.</para>
<itemizedlist>		<itemizedlist>
End of changes. 150 change blocks.
1570 lines changed or deleted		1108 lines changed or added

---