gnucash-docs maint: Multiple changes pushed
John Ralls
jralls at code.gnucash.org
Sat Mar 25 14:34:03 EDT 2017
Updated via https://github.com/Gnucash/gnucash-docs/commit/51af85d6 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/5bc7a452 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/fecf28a2 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/6e32b58d (commit)
via https://github.com/Gnucash/gnucash-docs/commit/54666fb4 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/0477ba9d (commit)
via https://github.com/Gnucash/gnucash-docs/commit/cae6d1b1 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/7a6ae3c7 (commit)
from https://github.com/Gnucash/gnucash-docs/commit/12e0ec41 (commit)
commit 51af85d6d414c07469311c6bd4f311086bd9c9fe
Merge: 6e32b58 5bc7a45
Author: John Ralls <jralls at ceridwen.us>
Date: Sat Mar 25 11:30:07 2017 -0700
Merge branch 'regview' into maint
commit 5bc7a4528740f49afc479bf44d6ed60314900208
Author: goodvibes2 <chris.good at ozemail.com.au>
Date: Thu Mar 23 11:42:47 2017 +1100
Remove section "Changing the Register View" as better handled in Guide section 4.2
diff --git a/help/C/Help_ch_GUIMenus.xml b/help/C/Help_ch_GUIMenus.xml
index 911d19d..d7f7d64 100644
--- a/help/C/Help_ch_GUIMenus.xml
+++ b/help/C/Help_ch_GUIMenus.xml
@@ -2043,7 +2043,11 @@
</figure>
<tip>
- <para>Appearance of the Account Register Display is highly customizable (see <xref linkend="reg-views"/>).</para>
+ <para>Appearance of the Account Register Display is highly customizable
+ (see <ulink
+url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-guide/txns-register-oview.html#txns-regstyle1">
+ Tutorial and Concepts Guide, Choosing a Register Style</ulink>).
+ </para>
</tip>
<note>
@@ -2534,8 +2538,9 @@
<entry><para><guimenuitem>Basic Ledger</guimenuitem></para></entry>
<entry namest="c2" nameend="c3">
- <para>Radio button to select register display mode. See
- <xref linkend="reg-views"></xref>.
+ <para>Radio button to select register display mode. See <ulink
+url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-guide/txns-register-oview.html#txns-regstyle1">
+ Tutorial and Concepts Guide, Choosing a Register Style</ulink>.
</para>
</entry>
</row>
diff --git a/help/C/Help_ch_Transactions.xml b/help/C/Help_ch_Transactions.xml
index 7ffe8ee..47e5f96 100644
--- a/help/C/Help_ch_Transactions.xml
+++ b/help/C/Help_ch_Transactions.xml
@@ -53,256 +53,6 @@ Translators:
<para>Where should the Importing of data from downloaded files" and "On-line" banking be covered?.
</para></note>
-->
- <sect1 id="reg-views">
- <title>Changing the Register View</title>
-
- <para><application>&app;</application> has several options to change the way
- the register looks so transactions can be seen more clearly.
- </para>
-
- <sect2 id="reg-views-view">
- <title>View</title>
- <para>
- The default view is the Basic Ledger. This presents a single line view of transactions to allow
- the most concise view with all the relevant details.</para>
-
- <para>The view of an open register can be changed by options in the
- <guimenu>View</guimenu> menu. A register will always open in the
- <guilabel>Default Style</guilabel> set in the <guilabel>Register
- Defaults</guilabel> tab of the <guilabel>&app; Preferences</guilabel>.
- </para>
-
- <itemizedlist>
- <listitem>
- <para><guimenu>Basic Ledger:</guimenu> The default one line per
- transaction view. Splits are shown as a summary. The <guibutton>Splits
- </guibutton> icon and <menuchoice><guimenu>Actions</guimenu>
- <guimenuitem>Split Transaction</guimenuitem></menuchoice> are enabled.
- </para>
- </listitem>
-
- <listitem>
- <para><guimenu>Auto-Split Ledger:</guimenu> This view will automatically
- expand to show the splits in any transaction selected. Unselected
- transactions are shown unexpanded.
- </para>
- </listitem>
-
- <listitem>
- <para><guimenu>Transaction Journal:</guimenu> This view expands all
- transactions so all the splits in all transactions can be seen.
- </para>
- </listitem>
-
- <listitem>
- <para><guimenu>Double Line:</guimenu> This check-box changes any of the
- above views so that an additional line for notes about the transaction
- is added.</para>
- </listitem>
- </itemizedlist>
-
- <sect3 id="reg-views-examples">
- <title>Examples of Register Views</title>
-
- <para>The following examples of the Clothes expense account are done
- from that account in order to show how multiple splits for the
- register account in one transaction appear in each view. Usually these
- transactions would be entered from the bank account register, not the
- expense account register. Here is the Bank register to initially
- show a more usual view. As there are multiple Clothes account splits
- in 2 of the transactions (those for the 21/1/2008 and 23/1/2008), it
- is shown in <guimenuitem>Transaction Journal </guimenuitem> and
- <guimenuitem>Double Line</guimenuitem> view so all the detail can be
- seen.
- </para>
-
- <figure>
- <title>Example Bank register in <guimenuitem>Transaction
- Journal</guimenuitem>, <guimenuitem>Double Line</guimenuitem> view
- </title>
- <screenshot id="reg-views-BankTxJnlDouble">
- <mediaobject>
- <imageobject role="html">
- <imagedata fileref="figures/Help_Tx_ViewBankTxJnlDouble.png"
- format="PNG" srccredit="Chris Good" width="510px"></imagedata>
- </imageobject>
- <imageobject role="fo">
- <imagedata fileref="figures/Help_Tx_ViewBankTxJnlDouble.png" format="PNG"
- srccredit="Chris Good"></imagedata>
- </imageobject>
-
- <textobject>
- <phrase>The Bank register</phrase>
- </textobject>
- </mediaobject>
- </screenshot>
- </figure>
-
- <figure>
- <title>Example Register in <guimenuitem>Basic Ledger</guimenuitem>,
- <guimenuitem>Single Line</guimenuitem> view
- </title>
- <screenshot id="reg-views-ViewBasic">
- <mediaobject>
- <imageobject role="html">
- <imagedata fileref="figures/Help_Tx_ViewBasic.png"
- format="PNG" srccredit="Chris Good" width="510px"></imagedata>
- </imageobject>
- <imageobject role="fo">
- <imagedata fileref="figures/Help_Tx_ViewBasic.png" format="PNG"
- srccredit="Chris Good"></imagedata>
- </imageobject>
-
- <textobject>
- <phrase>Example Clothes register</phrase>
- </textobject>
- </mediaobject>
- </screenshot>
- </figure>
-
- <figure>
- <title>Example Register in <guimenuitem>Basic Ledger</guimenuitem>,
- <guimenuitem>Double Line</guimenuitem> view
- </title>
- <screenshot id="reg-views-ViewBasicDouble">
- <mediaobject>
- <imageobject role="html">
- <imagedata fileref="figures/Help_Tx_ViewBasicDouble.png"
- format="PNG" srccredit="Chris Good" width="510px"></imagedata>
- </imageobject>
- <imageobject role="fo">
- <imagedata fileref="figures/Help_Tx_ViewBasicDouble.png" format="PNG"
- srccredit="Chris Good"></imagedata>
- </imageobject>
-
- <textobject>
- <phrase>Example Clothes register</phrase>
- </textobject>
- </mediaobject>
- </screenshot>
- </figure>
-
- <figure>
- <title>Example Register in <guimenuitem>Auto-Split Ledger</guimenuitem>,
- <guimenuitem>Single Line</guimenuitem> view
- </title>
- <screenshot id="reg-views-ViewAutoSplit">
- <mediaobject>
- <imageobject role="html">
- <imagedata fileref="figures/Help_Tx_ViewAutoSplit.png"
- format="PNG" srccredit="Chris Good" width="510px"></imagedata>
- </imageobject>
- <imageobject role="fo">
- <imagedata fileref="figures/Help_Tx_ViewAutoSplit.png" format="PNG"
- srccredit="Chris Good"></imagedata>
- </imageobject>
-
- <textobject>
- <phrase>Example Clothes register</phrase>
- </textobject>
- </mediaobject>
- </screenshot>
- </figure>
-
- <figure>
- <title>Example Register in <guimenuitem>Auto-Split Ledger</guimenuitem>,
- <guimenuitem>Double Line</guimenuitem> view
- </title>
- <screenshot id="reg-views-ViewAutoSplitDouble">
- <mediaobject>
- <imageobject role="html">
- <imagedata fileref="figures/Help_Tx_ViewAutoSplitDouble.png"
- format="PNG" srccredit="Chris Good" width="510px"></imagedata>
- </imageobject>
- <imageobject role="fo">
- <imagedata fileref="figures/Help_Tx_ViewAutoSplitDouble.png" format="PNG"
- srccredit="Chris Good"></imagedata>
- </imageobject>
-
- <textobject>
- <phrase>Example Clothes register</phrase>
- </textobject>
- </mediaobject>
- </screenshot>
- </figure>
-
- <figure>
- <title>Example Register in <guimenuitem>Transaction Journal</guimenuitem>,
- <guimenuitem>Single Line</guimenuitem> view
- </title>
- <screenshot id="reg-views-ViewTxJnl">
- <mediaobject>
- <imageobject role="html">
- <imagedata fileref="figures/Help_Tx_ViewTxJnl.png"
- format="PNG" srccredit="Chris Good" width="510px"></imagedata>
- </imageobject>
- <imageobject role="fo">
- <imagedata fileref="figures/Help_Tx_ViewTxJnl.png" format="PNG"
- srccredit="Chris Good"></imagedata>
- </imageobject>
-
- <textobject>
- <phrase>Example Clothes register</phrase>
- </textobject>
- </mediaobject>
- </screenshot>
- </figure>
-
- <figure>
- <title>Example Register in <guimenuitem>Transaction Journal</guimenuitem>,
- <guimenuitem>Double Line</guimenuitem> view
- </title>
- <screenshot id="reg-views-ViewTxJnlDouble">
- <mediaobject>
- <imageobject role="html">
- <imagedata fileref="figures/Help_Tx_ViewTxJnlDouble.png"
- format="PNG" srccredit="Chris Good" width="510px"></imagedata>
- </imageobject>
- <imageobject role="fo">
- <imagedata fileref="figures/Help_Tx_ViewTxJnlDouble.png" format="PNG"
- srccredit="Chris Good"></imagedata>
- </imageobject>
-
- <textobject>
- <phrase>Example Clothes register</phrase>
- </textobject>
- </mediaobject>
- </screenshot>
- </figure>
-
- </sect3>
- </sect2>
-
- <sect2 id="reg-views-filter-sort">
- <title>Filter or Sort</title>
- <para>The other options to change the view of the register are</para>
- <itemizedlist>
- <listitem>
- <para>Restrict displayed items with
- <menuchoice><guimenu>View</guimenu>
- <guimenuitem>Filter By ...</guimenuitem>
- </menuchoice>
- </para>
-
- <tip>
- <para>Don't forget to remove a filter when you are finished with
- it or you may think transactions are missing.</para>
- </tip>
- </listitem>
-
- <listitem>
- <para>Change the sort order with
- <menuchoice>
- <guimenu>View</guimenu><guimenuitem>Sort Order</guimenuitem>
- </menuchoice>.
- </para>
- </listitem>
- </itemizedlist>
-
- <para>Refer to <xref linkend="Trans-view-menu"></xref>.</para>
-
- </sect2>
- </sect1>
<sect1 id="trans-win-enter">
<title>Transfer Funds Dialog Box</title>
diff --git a/help/C/figures/Help_Tx_ViewAutoSplit.png b/help/C/figures/Help_Tx_ViewAutoSplit.png
deleted file mode 100644
index 3ea056b..0000000
Binary files a/help/C/figures/Help_Tx_ViewAutoSplit.png and /dev/null differ
diff --git a/help/C/figures/Help_Tx_ViewAutoSplitDouble.png b/help/C/figures/Help_Tx_ViewAutoSplitDouble.png
deleted file mode 100644
index e174141..0000000
Binary files a/help/C/figures/Help_Tx_ViewAutoSplitDouble.png and /dev/null differ
diff --git a/help/C/figures/Help_Tx_ViewBankTxJnlDouble.png b/help/C/figures/Help_Tx_ViewBankTxJnlDouble.png
deleted file mode 100644
index d88887a..0000000
Binary files a/help/C/figures/Help_Tx_ViewBankTxJnlDouble.png and /dev/null differ
diff --git a/help/C/figures/Help_Tx_ViewBasic.png b/help/C/figures/Help_Tx_ViewBasic.png
deleted file mode 100644
index eefc585..0000000
Binary files a/help/C/figures/Help_Tx_ViewBasic.png and /dev/null differ
diff --git a/help/C/figures/Help_Tx_ViewBasicDouble.png b/help/C/figures/Help_Tx_ViewBasicDouble.png
deleted file mode 100644
index 34870b9..0000000
Binary files a/help/C/figures/Help_Tx_ViewBasicDouble.png and /dev/null differ
diff --git a/help/C/figures/Help_Tx_ViewTxJnl.png b/help/C/figures/Help_Tx_ViewTxJnl.png
deleted file mode 100644
index 6f8b31e..0000000
Binary files a/help/C/figures/Help_Tx_ViewTxJnl.png and /dev/null differ
diff --git a/help/C/figures/Help_Tx_ViewTxJnlDouble.png b/help/C/figures/Help_Tx_ViewTxJnlDouble.png
deleted file mode 100644
index 5ba1c58..0000000
Binary files a/help/C/figures/Help_Tx_ViewTxJnlDouble.png and /dev/null differ
commit fecf28a2518b4365f4dc6eb518074cf89a781faf
Author: goodvibes2 <chris.good at ozemail.com.au>
Date: Fri Mar 10 18:20:20 2017 +1100
Bug 769457 More info re register views
diff --git a/guide/C/ch_txns.xml b/guide/C/ch_txns.xml
index e2fc877..b425dbd 100644
--- a/guide/C/ch_txns.xml
+++ b/guide/C/ch_txns.xml
@@ -349,10 +349,10 @@
<note>
<para>Note: An account register displays a transaction when that
transaction has a split assigned to the account. If a given transaction
- has more than one split assigned to a single account, then in Basic and
- Auto-Split view modes that transaction will appear in the register one
+ has more than one split assigned to the account, then in Basic and
+ Auto-Split views, that transaction will appear in the register one
time for each split assigned to that account. In Transaction Journal
- mode, such a transaction will only appear once in the register.</para>
+ view, such a transaction will only appear once in the register.</para>
</note>
<para>The partial lines below the transaction line are the
diff --git a/help/C/Help_ch_GUIMenus.xml b/help/C/Help_ch_GUIMenus.xml
index 385683b..911d19d 100644
--- a/help/C/Help_ch_GUIMenus.xml
+++ b/help/C/Help_ch_GUIMenus.xml
@@ -2534,7 +2534,10 @@
<entry><para><guimenuitem>Basic Ledger</guimenuitem></para></entry>
<entry namest="c2" nameend="c3">
- <para>Radio button to select register display mode.</para></entry>
+ <para>Radio button to select register display mode. See
+ <xref linkend="reg-views"></xref>.
+ </para>
+ </entry>
</row>
<row>
diff --git a/help/C/Help_ch_Transactions.xml b/help/C/Help_ch_Transactions.xml
index 3eb5314..7ffe8ee 100644
--- a/help/C/Help_ch_Transactions.xml
+++ b/help/C/Help_ch_Transactions.xml
@@ -43,8 +43,8 @@ Translators:
</listitem>
<listitem>
- <para>Importing transactions either from a <acronym>QIF</acronym>/<acronym>OFX</acronym> file or via
- "<acronym>OFX</acronym> on-line banking".</para>
+ <para>Importing transactions either from a file or via on-line banking.
+ </para>
</listitem>
</itemizedlist>
@@ -56,44 +56,252 @@ Translators:
<sect1 id="reg-views">
<title>Changing the Register View</title>
- <para><application>&app;</application> has several options to change the way the register looks so transactions can be seen more
- clearly. The default style is the Basic Ledger. This presents a single line view of transactions to allow
+ <para><application>&app;</application> has several options to change the way
+ the register looks so transactions can be seen more clearly.
+ </para>
+
+ <sect2 id="reg-views-view">
+ <title>View</title>
+ <para>
+ The default view is the Basic Ledger. This presents a single line view of transactions to allow
the most concise view with all the relevant details.</para>
- <para>The default view or style can be changed by going to <guimenu>View</guimenu> menu, three radio buttons
- will select the desired option. When the window closes the style will revert to the Basic Ledger style. To
- make this change permanent change the style in the <guilabel>Register Defaults</guilabel> tab of the
- <guilabel>&app; Preferences</guilabel>.</para>
+ <para>The view of an open register can be changed by options in the
+ <guimenu>View</guimenu> menu. A register will always open in the
+ <guilabel>Default Style</guilabel> set in the <guilabel>Register
+ Defaults</guilabel> tab of the <guilabel>&app; Preferences</guilabel>.
+ </para>
<itemizedlist>
<listitem>
- <para><guimenu>Basic Ledger:</guimenu> The default one line per transaction style. Splits are
- shown as a summary. The <guibutton>Splits</guibutton> icon and <menuchoice><guimenu>Actions</guimenu>
- <guimenuitem>Split Transaction</guimenuitem></menuchoice> are enabled.</para>
+ <para><guimenu>Basic Ledger:</guimenu> The default one line per
+ transaction view. Splits are shown as a summary. The <guibutton>Splits
+ </guibutton> icon and <menuchoice><guimenu>Actions</guimenu>
+ <guimenuitem>Split Transaction</guimenuitem></menuchoice> are enabled.
+ </para>
</listitem>
<listitem>
- <para><guimenu>Auto-Split Ledger:</guimenu> This style will automatically expand the splits in any
- transaction selected.</para>
+ <para><guimenu>Auto-Split Ledger:</guimenu> This view will automatically
+ expand to show the splits in any transaction selected. Unselected
+ transactions are shown unexpanded.
+ </para>
</listitem>
<listitem>
- <para><guimenu>Transaction Journal:</guimenu> This style expands all transactions so the complete
- transaction can be seen.</para>
+ <para><guimenu>Transaction Journal:</guimenu> This view expands all
+ transactions so all the splits in all transactions can be seen.
+ </para>
</listitem>
<listitem>
- <para><guimenu>Double Line:</guimenu> This check-box changes any of the above styles so that an additional
- line for notes about the transaction is added.</para>
+ <para><guimenu>Double Line:</guimenu> This check-box changes any of the
+ above views so that an additional line for notes about the transaction
+ is added.</para>
</listitem>
</itemizedlist>
- <para>The two other options to change the view of the register are; to restrict displayed items with the
- <menuchoice><guimenu>View</guimenu><guimenuitem>Filter By ...</guimenuitem></menuchoice>,
- and changing the sort order <menuchoice><guimenu>View</guimenu><guimenuitem>Sort Order</guimenuitem></menuchoice>.
- <xref linkend="Trans-view-menu"></xref>.
- </para>
+ <sect3 id="reg-views-examples">
+ <title>Examples of Register Views</title>
+
+ <para>The following examples of the Clothes expense account are done
+ from that account in order to show how multiple splits for the
+ register account in one transaction appear in each view. Usually these
+ transactions would be entered from the bank account register, not the
+ expense account register. Here is the Bank register to initially
+ show a more usual view. As there are multiple Clothes account splits
+ in 2 of the transactions (those for the 21/1/2008 and 23/1/2008), it
+ is shown in <guimenuitem>Transaction Journal </guimenuitem> and
+ <guimenuitem>Double Line</guimenuitem> view so all the detail can be
+ seen.
+ </para>
+ <figure>
+ <title>Example Bank register in <guimenuitem>Transaction
+ Journal</guimenuitem>, <guimenuitem>Double Line</guimenuitem> view
+ </title>
+ <screenshot id="reg-views-BankTxJnlDouble">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/Help_Tx_ViewBankTxJnlDouble.png"
+ format="PNG" srccredit="Chris Good" width="510px"></imagedata>
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/Help_Tx_ViewBankTxJnlDouble.png" format="PNG"
+ srccredit="Chris Good"></imagedata>
+ </imageobject>
+
+ <textobject>
+ <phrase>The Bank register</phrase>
+ </textobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+
+ <figure>
+ <title>Example Register in <guimenuitem>Basic Ledger</guimenuitem>,
+ <guimenuitem>Single Line</guimenuitem> view
+ </title>
+ <screenshot id="reg-views-ViewBasic">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/Help_Tx_ViewBasic.png"
+ format="PNG" srccredit="Chris Good" width="510px"></imagedata>
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/Help_Tx_ViewBasic.png" format="PNG"
+ srccredit="Chris Good"></imagedata>
+ </imageobject>
+
+ <textobject>
+ <phrase>Example Clothes register</phrase>
+ </textobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+
+ <figure>
+ <title>Example Register in <guimenuitem>Basic Ledger</guimenuitem>,
+ <guimenuitem>Double Line</guimenuitem> view
+ </title>
+ <screenshot id="reg-views-ViewBasicDouble">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/Help_Tx_ViewBasicDouble.png"
+ format="PNG" srccredit="Chris Good" width="510px"></imagedata>
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/Help_Tx_ViewBasicDouble.png" format="PNG"
+ srccredit="Chris Good"></imagedata>
+ </imageobject>
+
+ <textobject>
+ <phrase>Example Clothes register</phrase>
+ </textobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+
+ <figure>
+ <title>Example Register in <guimenuitem>Auto-Split Ledger</guimenuitem>,
+ <guimenuitem>Single Line</guimenuitem> view
+ </title>
+ <screenshot id="reg-views-ViewAutoSplit">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/Help_Tx_ViewAutoSplit.png"
+ format="PNG" srccredit="Chris Good" width="510px"></imagedata>
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/Help_Tx_ViewAutoSplit.png" format="PNG"
+ srccredit="Chris Good"></imagedata>
+ </imageobject>
+
+ <textobject>
+ <phrase>Example Clothes register</phrase>
+ </textobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+
+ <figure>
+ <title>Example Register in <guimenuitem>Auto-Split Ledger</guimenuitem>,
+ <guimenuitem>Double Line</guimenuitem> view
+ </title>
+ <screenshot id="reg-views-ViewAutoSplitDouble">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/Help_Tx_ViewAutoSplitDouble.png"
+ format="PNG" srccredit="Chris Good" width="510px"></imagedata>
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/Help_Tx_ViewAutoSplitDouble.png" format="PNG"
+ srccredit="Chris Good"></imagedata>
+ </imageobject>
+
+ <textobject>
+ <phrase>Example Clothes register</phrase>
+ </textobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+
+ <figure>
+ <title>Example Register in <guimenuitem>Transaction Journal</guimenuitem>,
+ <guimenuitem>Single Line</guimenuitem> view
+ </title>
+ <screenshot id="reg-views-ViewTxJnl">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/Help_Tx_ViewTxJnl.png"
+ format="PNG" srccredit="Chris Good" width="510px"></imagedata>
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/Help_Tx_ViewTxJnl.png" format="PNG"
+ srccredit="Chris Good"></imagedata>
+ </imageobject>
+
+ <textobject>
+ <phrase>Example Clothes register</phrase>
+ </textobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+
+ <figure>
+ <title>Example Register in <guimenuitem>Transaction Journal</guimenuitem>,
+ <guimenuitem>Double Line</guimenuitem> view
+ </title>
+ <screenshot id="reg-views-ViewTxJnlDouble">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/Help_Tx_ViewTxJnlDouble.png"
+ format="PNG" srccredit="Chris Good" width="510px"></imagedata>
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/Help_Tx_ViewTxJnlDouble.png" format="PNG"
+ srccredit="Chris Good"></imagedata>
+ </imageobject>
+
+ <textobject>
+ <phrase>Example Clothes register</phrase>
+ </textobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+
+ </sect3>
+ </sect2>
+
+ <sect2 id="reg-views-filter-sort">
+ <title>Filter or Sort</title>
+ <para>The other options to change the view of the register are</para>
+ <itemizedlist>
+ <listitem>
+ <para>Restrict displayed items with
+ <menuchoice><guimenu>View</guimenu>
+ <guimenuitem>Filter By ...</guimenuitem>
+ </menuchoice>
+ </para>
+
+ <tip>
+ <para>Don't forget to remove a filter when you are finished with
+ it or you may think transactions are missing.</para>
+ </tip>
+ </listitem>
+
+ <listitem>
+ <para>Change the sort order with
+ <menuchoice>
+ <guimenu>View</guimenu><guimenuitem>Sort Order</guimenuitem>
+ </menuchoice>.
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <para>Refer to <xref linkend="Trans-view-menu"></xref>.</para>
+
+ </sect2>
</sect1>
<sect1 id="trans-win-enter">
diff --git a/help/C/figures/Help_Tx_ViewAutoSplit.png b/help/C/figures/Help_Tx_ViewAutoSplit.png
new file mode 100644
index 0000000..3ea056b
Binary files /dev/null and b/help/C/figures/Help_Tx_ViewAutoSplit.png differ
diff --git a/help/C/figures/Help_Tx_ViewAutoSplitDouble.png b/help/C/figures/Help_Tx_ViewAutoSplitDouble.png
new file mode 100644
index 0000000..e174141
Binary files /dev/null and b/help/C/figures/Help_Tx_ViewAutoSplitDouble.png differ
diff --git a/help/C/figures/Help_Tx_ViewBankTxJnlDouble.png b/help/C/figures/Help_Tx_ViewBankTxJnlDouble.png
new file mode 100644
index 0000000..d88887a
Binary files /dev/null and b/help/C/figures/Help_Tx_ViewBankTxJnlDouble.png differ
diff --git a/help/C/figures/Help_Tx_ViewBasic.png b/help/C/figures/Help_Tx_ViewBasic.png
new file mode 100644
index 0000000..eefc585
Binary files /dev/null and b/help/C/figures/Help_Tx_ViewBasic.png differ
diff --git a/help/C/figures/Help_Tx_ViewBasicDouble.png b/help/C/figures/Help_Tx_ViewBasicDouble.png
new file mode 100644
index 0000000..34870b9
Binary files /dev/null and b/help/C/figures/Help_Tx_ViewBasicDouble.png differ
diff --git a/help/C/figures/Help_Tx_ViewTxJnl.png b/help/C/figures/Help_Tx_ViewTxJnl.png
new file mode 100644
index 0000000..6f8b31e
Binary files /dev/null and b/help/C/figures/Help_Tx_ViewTxJnl.png differ
diff --git a/help/C/figures/Help_Tx_ViewTxJnlDouble.png b/help/C/figures/Help_Tx_ViewTxJnlDouble.png
new file mode 100644
index 0000000..5ba1c58
Binary files /dev/null and b/help/C/figures/Help_Tx_ViewTxJnlDouble.png differ
commit 6e32b58d63d132257dedf3cd7927b73bc6c18507
Merge: 12e0ec4 54666fb
Author: John Ralls <jralls at ceridwen.us>
Date: Sat Mar 25 11:25:39 2017 -0700
Merge branch 'viewlots3' into maint
commit 54666fb4be5ec2ab92dec55f27d13fa0641c8596
Author: goodvibes2 <chris.good at ozemail.com.au>
Date: Wed Mar 22 10:40:03 2017 +1100
Bug 774658 Add warning to delete lot before deleting a cap gain/loss transaction
diff --git a/guide/C/ch_invest.xml b/guide/C/ch_invest.xml
index 8ab4ed5..b9d41f5 100644
--- a/guide/C/ch_invest.xml
+++ b/guide/C/ch_invest.xml
@@ -2496,8 +2496,12 @@ Income
total credits.
</para>
- <note><para>If you make an error, you can delete the capital gain/loss
- transaction(s) and lot(s) and retry.</para>
+ <note><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 delete a
+ capital gain/loss transaction. Otherwise, the <guilabel>Lots in
+ Account</guilabel> screen will recreate the capital gain/loss
+ transaction when you select the lot.</para>
</note>
<para>
commit 0477ba9d0914164bd94bc81f667500f196527131
Author: goodvibes2 <chris.good at ozemail.com.au>
Date: Mon Mar 20 19:22:27 2017 +1100
Use − instead of - for subtraction or -ve nos
diff --git a/guide/C/ch_invest.xml b/guide/C/ch_invest.xml
index 311aaef..8ab4ed5 100644
--- a/guide/C/ch_invest.xml
+++ b/guide/C/ch_invest.xml
@@ -1628,7 +1628,7 @@ Income
<listitem>
<para>NET_SALE: amount of money received from the sale, equal to
- GROSS_SALE - COMMISSION</para>
+ GROSS_SALE − COMMISSION</para>
</listitem>
<listitem>
@@ -1724,7 +1724,7 @@ Income
<row>
<entry>Assets:Stock:SYMBOL</entry>
- <entry>-NUM_SHARES</entry>
+ <entry>−NUM_SHARES</entry>
<entry>GROSS_SELL_PRICE</entry>
<entry></entry>
<entry>GROSS_SALE</entry>
@@ -1782,7 +1782,7 @@ Income
<row>
<entry>Assets:Stock:SYMBOL</entry>
- <entry>-NUM_SHARES</entry>
+ <entry>−NUM_SHARES</entry>
<entry>NET_SELL_PRICE</entry>
<entry></entry>
<entry>NET_SALE</entry>
@@ -1852,7 +1852,7 @@ Income
<row>
<entry>Assets:Stock:SYMBOL</entry>
- <entry>-NUM_SHARES</entry>
+ <entry>−NUM_SHARES</entry>
<entry>GROSS_SELL_PRICE</entry>
<entry></entry>
<entry>GROSS_SALE</entry>
@@ -1932,7 +1932,7 @@ Income
<row>
<entry>Assets:Stock:SYMBOL</entry>
- <entry>-NUM_SHARES</entry>
+ <entry>−NUM_SHARES</entry>
<entry>NET_SELL_PRICE</entry>
<entry></entry>
<entry>NET_SALE</entry>
@@ -1999,7 +1999,7 @@ Income
In the split transaction scheme above, GROSS_BUY_PRICE is $20 (the
original buying price), NUM_SHARES is 100, GROSS_BUY is $2000 (the
original buying cost), GROSS_SALE is $3600, and finally GROSS_PROFIT
- is $1600 (GROSS_SALE-GROSS_BUY).
+ is $1600 (GROSS_SALE − GROSS_BUY).
</para>
<table>
@@ -2049,7 +2049,7 @@ Income
<row>
<entry>Assets:Brokerage Account:Stock:AMZN</entry>
- <entry>-100</entry>
+ <entry>−100</entry>
<entry>36.00</entry>
<entry></entry>
<entry>3600.00</entry>
@@ -2131,8 +2131,8 @@ Income
with a commission of $75. In the split transaction scheme above,
NUM_SHARES is 100, NET_BUY_PRICE is $20 (the original buying price),
NET_BUY is $2000 (the original buying cost), NET_SELL_PRICE is $35.25
- (($3600 - $75) / 100)), GROSS_SALE is $3600, NET_SALE is $3525, and
- finally NET_PROFIT is $1525 (NET_SALE - NET_BUY).
+ (($3600 − $75) / 100)), GROSS_SALE is $3600, NET_SALE is $3525,
+ and finally NET_PROFIT is $1525 (NET_SALE − NET_BUY).
</para>
<table>
@@ -2174,7 +2174,7 @@ Income
<row>
<entry>Assets:Brokerage Account:Stock:AMZN</entry>
- <entry>-100</entry>
+ <entry>−100</entry>
<entry>35.25</entry>
<entry></entry>
<entry>3525.00</entry>
@@ -2225,7 +2225,7 @@ Income
$75. In the split transaction scheme above, GROSS_BUY_PRICE is $20
(the original buying price), NUM_SHARES is 100, GROSS_BUY is $2000
(the original buying cost), GROSS_SALE is $3600, and finally
- GROSS_PROFIT is $1600 (GROSS_SALE-GROSS_BUY).
+ GROSS_PROFIT is $1600 (GROSS_SALE − GROSS_BUY).
</para>
<table>
@@ -2266,7 +2266,7 @@ Income
<row>
<entry>Assets:Brokerage Account:Stock:AMZN</entry>
- <entry>-100</entry>
+ <entry>−100</entry>
<entry>36.00</entry>
<entry></entry>
<entry>3600.00</entry>
@@ -2347,8 +2347,8 @@ Income
commission of $75. In the split transaction scheme above, NUM_SHARES
is 100, NET_BUY_PRICE is $20 (the original buying price), NET_BUY is
$2000 (the original buying cost), NET_SELL_PRICE is $35.25
- (($3600 - $75) / 100)), GROSS_SALE is $3600, NET_SALE is $3525, and
- finally NET_PROFIT is $1525 (NET_SALE - NET_BUY).
+ (($3600 − $75) / 100)), GROSS_SALE is $3600, NET_SALE is $3525,
+ and finally NET_PROFIT is $1525 (NET_SALE − NET_BUY).
</para>
<table>
@@ -2381,7 +2381,7 @@ Income
<row>
<entry>Assets:Brokerage Account:Stock:AMZN</entry>
- <entry>-100</entry>
+ <entry>−100</entry>
<entry>35.25</entry>
<entry></entry>
<entry>3525.00</entry>
@@ -2796,7 +2796,7 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
</row>
<row>
<entry>Security</entry>
- <entry>-NumSold</entry>
+ <entry>−NumSold</entry>
<entry>SaleUnitPrice</entry>
<entry></entry>
<entry>SaleValue</entry>
@@ -3379,10 +3379,10 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
<itemizedlist>
<listitem><para>
- Lot 0: 1/7/2009 loss $400 (sale $600 - cost $1000)</para>
+ Lot 0: 1/7/2009 loss $400 (sale $600 − cost $1000)</para>
</listitem>
<listitem><para>
- Lot 1: 1/7/2009 gain $600 (sale $600 - cost $0)</para>
+ Lot 1: 1/7/2009 gain $600 (sale $600 − cost $0)</para>
</listitem>
</itemizedlist>
@@ -3831,7 +3831,7 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
<para>In our example it is a .77942 for 1 split so the number of shares will
decrease from the number of shares currently in the register. You may use <application>&app;</application>’s
ability to preform calculations on an entry form by entering data directly
- (E.g. <quote>(.77942*100)-100</quote>) to calculate the decrease in shares
+ (E.g. <quote>(.77942*100)−100</quote>) to calculate the decrease in shares
from the split.</para>
</listitem>
commit cae6d1b1cb0a7b728d4ef8d91fc8b6c204dba4cc
Author: goodvibes2 <chris.good at ozemail.com.au>
Date: Mon Mar 20 17:48:44 2017 +1100
Fix indentation and some long lines ch_invest.xml
diff --git a/guide/C/ch_invest.xml b/guide/C/ch_invest.xml
index 4504c51..311aaef 100644
--- a/guide/C/ch_invest.xml
+++ b/guide/C/ch_invest.xml
@@ -985,14 +985,16 @@ Income
<phrase>Setup Current Portfolio</phrase>
</textobject>
- <caption><para>This image is of the transaction register of the AMZN account
- after the first stock <quote>purchase</quote>.</para></caption>
+ <caption><para>This image is of the transaction register of the AMZN
+ account after the first stock <quote>purchase</quote>.</para>
+ </caption>
</mediaobject>
</screenshot>
- <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) rather than $2000. This is how it should be.</para>
+ <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) rather than $2000. This is how it should be.
+ </para>
</sect2>
<sect2 id="invest-buy-new2">
@@ -1069,14 +1071,15 @@ Income
<guilabel>Description</guilabel> (eg: Initial IBM Purchase). On the
first split line, enter 50 in <guilabel>Shares</guilabel>, delete
<guilabel>Price</guilabel> (leave it empty so it will be calculated)),
- and enter 5000 in <guilabel>Buy</guilabel>. You do not need to fill in the
- <guilabel>Price</guilabel> 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:Commissions</emphasis> and fill in <guilabel>Buy</guilabel>
- ($100). The third line will be to transfer $5100 from account <emphasis>
+ and enter 5000 in <guilabel>Buy</guilabel>. You do not need to fill in
+ the <guilabel>Price</guilabel> 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:Commissions
+ </emphasis> and fill in <guilabel>Buy</guilabel> ($100). The third
+ line will be to transfer $5100 from account <emphasis>
Assets:Bank ABC</emphasis> to balance the transaction. Your IBM
- Commodity view should now appear like this:</para>
+ Commodity view should now appear like this:
+ </para>
<screenshot id="invest-setup-portfolio2">
<mediaobject>
@@ -1129,12 +1132,13 @@ Income
</para>
<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 transfer from <emphasis>Assets:Bank ABC
- </emphasis> $5100 to balance the transaction. After the splits are all
- correct, use the <keycap function="enter" >Enter</keycap> key to save
- the transaction. Your IBM Commodity view should now appear like this:
+ 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 transfer from <emphasis>
+ Assets:Bank ABC</emphasis> $5100 to balance the transaction. After the
+ splits are all correct, use the <keycap function="enter" >Enter
+ </keycap> key to save the transaction. Your IBM Commodity view should
+ now appear like this:
</para>
<screenshot id="invest-setup-portfolio3">
@@ -1675,167 +1679,580 @@ Income
<sect4 id="invest-sell-man-comb-gr">
<title>Combined, Gross Pricing</title>
+ <table>
+ <title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are
+ Combined, Gross Pricing</title>
+
+ <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*"/>
+ <tbody>
+ <row>
+ <entry><emphasis>Account</emphasis></entry>
+ <entry><emphasis>Number of Shares</emphasis></entry>
+ <entry><emphasis>Share Price</emphasis></entry>
+ <entry><emphasis>Total Buy</emphasis></entry>
+ <entry><emphasis>Total Sell</emphasis></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Bank ABC</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>NET_SALE</entry>
+ <entry></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Stock:SYMBOL</entry>
+ <entry>0</entry>
+ <entry>0</entry>
+ <entry>GROSS_PROFIT</entry>
+ <entry>(Loss)</entry>
+ </row>
+
+ <row>
+ <entry>Expenses:Commission</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>COMMISSION</entry>
+ <entry></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Stock:SYMBOL</entry>
+ <entry>-NUM_SHARES</entry>
+ <entry>GROSS_SELL_PRICE</entry>
+ <entry></entry>
+ <entry>GROSS_SALE</entry>
+ </row>
+
+ <row>
+ <entry>Income:Capital Gains</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>(Loss)</entry>
+ <entry>GROSS_PROFIT</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </sect4>
+
+ <sect4 id="invest-sell-man-comb-net">
+ <title>Combined, Net Pricing</title>
+
+ <table>
+ <title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are
+ Combined, Net Pricing</title>
+
+ <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*"/>
+ <tbody>
+ <row>
+ <entry><emphasis>Account</emphasis></entry>
+ <entry><emphasis>Number of Shares</emphasis></entry>
+ <entry><emphasis>Share Price</emphasis></entry>
+ <entry><emphasis>Total Buy</emphasis></entry>
+ <entry><emphasis>Total Sell</emphasis></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Bank ABC</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>NET_SALE</entry>
+ <entry></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Stock:SYMBOL</entry>
+ <entry>0</entry>
+ <entry>0</entry>
+ <entry>NET_PROFIT</entry>
+ <entry>(Loss)</entry>
+ </row>
+
+ <row>
+ <entry>Assets:Stock:SYMBOL</entry>
+ <entry>-NUM_SHARES</entry>
+ <entry>NET_SELL_PRICE</entry>
+ <entry></entry>
+ <entry>NET_SALE</entry>
+ </row>
+
+ <row>
+ <entry>Income:Capital Gain</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>(Loss)</entry>
+ <entry>NET_PROFIT</entry>
+ </row>
+
+ </tbody>
+ </tgroup>
+ </table>
+ </sect4>
+ </sect3>
+
+ <sect3 id="invest-sell-man-sep">
+ <title>Separate the Capital Gain/Loss Transaction from the Sale
+ Transaction.</title>
+
+ <para>This is <emphasis>required</emphasis> if using <emphasis>scrubbing
+ </emphasis> to automatically calculate and create capital gain/loss
+ transactions (otherwise scrubbing will not detect them and will create
+ an incorrectly valued gain/loss transaction).
+ </para>
+
+ <sect4 id="invest-sell-man-sep-gr">
+ <title>Separated, Gross Pricing</title>
+
+ <table>
+ <title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are
+ Separate Transactions, Sale Transaction</title>
+
+ <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*"/>
+ <tbody>
+ <row>
+ <entry><emphasis>Account</emphasis></entry>
+ <entry><emphasis>Number of Shares</emphasis></entry>
+ <entry><emphasis>Share Price</emphasis></entry>
+ <entry><emphasis>Total Buy</emphasis></entry>
+ <entry><emphasis>Total Sell</emphasis></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Bank ABC</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>NET_SALE</entry>
+ <entry></entry>
+ </row>
+
+ <row>
+ <entry>Expenses:Commission</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>COMMISSION</entry>
+ <entry></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Stock:SYMBOL</entry>
+ <entry>-NUM_SHARES</entry>
+ <entry>GROSS_SELL_PRICE</entry>
+ <entry></entry>
+ <entry>GROSS_SALE</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+
+ <table>
+ <title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are
+ Separate Transactions, Capital Gain/Loss Transaction</title>
+
+ <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*"/>
+ <tbody>
+ <row>
+ <entry><emphasis>Account</emphasis></entry>
+ <entry><emphasis>Number of Shares</emphasis></entry>
+ <entry><emphasis>Share Price</emphasis></entry>
+ <entry><emphasis>Total Buy</emphasis></entry>
+ <entry><emphasis>Total Sell</emphasis></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Stock:SYMBOL</entry>
+ <entry>0</entry>
+ <entry>0</entry>
+ <entry>GROSS_PROFIT</entry>
+ <entry>(Loss)</entry>
+ </row>
+
+ <row>
+ <entry>Income:Capital Gain</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>(Loss)</entry>
+ <entry>GROSS_PROFIT</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </sect4>
+
+ <sect4 id="invest-sell-man-sep-net">
+ <title>Separated, Net Pricing</title>
+
+ <table>
+ <title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are
+ Separate Transactions, Sale Transaction</title>
+
+ <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*"/>
+ <tbody>
+ <row>
+ <entry><emphasis>Account</emphasis></entry>
+ <entry><emphasis>Number of Shares</emphasis></entry>
+ <entry><emphasis>Share Price</emphasis></entry>
+ <entry><emphasis>Total Buy</emphasis></entry>
+ <entry><emphasis>Total Sell</emphasis></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Bank ABC</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>NET_SALE</entry>
+ <entry></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Stock:SYMBOL</entry>
+ <entry>-NUM_SHARES</entry>
+ <entry>NET_SELL_PRICE</entry>
+ <entry></entry>
+ <entry>NET_SALE</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+
+ <table>
+ <title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are
+ Separate Transactions, Capital Gain/Loss Transaction</title>
+
+ <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*"/>
+ <tbody>
+ <row>
+ <entry><emphasis>Account</emphasis></entry>
+ <entry><emphasis>Number of Shares</emphasis></entry>
+ <entry><emphasis>Share Price</emphasis></entry>
+ <entry><emphasis>Total Buy</emphasis></entry>
+ <entry><emphasis>Total Sell</emphasis></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Stock:SYMBOL</entry>
+ <entry>0</entry>
+ <entry>0</entry>
+ <entry>NET_PROFIT</entry>
+ <entry>(Loss)</entry>
+ </row>
+
+ <row>
+ <entry>Income:Capital Gain</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>(Loss)</entry>
+ <entry>NET_PROFIT</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </sect4>
+ </sect3>
+ </sect2>
+
+ <sect2 id="invest-sell-man-examples">
+ <title>Examples of Selling Shares with Manually Entry of Capital Gain or
+ Loss</title>
+
+ <para>In these examples we will use the AMZN account created in the
+ previous section.
+ </para>
+
+ <sect3 id="invest-sell-man-prof-comb-gross">
+ <title>Example: Sale of Shares with Profit, Manual Profit/Loss
+ Calculation, Sale & Profit Combined, Gross Pricing</title>
+
+ <para>In this example you bought 100 shares of AMZN for $20 per share,
+ then later sell them all for $36 per share with a commission of $75.
+ In the split transaction scheme above, GROSS_BUY_PRICE is $20 (the
+ original buying price), NUM_SHARES is 100, GROSS_BUY is $2000 (the
+ original buying cost), GROSS_SALE is $3600, and finally GROSS_PROFIT
+ is $1600 (GROSS_SALE-GROSS_BUY).
+ </para>
+
<table>
- <title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are
- Combined, Gross Pricing</title>
+ <title>Selling Shares Split Scheme, Sale & Gain Combined, Gross
+ Pricing</title>
+
+ <?dbfo table-width="70%" ?>
<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="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>Number of Shares</emphasis></entry>
- <entry><emphasis>Share Price</emphasis></entry>
- <entry><emphasis>Total Buy</emphasis></entry>
- <entry><emphasis>Total Sell</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>NET_SALE</entry>
+ <entry>3525.00</entry>
<entry></entry>
</row>
<row>
- <entry>Assets:Stock:SYMBOL</entry>
+ <entry>Assets:Brokerage Account:Stock:AMZN</entry>
<entry>0</entry>
<entry>0</entry>
- <entry>GROSS_PROFIT</entry>
- <entry>(Loss)</entry>
+ <entry>1600.00</entry>
+ <entry></entry>
</row>
<row>
<entry>Expenses:Commission</entry>
<entry></entry>
<entry></entry>
- <entry>COMMISSION</entry>
+ <entry>75.00</entry>
<entry></entry>
</row>
<row>
- <entry>Assets:Stock:SYMBOL</entry>
- <entry>-NUM_SHARES</entry>
- <entry>GROSS_SELL_PRICE</entry>
+ <entry>Assets:Brokerage Account:Stock:AMZN</entry>
+ <entry>-100</entry>
+ <entry>36.00</entry>
<entry></entry>
- <entry>GROSS_SALE</entry>
+ <entry>3600.00</entry>
</row>
<row>
- <entry>Income:Capital Gains</entry>
+ <entry>Income:Capital Gain (Long Term):AMZN</entry>
<entry></entry>
<entry></entry>
- <entry>(Loss)</entry>
- <entry>GROSS_PROFIT</entry>
+ <entry></entry>
+ <entry>1600.00</entry>
</row>
-
</tbody>
</tgroup>
</table>
- </sect4>
- <sect4 id="invest-sell-man-comb-net">
- <title>Combined, Net Pricing</title>
+ <screenshot id="invest-sellstockManProfComb">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/invest_sellstock.png" format="PNG"
+ srccredit="Chris Good" width="510px"></imagedata>
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/invest_sellstock.png" format="PNG"
+ srccredit="Chris Good"></imagedata>
+ </imageobject>
+
+ <textobject>
+ <phrase>Selling Shares Example</phrase>
+ </textobject>
+
+ <caption><para>An example of selling shares for gain. You bought 100
+ shares of AMZN for $20 per share, and sold for $36.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+
+ <note><para>In the above screenshot, it appears there are 2 transactions
+ for Mar 21st 2006. This is because the register is in <guilabel>
+ Auto-Split Ledger</guilabel> view and there are 2 splits for the
+ register account in the 1 transaction. <guilabel>Transaction Journal
+ </guilabel> view may be clearer. Refer to
+ <xref linkend="txns-registers-txntypes" />. 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>Basic Ledger</guilabel> view.</para>
+ </note>
+
+ <para> </para>
+
+ <screenshot id="invest-sellstockManProfComb2">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/invest_sellstock2.png" format="PNG"
+ srccredit="Chris Good" width="510px"></imagedata>
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/invest_sellstock2.png" format="PNG"
+ srccredit="Chris Good"></imagedata>
+ </imageobject>
+
+ <textobject>
+ <phrase>Selling Shares Example</phrase>
+ </textobject>
+
+ <caption><para>An image of the account tree after the example of
+ selling shares for gain. </para></caption>
+ </mediaobject>
+ </screenshot>
+ </sect3>
+
+ <sect3 id="invest-sell-man-prof-comb-net">
+ <title>Example: Sale of Shares with Profit, Manual Profit/Loss
+ Calculation, Sale & Profit Combined, Net Pricing</title>
+
+ <para>In this example you bought 100 shares of AMZN for $20 per share
+ (including commissions), then later sell them all for $36 per share
+ with a commission of $75. In the split transaction scheme above,
+ NUM_SHARES is 100, NET_BUY_PRICE is $20 (the original buying price),
+ NET_BUY is $2000 (the original buying cost), NET_SELL_PRICE is $35.25
+ (($3600 - $75) / 100)), GROSS_SALE is $3600, NET_SALE is $3525, and
+ finally NET_PROFIT is $1525 (NET_SALE - NET_BUY).
+ </para>
<table>
- <title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are
- Combined, Net Pricing</title>
+ <title>Selling Shares Split Scheme, Sale & Gain Combined, Net
+ Pricing</title>
+
+ <?dbfo table-width="70%" ?>
<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="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>Number of Shares</emphasis></entry>
- <entry><emphasis>Share Price</emphasis></entry>
- <entry><emphasis>Total Buy</emphasis></entry>
- <entry><emphasis>Total Sell</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>NET_SALE</entry>
+ <entry>3525.00</entry>
<entry></entry>
</row>
<row>
- <entry>Assets:Stock:SYMBOL</entry>
+ <entry>Assets:Brokerage Account:Stock:AMZN</entry>
<entry>0</entry>
<entry>0</entry>
- <entry>NET_PROFIT</entry>
- <entry>(Loss)</entry>
+ <entry>1525.00</entry>
+ <entry></entry>
</row>
<row>
- <entry>Assets:Stock:SYMBOL</entry>
- <entry>-NUM_SHARES</entry>
- <entry>NET_SELL_PRICE</entry>
+ <entry>Assets:Brokerage Account:Stock:AMZN</entry>
+ <entry>-100</entry>
+ <entry>35.25</entry>
<entry></entry>
- <entry>NET_SALE</entry>
+ <entry>3525.00</entry>
</row>
<row>
- <entry>Income:Capital Gain</entry>
+ <entry>Income:Capital Gain (Long Term):AMZN</entry>
<entry></entry>
<entry></entry>
- <entry>(Loss)</entry>
- <entry>NET_PROFIT</entry>
+ <entry></entry>
+ <entry>1525.00</entry>
</row>
-
</tbody>
</tgroup>
</table>
- </sect4>
+
+ <screenshot id="invest-sellstockManProfCombNet">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/invest_sellstockManProfCombNet.png" format="PNG"
+ srccredit="Chris Good" width="510px"></imagedata>
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/invest_sellstockManProfCombNet.png" format="PNG"
+ srccredit="Chris Good"></imagedata>
+ </imageobject>
+
+ <textobject>
+ <phrase>Selling Shares Example</phrase>
+ </textobject>
+
+ <caption><para>An example of selling shares for gain using net
+ pricing in transaction journal view. You bought 100 shares of AMZN
+ for $20 per share, and sold for $36.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+
+ <para> </para>
</sect3>
- <sect3 id="invest-sell-man-sep">
- <title>Separate the Capital Gain/Loss Transaction from the Sale
- Transaction.</title>
+ <sect3 id="invest-sell-man-prof-sep-gross">
+ <title>Example: Sale of Shares with Profit, Manual Profit/Loss
+ Calculation, Sale & Profit Separated, Gross Pricing</title>
- <para>This is <emphasis>required</emphasis> if using <emphasis>scrubbing
- </emphasis> to automatically calculate and create capital gain/loss
- transactions (otherwise scrubbing will not detect them and will create
- an incorrectly valued gain/loss transaction).
+ <para>You bought 100 shares of AMZN for $20 per share and commissions
+ $20, then later sell them all for $36 per share with a commission of
+ $75. In the split transaction scheme above, GROSS_BUY_PRICE is $20
+ (the original buying price), NUM_SHARES is 100, GROSS_BUY is $2000
+ (the original buying cost), GROSS_SALE is $3600, and finally
+ GROSS_PROFIT is $1600 (GROSS_SALE-GROSS_BUY).
</para>
- <sect4 id="invest-sell-man-sep-gr">
- <title>Separated, Gross Pricing</title>
-
<table>
- <title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are
- Separate Transactions, Sale Transaction</title>
+ <title>Selling Shares Split Scheme, Sale Transaction</title>
+
+ <?dbfo table-width="70%" ?>
<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="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>Number of Shares</emphasis></entry>
- <entry><emphasis>Share Price</emphasis></entry>
- <entry><emphasis>Total Buy</emphasis></entry>
- <entry><emphasis>Total Sell</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>NET_SALE</entry>
+ <entry>3525.00</entry>
<entry></entry>
</row>
@@ -1843,637 +2260,197 @@ Income
<entry>Expenses:Commission</entry>
<entry></entry>
<entry></entry>
- <entry>COMMISSION</entry>
+ <entry>75.00</entry>
<entry></entry>
</row>
<row>
- <entry>Assets:Stock:SYMBOL</entry>
- <entry>-NUM_SHARES</entry>
- <entry>GROSS_SELL_PRICE</entry>
+ <entry>Assets:Brokerage Account:Stock:AMZN</entry>
+ <entry>-100</entry>
+ <entry>36.00</entry>
<entry></entry>
- <entry>GROSS_SALE</entry>
+ <entry>3600.00</entry>
</row>
</tbody>
</tgroup>
</table>
<table>
- <title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are
- Separate Transactions, Capital Gain/Loss Transaction</title>
+ <title>Selling Shares Split Scheme, Gain Transaction</title>
+
+ <?dbfo table-width="70%" ?>
<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="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>Number of Shares</emphasis></entry>
- <entry><emphasis>Share Price</emphasis></entry>
- <entry><emphasis>Total Buy</emphasis></entry>
- <entry><emphasis>Total Sell</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:Stock:SYMBOL</entry>
+ <entry>Assets:Brokerage Account:Stock:AMZN</entry>
<entry>0</entry>
<entry>0</entry>
- <entry>GROSS_PROFIT</entry>
- <entry>(Loss)</entry>
+ <entry>1600.00</entry>
+ <entry></entry>
</row>
<row>
- <entry>Income:Capital Gain</entry>
+ <entry>Income:Capital Gain (Long Term):AMZN</entry>
+ <entry></entry>
<entry></entry>
<entry></entry>
- <entry>(Loss)</entry>
- <entry>GROSS_PROFIT</entry>
+ <entry>1600.00</entry>
</row>
</tbody>
</tgroup>
</table>
- </sect4>
- <sect4 id="invest-sell-man-sep-net">
- <title>Separated, Net Pricing</title>
+ <screenshot id="invest-sellstockManProfSep">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/invest_sellstockManProfSep.png" format="PNG"
+ srccredit="Chris Good" width="510px"></imagedata>
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/invest_sellstockManProfSep.png" format="PNG"
+ srccredit="Chris Good"></imagedata>
+ </imageobject>
+
+ <textobject>
+ <phrase>Selling Shares Example</phrase>
+ </textobject>
+
+ <caption><para>An example of selling shares for gain where the sale
+ and gain are recorded in separate transactions, in <guilabel>
+ Transaction Journal</guilabel> view. You bought 100 shares of AMZN
+ for $20 per share, and sold for $36.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </sect3>
+
+ <sect3 id="invest-sell-man-prof-sep-net">
+ <title>Example: Sale of Shares with Profit, Manual Profit/Loss
+ Calculation, Sale & Profit Separated, Net Pricing</title>
+
+ <para>You bought 100 shares of AMZN for $20 per share (including
+ commissions), then later sell them all for $36 per share with a
+ commission of $75. In the split transaction scheme above, NUM_SHARES
+ is 100, NET_BUY_PRICE is $20 (the original buying price), NET_BUY is
+ $2000 (the original buying cost), NET_SELL_PRICE is $35.25
+ (($3600 - $75) / 100)), GROSS_SALE is $3600, NET_SALE is $3525, and
+ finally NET_PROFIT is $1525 (NET_SALE - NET_BUY).
+ </para>
<table>
- <title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are
- Separate Transactions, Sale Transaction</title>
+ <title>Selling Shares Split Scheme, Sale Transaction</title>
+
+ <?dbfo table-width="70%" ?>
<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="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>Number of Shares</emphasis></entry>
- <entry><emphasis>Share Price</emphasis></entry>
- <entry><emphasis>Total Buy</emphasis></entry>
- <entry><emphasis>Total Sell</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>NET_SALE</entry>
+ <entry>3525.00</entry>
<entry></entry>
</row>
<row>
- <entry>Assets:Stock:SYMBOL</entry>
- <entry>-NUM_SHARES</entry>
- <entry>NET_SELL_PRICE</entry>
+ <entry>Assets:Brokerage Account:Stock:AMZN</entry>
+ <entry>-100</entry>
+ <entry>35.25</entry>
<entry></entry>
- <entry>NET_SALE</entry>
+ <entry>3525.00</entry>
</row>
</tbody>
</tgroup>
</table>
<table>
- <title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are
- Separate Transactions, Capital Gain/Loss Transaction</title>
+ <title>Selling Shares Split Scheme, Gain Transaction</title>
+
+ <?dbfo table-width="70%" ?>
<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="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>Number of Shares</emphasis></entry>
- <entry><emphasis>Share Price</emphasis></entry>
- <entry><emphasis>Total Buy</emphasis></entry>
- <entry><emphasis>Total Sell</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:Stock:SYMBOL</entry>
+ <entry>Assets:Brokerage Account:Stock:AMZN</entry>
<entry>0</entry>
<entry>0</entry>
- <entry>NET_PROFIT</entry>
- <entry>(Loss)</entry>
+ <entry>1525.00</entry>
+ <entry></entry>
</row>
<row>
- <entry>Income:Capital Gain</entry>
+ <entry>Income:Capital Gain (Long Term):AMZN</entry>
<entry></entry>
<entry></entry>
- <entry>(Loss)</entry>
- <entry>NET_PROFIT</entry>
+ <entry></entry>
+ <entry>1525.00</entry>
</row>
</tbody>
</tgroup>
</table>
- </sect4>
- </sect3>
- </sect2>
-
- <sect2 id="invest-sell-man-examples">
- <title>Examples of Selling Shares with Manually Entry of Capital Gain or
- Loss</title>
-
- <para>In these examples we will use the AMZN account created in the
- previous section.
- </para>
-
- <sect3 id="invest-sell-man-prof-comb-gross">
- <title>Example: Sale of Shares with Profit, Manual Profit/Loss
- Calculation, Sale & Profit Combined, Gross Pricing</title>
-
- <para>In this example you bought 100 shares of AMZN for $20 per share,
- then later sell them all for $36 per share with a commission of $75. In
- the split transaction scheme above, GROSS_BUY_PRICE is $20 (the original
- buying price), NUM_SHARES is 100, GROSS_BUY is $2000 (the original
- buying cost), GROSS_SALE is $3600, and finally GROSS_PROFIT is $1600
- (GROSS_SALE-GROSS_BUY).</para>
-
- <table>
- <title>Selling Shares Split Scheme, Sale & Gain Combined, Gross
- 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>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>-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>
-
- <screenshot id="invest-sellstockManProfComb">
- <mediaobject>
- <imageobject role="html">
- <imagedata fileref="figures/invest_sellstock.png" format="PNG"
- srccredit="Chris Good" width="510px"></imagedata>
- </imageobject>
- <imageobject role="fo">
- <imagedata fileref="figures/invest_sellstock.png" format="PNG"
- srccredit="Chris Good"></imagedata>
- </imageobject>
-
- <textobject>
- <phrase>Selling Shares Example</phrase>
- </textobject>
-
- <caption><para>An example of selling shares for gain. You bought 100
- shares of AMZN for $20 per share, and sold for $36.</para>
- </caption>
- </mediaobject>
- </screenshot>
-
- <note><para>In the above screenshot, it appears there are 2 transactions
- for Mar 21st 2006. This is because the register is in <guilabel>
- Auto-Split Ledger</guilabel> view and there are 2 splits for the
- register account in the 1 transaction. <guilabel>Transaction Journal
- </guilabel> view may be clearer. Refer to
- <xref linkend="txns-registers-txntypes" />. 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>Basic Ledger</guilabel> view.</para>
- </note>
-
- <para> </para>
-
- <screenshot id="invest-sellstockManProfComb2">
- <mediaobject>
- <imageobject role="html">
- <imagedata fileref="figures/invest_sellstock2.png" format="PNG"
- srccredit="Chris Good" width="510px"></imagedata>
- </imageobject>
- <imageobject role="fo">
- <imagedata fileref="figures/invest_sellstock2.png" format="PNG"
- srccredit="Chris Good"></imagedata>
- </imageobject>
-
- <textobject>
- <phrase>Selling Shares Example</phrase>
- </textobject>
-
- <caption><para>An image of the account tree after the example of
- selling shares for gain. </para></caption>
- </mediaobject>
- </screenshot>
- </sect3>
- <sect3 id="invest-sell-man-prof-comb-net">
- <title>Example: Sale of Shares with Profit, Manual Profit/Loss
- Calculation, Sale & Profit Combined, Net Pricing</title>
-
- <para>In this example you bought 100 shares of AMZN for $20 per share
- (including commissions), then later sell them all for $36 per share with
- a commission of $75. In the split transaction scheme above, NUM_SHARES
- is 100, NET_BUY_PRICE is $20 (the original buying price), NET_BUY is
- $2000 (the original buying cost), NET_SELL_PRICE is $35.25
- (($3600 - $75) / 100)), GROSS_SALE is $3600, NET_SALE is $3525, and
- finally NET_PROFIT is $1525 (NET_SALE - NET_BUY).
- </para>
-
- <table>
- <title>Selling Shares Split Scheme, Sale & 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>-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>
-
- <screenshot id="invest-sellstockManProfCombNet">
- <mediaobject>
- <imageobject role="html">
- <imagedata fileref="figures/invest_sellstockManProfCombNet.png" format="PNG"
- srccredit="Chris Good" width="510px"></imagedata>
- </imageobject>
- <imageobject role="fo">
- <imagedata fileref="figures/invest_sellstockManProfCombNet.png" format="PNG"
- srccredit="Chris Good"></imagedata>
- </imageobject>
-
- <textobject>
- <phrase>Selling Shares Example</phrase>
- </textobject>
-
- <caption><para>An example of selling shares for gain using net pricing
- in transaction journal view. You bought 100 shares of AMZN for $20
- per share, and sold for $36.</para>
- </caption>
- </mediaobject>
- </screenshot>
-
- <para> </para>
-
- </sect3>
-
- <sect3 id="invest-sell-man-prof-sep-gross">
- <title>Example: Sale of Shares with Profit, Manual Profit/Loss
- Calculation, Sale & Profit Separated, Gross Pricing</title>
-
- <para>You bought 100 shares of AMZN for $20 per share and commissions $20,
- then later sell them all for $36 per share with a commission of $75. In
- the split transaction scheme above, GROSS_BUY_PRICE is $20 (the original
- buying price), NUM_SHARES is 100, GROSS_BUY is $2000 (the original
- buying cost), GROSS_SALE is $3600, and finally GROSS_PROFIT is $1600
- (GROSS_SALE-GROSS_BUY).
- </para>
-
- <table>
- <title>Selling Shares Split Scheme, Sale Transaction</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>-100</entry>
- <entry>36.00</entry>
- <entry></entry>
- <entry>3600.00</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
-
- <table>
- <title>Selling Shares Split Scheme, Gain Transaction</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>
-
- <screenshot id="invest-sellstockManProfSep">
- <mediaobject>
- <imageobject role="html">
- <imagedata fileref="figures/invest_sellstockManProfSep.png" format="PNG"
- srccredit="Chris Good" width="510px"></imagedata>
- </imageobject>
- <imageobject role="fo">
- <imagedata fileref="figures/invest_sellstockManProfSep.png" format="PNG"
- srccredit="Chris Good"></imagedata>
- </imageobject>
-
- <textobject>
- <phrase>Selling Shares Example</phrase>
- </textobject>
-
- <caption><para>An example of selling shares for gain where the sale and
- gain are recorded in separate transactions, in <guilabel>Transaction
- Journal</guilabel> view. You bought 100 shares of AMZN for $20 per
- share, and sold for $36.</para>
- </caption>
- </mediaobject>
- </screenshot>
-
- </sect3>
-
- <sect3 id="invest-sell-man-prof-sep-net">
- <title>Example: Sale of Shares with Profit, Manual Profit/Loss
- Calculation, Sale & Profit Separated, Net Pricing</title>
-
- <para>You bought 100 shares of AMZN for $20 per share (including
- commissions), then later sell them all for $36 per share with a
- commission of $75. In the split transaction scheme above, NUM_SHARES is
- 100, NET_BUY_PRICE is $20 (the original buying price), NET_BUY is $2000
- (the original buying cost),
- NET_SELL_PRICE is $35.25 (($3600 - $75) / 100)), GROSS_SALE is $3600,
- NET_SALE is $3525, and finally NET_PROFIT is $1525 (NET_SALE - NET_BUY).
- </para>
-
- <table>
- <title>Selling Shares Split Scheme, Sale Transaction</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>-100</entry>
- <entry>35.25</entry>
- <entry></entry>
- <entry>3525.00</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
-
- <table>
- <title>Selling Shares Split Scheme, Gain Transaction</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>1525.00</entry>
- <entry></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>
-
- <screenshot id="invest-sellstockManProfSepNet">
- <mediaobject>
- <imageobject role="html">
- <imagedata fileref="figures/invest_sellstockManProfSepNet.png" format="PNG"
- srccredit="Chris Good" width="510px"></imagedata>
- </imageobject>
- <imageobject role="fo">
- <imagedata fileref="figures/invest_sellstockManProfSep.png" format="PNG"
- srccredit="Chris Good"></imagedata>
- </imageobject>
-
- <textobject>
- <phrase>Selling Shares Example</phrase>
- </textobject>
+ <screenshot id="invest-sellstockManProfSepNet">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/invest_sellstockManProfSepNet.png" format="PNG"
+ srccredit="Chris Good" width="510px"></imagedata>
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/invest_sellstockManProfSep.png" format="PNG"
+ srccredit="Chris Good"></imagedata>
+ </imageobject>
- <caption><para>An example of selling shares for gain where the sale and
- gain are recorded in separate transactions, in <guilabel>Transaction
- Journal</guilabel> view. You bought 100 shares of AMZN for $20 per
- share, and sold for $36.</para>
- </caption>
- </mediaobject>
- </screenshot>
+ <textobject>
+ <phrase>Selling Shares Example</phrase>
+ </textobject>
+ <caption><para>An example of selling shares for gain where the sale and
+ gain are recorded in separate transactions, in <guilabel>Transaction
+ Journal</guilabel> view. You bought 100 shares of AMZN for $20 per
+ share, and sold for $36.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
</sect3>
</sect2>
@@ -2942,7 +2919,8 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
</imageobject>
<textobject>
- <phrase>Example of Lots in Account window before lot scrubbing
+ <phrase>Example of Lots in Account window before lot
+ scrubbing
</phrase>
</textobject>
@@ -3241,10 +3219,10 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
</figure>
<note>
- <para>After using the <guilabel>Scrub Account</guilabel> button only
- the last lot is shown, so the above image is after the <guilabel>
- Lots in Account</guilabel> window has been closed and reopened so
- all the lots show.
+ <para>After using the <guilabel>Scrub Account</guilabel> button
+ only the last lot is shown, so the above image is after the
+ <guilabel>Lots in Account</guilabel> window has been closed and
+ reopened so all the lots show.
</para>
</note>
</listitem>
@@ -3255,7 +3233,8 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
</para>
<figure pgwide="1">
- <title>Selling Shares - Capital Gains - Register after Scrub Account
+ <title>Selling Shares - Capital Gains - Register after Scrub
+ Account
</title>
<screenshot id="invest2-lots3AftScrubAcct">
<mediaobject>
@@ -3269,7 +3248,8 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
</imageobject>
<textobject>
- <phrase>Example of security register after using Scrub Account
+ <phrase>Example of security register after using Scrub
+ Account
</phrase>
</textobject>
@@ -3282,9 +3262,9 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
<note>
<para>The security splits in the sell transactions have been split
- into subsplits, one subsplit per lot, and a capital gain transaction
- has been created for each security subsplit of each sell
- transaction.
+ into subsplits, one subsplit per lot, and a capital gain
+ transaction has been created for each security subsplit of each
+ sell transaction.
</para>
</note>
</listitem>
@@ -3322,7 +3302,8 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
</imageobject>
<textobject>
- <phrase>Example of security register after Scrub Account is used.
+ <phrase>Example of security register after Scrub Account is
+ used.
</phrase>
</textobject>
@@ -3374,7 +3355,8 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
</imageobject>
<textobject>
- <phrase>Example of security register after Scrub Account is used.
+ <phrase>Example of security register after Scrub Account is
+ used.
</phrase>
</textobject>
@@ -3385,9 +3367,7 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
</screenshot>
</figure>
- <para>
- The above screen shots show that scrubbing created:
- </para>
+ <para>The above screen shots show that scrubbing created:</para>
<para>2 lots. A separate lot for each buy (it essentially treats the
stock split as a buy of 100 for no cost)
commit 7a6ae3c741ba8a2f0e0be9dcce65da646b326794
Author: goodvibes2 <chris.good at ozemail.com.au>
Date: Thu Mar 2 18:49:33 2017 +1100
Bug 755174 How to handle commission when buying and selling securities
diff --git a/guide/C/ch_invest.xml b/guide/C/ch_invest.xml
index bcce28f..4504c51 100644
--- a/guide/C/ch_invest.xml
+++ b/guide/C/ch_invest.xml
@@ -942,14 +942,33 @@ Income
<sect2 id="invest-buy-stock2">
<title>Entering Preexisting Shares</title>
- <para>To register the initial 100 shares of this stock that you
- purchased previously, on the first transaction line, enter the date of
- the purchase (eg: Jan. 1 2005), a description (eg: Initial Purchase),
- transfer from <emphasis>Equity:Opening Balances</emphasis>, Shares (eg:
- 100), and Price (eg: $20). You do not need to fill in the
- <guilabel>Buy</guilabel> column, as it will be calculated for you. This example
- assumed there was no commission on this transaction to simplify the example. Your
- AMZN Commodity view should now appear like this:</para>
+ <para>
+ The examples in this section use <guilabel>Transaction Journal
+ </guilabel> view.
+ </para>
+
+ <para>To register the initial 100 shares of this stock that you purchased
+ previously, on the first (transaction) line, enter the date of the
+ purchase (eg: Jan. 1 2005) and <guilabel>Description</guilabel> (eg:
+ Opening Balance). On the first split line, enter 100 in <guilabel>Shares
+ </guilabel>, delete the (unit) <guilabel>Price</guilabel> (it will be
+ calculated when you <keycap>Tab</keycap> out of the split) and enter
+ 2000 in the <guilabel>Buy</guilabel> column.
+ </para>
+
+ <note>
+ <para>It is also possible to use <application>&app;</application> to
+ calculate <guilabel>Shares</guilabel> or <guilabel>Buy</guilabel> from
+ the other 2 columns but to avoid rounding errors, it is better to
+ automaticaly calculate <guilabel>Price</guilabel>.
+ </para>
+ </note>
+
+ <para><keycap>Tab</keycap> to the second split line, enter transfer from
+ account <emphasis>Equity:Opening Balances</emphasis>. For simplicity,
+ this example assumed there were no commissions on this transaction.
+ Your AMZN Commodity view should now appear like this:
+ </para>
<screenshot id="invest-setup-portfolio1">
<mediaobject>
@@ -967,11 +986,11 @@ Income
</textobject>
<caption><para>This image is of the transaction register of the AMZN account
- after the first stock account <quote>purchase</quote>.</para></caption>
+ after the first stock <quote>purchase</quote>.</para></caption>
</mediaobject>
</screenshot>
- <para>Notice that the <guilabel>Balance</guilabel> is in the units of
+ <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) rather than $2000. This is how it should be.</para>
</sect2>
@@ -979,48 +998,167 @@ Income
<sect2 id="invest-buy-new2">
<title>Buying New Shares</title>
- <para>The only difference between setting up a new stock purchase
- versus the setup for preexisting stocks as described in the previous
- section is that instead of transferring the money used to purchase the
- stock from the <emphasis>Equity:Opening Balances</emphasis> account, you use your
- <emphasis>Assets:Bank ABC</emphasis> account.</para>
-
- <para>Now you will purchase $5000 of IBM stock, with a commission of $100. First
- step will be to create the stock account for IBM. The existing <emphasis>Expenses:Commissions</emphasis>
- account will be used. If you wish to track commissions to the individual stock
- an additional sub-account would be necessary.</para>
-
- <para>Now for the transaction, on the first transaction line, enter the date of
- the purchase (eg: Jan. 3 2005), a description (eg: Initial IBM Purchase),
- Shares will be skipped (to be calculated), Price (eg: $96.60), and Buy ($5000).
- You do not need to fill in the <guilabel>Shares</guilabel> column, as it will be
- calculated for you. The next line in the split transaction will be
- <emphasis>Expenses:Commissions</emphasis> and fill in Buy ($100).
- The third line will be to transfer from <emphasis>Assets:Bank ABC:Savings</emphasis>,
- $5100 to balance the transaction.
- Your IBM Commodity view should now appear like this:</para>
-
- <screenshot id="invest-setup-portfolio2">
- <mediaobject>
- <imageobject role="html">
- <imagedata fileref="figures/invest_SetupPortfolio2.png" format="PNG"
- srccredit="Cristian Marchi" width="510px"></imagedata>
- </imageobject>
- <imageobject role="fo">
- <imagedata fileref="figures/invest_SetupPortfolio2.png" format="PNG"
- srccredit="Cristian Marchi"></imagedata>
- </imageobject>
+ <para>The main difference between setting up a new stock purchase
+ versus the setup for preexisting stocks as described in the previous
+ section is that instead of transferring the money used to purchase the
+ stock from the <emphasis>Equity:Opening Balances</emphasis> account, you
+ transfer from your <emphasis>Assets:Bank ABC</emphasis> or <emphasis>
+ Assets:Brokerage Account</emphasis> account.
+ </para>
- <textobject>
- <phrase>Setup Current Portfolio</phrase>
- </textobject>
+ <sect3 id="invest-buy-com">
+ <title>Handling Commissions and Fees</title>
- <caption><para>This image is of the transaction register of the IBM account
- after the first stock account <quote>purchase</quote> with a commission.</para>
- </caption>
- </mediaobject>
- </screenshot>
+ <para>For conciseness, this document will refer to the money you pay to
+ a broker for buying and selling securities as <emphasis>Commissions
+ </emphasis>. Government fees may also be payable. Unless otherwise
+ stated, fees are handled in a similar way.
+ </para>
+ <para>
+ In <application>&app;</application> there are 2 alternate ways to
+ handle commissions (for simplicity this document section will refer to
+ these ways as net pricing and gross pricing):
+ </para>
+
+ <itemizedlist>
+ <listitem><para><emphasis>Net Pricing:</emphasis> You enter a net
+ price (adjusted by commissions) when buying and selling
+ securities. You do <emphasis>not</emphasis> also record commissions
+ in a specific commissions account in order to later claim it as an
+ expense, as this would be claiming commissions twice. This way
+ <emphasis>is</emphasis> compatible with using
+ <xref linkend="invest-sellLots"></xref>. This results in a
+ slightly misleading price being added to the price database (the
+ effective price you paid) but is not usually of any concern.</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>OR</para>
+
+ <itemizedlist>
+ <listitem><para><emphasis>Gross Pricing:</emphasis> You enter the
+ price not adjusted by commissions and enter the commissions expense
+ on a separate split in the transaction. This enables the tracking of
+ commissions but is <emphasis>not</emphasis> compatible with using
+ <xref linkend="invest-sellLots"></xref>. Scrubbing doesn't know to
+ deduct commissions and fees from the gains, so capital gains or
+ losses must be manually calculated (see
+ <xref linkend="invest-sell-man"></xref>).</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>Please get professional advice if you are unsure which of these
+ ways are applicable to your jurisdiction.
+ </para>
+ </sect3>
+
+ <sect3 id="invest-buy-gross">
+ <title>Example: Buying Shares with Gross Pricing</title>
+
+ <para>In this example you will purchase $5000 of IBM stock, with a
+ commission of $100. First step will be to create the stock account for
+ IBM. The existing <emphasis>Expenses:Commission</emphasis>
+ account will be used. If you wish to track commissions to the
+ individual stock level an additional sub-account would be necessary.
+ E.g. <emphasis>Expenses:Commission:IBM</emphasis>.
+ </para>
+
+ <para>Now for the transaction, on the first (transaction) line, enter
+ the <guilabel>Date</guilabel> of the purchase (eg: Jan. 3 2005) and
+ <guilabel>Description</guilabel> (eg: Initial IBM Purchase). On the
+ first split line, enter 50 in <guilabel>Shares</guilabel>, delete
+ <guilabel>Price</guilabel> (leave it empty so it will be calculated)),
+ and enter 5000 in <guilabel>Buy</guilabel>. You do not need to fill in the
+ <guilabel>Price</guilabel> 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:Commissions</emphasis> and fill in <guilabel>Buy</guilabel>
+ ($100). The third line will be to transfer $5100 from account <emphasis>
+ Assets:Bank ABC</emphasis> to balance the transaction. Your IBM
+ Commodity view should now appear like this:</para>
+
+ <screenshot id="invest-setup-portfolio2">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/invest_SetupPortfolio2.png" format="PNG"
+ srccredit="Chris Good" width="510px"></imagedata>
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/invest_SetupPortfolio2.png" format="PNG"
+ srccredit="Chris Good"></imagedata>
+ </imageobject>
+
+ <textobject>
+ <phrase>Setup Current Portfolio</phrase>
+ </textobject>
+
+ <caption><para>This image is of the transaction register of the IBM
+ account after the first stock <quote>purchase</quote> with a
+ commission.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </sect3>
+
+ <sect3 id="invest-buy-net">
+ <title>Example: Buying Shares with Net Pricing</title>
+
+ <para>Repeating the previous example using Net Pricing instead of Gross
+ Pricing, in Transaction Journal view:
+ </para>
+
+ <para>Purchase $5000 of IBM stock being 50 Shares for $100.00 each, plus
+ a commission of $100.</para>
+
+ <para>Now for the transaction, on the first (transaction) line, enter
+ the <guilabel>Date</guilabel> of the purchase (eg: Jan. 3 2005) and a
+ <guilabel>Description</guilabel> (eg: Initial IBM Purchase). On the
+ first split line, optionally enter more details in <guilabel>Memo
+ </guilabel>, then 50 in <guilabel>Shares</guilabel>, delete
+ anything in <guilabel>Price</guilabel> (so it will be calculated by
+ dividing <guilabel>Buy</guilabel> by <guilabel>Shares</guilabel> when
+ you <keycap>Tab</keycap> out of the split), 5100 in <guilabel>Buy
+ </guilabel> (50 * $100.00 + $100). Alternatively use
+ <application>&app;</application> to calculate <guilabel>Buy</guilabel>
+ by entering the formula <emphasis>5000+100</emphasis> or <emphasis>
+ (50 * 100) + 100 </emphasis> in <guilabel>Buy</guilabel> (
+ <guilabel>Buy</guilabel> will be calculated when you <keycap>Tab
+ </keycap> out of the column. Use the <keycap>Tab</keycap> key as many
+ times as needed to proceed to the next split.
+ </para>
+
+ <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 transfer from <emphasis>Assets:Bank ABC
+ </emphasis> $5100 to balance the transaction. After the splits are all
+ correct, use the <keycap function="enter" >Enter</keycap> key to save
+ the transaction. Your IBM Commodity view should now appear like this:
+ </para>
+
+ <screenshot id="invest-setup-portfolio3">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/invest_SetupPortfolio3.png" format="PNG"
+ srccredit="Chris Good" width="510px"></imagedata>
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/invest_SetupPortfolio3.png" format="PNG"
+ srccredit="Chris Good"></imagedata>
+ </imageobject>
+
+ <textobject>
+ <phrase>Setup Current Portfolio</phrase>
+ </textobject>
+
+ <caption><para>This image is of the transaction register of the IBM
+ account after the first stock <quote>purchase</quote> with a
+ commission.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </sect3>
</sect2>
</sect1>
@@ -1403,143 +1541,466 @@ Income
<sect1 id="invest-sell1">
<title>Selling Shares</title>
- <para>Entering an investment you are selling is done in the same way as
- buying one (see <xref linkend="invest-buy-new2" />) except the total cost
- of the transaction is entered in the
- <emphasis>Sell</emphasis> column and the <emphasis>Shares</emphasis>
- column is entered as a negative amount. The net proceeds from the sale
- should be transferred from the stock account to your bank or brokerage
- account.</para>
-
- <para>The proper recording of the stock sale *must* be done using a split
- transaction. In the split transaction, you must account for the profit (or
- loss) as coming from an <emphasis>Income:Capital Gains</emphasis> account
- (or <emphasis>Expenses:Capital Loss</emphasis>). To balance this income,
- you will need to enter the stock asset
- twice in the split. Once to record the actual sale (using the correct
- number of shares and correct price per share) and once to balance the
- income profit (setting the number of shares to 0 and price per share to
- 0).</para>
-
- <note>
- <para>In order to get <application>&app;</application> to commit this
- zero-share, zero-price split to the transaction, you *must*
- <keycap>Tab</keycap> out of the split. If you use the
- <keycap function="enter">Enter</keycap> key, <application>&app;</application>
- will convert the split into shares of the commodity.</para>
- </note>
-
- <para>In the split transaction scheme presented below, the symbol
- NUM_SHARES is the number of shares you are selling, SELL_PRICE is the
- price for which you sold the shares, GROSS_SALE is the total price for
- which you sold shares, equal to NUM_SHARES*SELL_PRICE. PROFIT is the
- amount of money you made on the sale. COMMISSIONS are the brokerage
- commissions. NET_SALE is the net amount of money received from the sale,
- equal to GROSS_SALE - COMMISSIONS.</para>
-
- <table>
- <title>Selling Stock using Split Transaction Scheme</title>
-
- <tgroup cols="5">
- <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>
- <row>
- <entry><emphasis>Account</emphasis></entry>
+ <para>Entering an investment sale transaction is done in a similar way to
+ entering a buy transaction (see <xref linkend="invest-buy-new2" />) except
+ the amount entered in the <emphasis>Shares</emphasis> column is negative
+ and the proceeds of the transaction is entered in the <emphasis>Sell
+ </emphasis> column. The net proceeds from the sale should be
+ transferred from the shares account to your bank or brokerage account.
+ </para>
- <entry><emphasis>Number of Shares</emphasis></entry>
+ <para>For information on handling <emphasis>commissions</emphasis> and the
+ use of <emphasis>Net Pricing</emphasis> or <emphasis>Gross Pricing</emphasis>,
+ please see <xref linkend="invest-buy-com" />.
+ </para>
- <entry><emphasis>Share Price</emphasis></entry>
+ <para>If you will be recording a capital gain or loss on the sale, please
+ see <xref linkend="chapter_capgain" /> and <xref linkend="chapter_dep" />
+ for more information on this topic.
+ </para>
- <entry><emphasis>Total Buy</emphasis></entry>
+ <para>To use the <application>&app;</application><emphasis> Automatic
+ Calculation of Capital Gain or Loss Using Lots</emphasis> feature, please
+ see <xref linkend="invest-sellLots" /> otherwise continue to the next
+ section.
+ </para>
- <entry><emphasis>Total Sell</emphasis></entry>
- </row>
+ <sect2 id="invest-sell-man">
+ <title>Selling Shares with Manual Calculation of Capital Gain or Loss
+ </title>
- <row>
- <entry>Assets:Bank ABC</entry>
-
- <entry></entry>
+ <note>
+ <para>In order for <application>&app;</application> to commit the
+ zero-share, zero-price split for account <emphasis>Assets:Stock:SYMBOL
+ </emphasis> to the transaction in the following schemes, you *must*
+ <keycap>Tab</keycap> out of that split. If you use the
+ <keycap function="enter">Enter</keycap> key, <application>&app;
+ </application> will convert the split into shares of the commodity.
+ </para>
+ </note>
- <entry></entry>
+ <para>In the schemes of transaction splits presented below, the
+ following symbols are used:
+ </para>
- <entry>NET_SALE</entry>
+ <itemizedlist>
+ <listitem><para>NUM_SHARES: number of shares you are selling</para>
+ </listitem>
- <entry></entry>
- </row>
+ <listitem><para>COMMISSION: brokerage commissions or fees</para>
+ </listitem>
- <row>
- <entry>Assets:Stock:SYMBOL</entry>
+ <listitem><para>GROSS_SELL_PRICE: unit price for which you sold the
+ shares, not reduced by COMMISSION</para>
+ </listitem>
- <entry>0</entry>
+ <listitem>
+ <para>NET_SELL_PRICE: unit price for which you sold the shares,
+ reduced by COMMISSION</para>
+ </listitem>
- <entry>0</entry>
+ <listitem>
+ <para>GROSS_BUY_PRICE: unit price for which you bought the shares,
+ not increased by COMMISSION</para>
+ </listitem>
- <entry>PROFIT</entry>
+ <listitem>
+ <para>NET_BUY_PRICE: unit price for which you bought the shares,
+ increased by COMMISSION</para>
+ </listitem>
- <entry>(Loss)</entry>
- </row>
+ <listitem><para>GROSS_BUY: total price for which you bought shares,
+ excluding COMMISSION, equal to NUM_SHARES * GROSS_BUY_PRICE</para>
+ </listitem>
- <row>
- <entry>Expenses:Commissions</entry>
+ <listitem>
+ <para>NET_BUY: amount of money for which you bought shares
+ including COMMISSION, equal to GROSS_BUY + COMMISSION.</para>
+ </listitem>
- <entry></entry>
+ <listitem><para>GROSS_SALE: total price for which you sold shares,
+ equal to NUM_SHARES * GROSS_SELL_PRICE</para>
+ </listitem>
- <entry></entry>
+ <listitem>
+ <para>NET_SALE: amount of money received from the sale, equal to
+ GROSS_SALE - COMMISSION</para>
+ </listitem>
- <entry>COMMISSION</entry>
+ <listitem>
+ <para>GROSS_PROFIT: amount of money you made on the sale, not
+ reduced by COMMISSION</para>
+ </listitem>
- <entry></entry>
- </row>
+ <listitem>
+ <para>NET_PROFIT: amount of money you made on the sale, reduced by
+ COMMISSION</para>
+ </listitem>
+ </itemizedlist>
- <row>
- <entry>Assets:Stock:SYMBOL</entry>
+ <para>There are 2 ways of manually recording the capital gain or loss.
+ The capital gain/loss can be combined with the sale in one transaction
+ or it can be entered in a separate transaction.
- <entry>-NUM_SHARES</entry>
+ </para>
- <entry>SELL_PRICE</entry>
+ <sect3 id="invest-sell-man-comb">
+ <title>Combine the Sale and Capital Gain/Loss in One Transaction</title>
- <entry></entry>
+ <para>This has the advantage that all parts of the sale event are kept
+ together. This is <emphasis>not</emphasis> compatible with using
+ <emphasis>scrubbing</emphasis>
+ (see <xref linkend="invest-sellLots" />). If you may in future use
+ scrubbing on a specific security, save some work later by entering the
+ capital gain/loss splits in a separate transaction now.
+ </para>
- <entry>GROSS_SALE</entry>
- </row>
+ <para>When the capital gain/loss splits are combined with the sale
+ splits in one transaction, there are 2 splits for the security
+ account in the same transaction, so the transaction must be entered
+ with the security register in <guilabel> Auto-Split Ledger</guilabel>
+ or <guilabel>Transaction Journal</guilabel> view. One of the splits
+ for the security account is for the sale and the other is for the
+ capital gain or loss. The security account split for the capital gain
+ or loss must be entered with 0 number of shares and 0 price per share
+ to stop the automatic recalculation of these fields.
+ </para>
- <row>
- <entry>Income:Capital Gains</entry>
+ <para>
+ Account for the profit or loss as coming from an
+ <emphasis>Income:Capital Gains</emphasis> or
+ <emphasis>Expenses:Capital Loss</emphasis> account.
+ </para>
- <entry></entry>
+ <sect4 id="invest-sell-man-comb-gr">
+ <title>Combined, Gross Pricing</title>
+
+ <table>
+ <title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are
+ Combined, Gross Pricing</title>
+
+ <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*"/>
+ <tbody>
+ <row>
+ <entry><emphasis>Account</emphasis></entry>
+ <entry><emphasis>Number of Shares</emphasis></entry>
+ <entry><emphasis>Share Price</emphasis></entry>
+ <entry><emphasis>Total Buy</emphasis></entry>
+ <entry><emphasis>Total Sell</emphasis></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Bank ABC</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>NET_SALE</entry>
+ <entry></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Stock:SYMBOL</entry>
+ <entry>0</entry>
+ <entry>0</entry>
+ <entry>GROSS_PROFIT</entry>
+ <entry>(Loss)</entry>
+ </row>
+
+ <row>
+ <entry>Expenses:Commission</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>COMMISSION</entry>
+ <entry></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Stock:SYMBOL</entry>
+ <entry>-NUM_SHARES</entry>
+ <entry>GROSS_SELL_PRICE</entry>
+ <entry></entry>
+ <entry>GROSS_SALE</entry>
+ </row>
+
+ <row>
+ <entry>Income:Capital Gains</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>(Loss)</entry>
+ <entry>GROSS_PROFIT</entry>
+ </row>
+
+ </tbody>
+ </tgroup>
+ </table>
+ </sect4>
+
+ <sect4 id="invest-sell-man-comb-net">
+ <title>Combined, Net Pricing</title>
+
+ <table>
+ <title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are
+ Combined, Net Pricing</title>
+
+ <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*"/>
+ <tbody>
+ <row>
+ <entry><emphasis>Account</emphasis></entry>
+ <entry><emphasis>Number of Shares</emphasis></entry>
+ <entry><emphasis>Share Price</emphasis></entry>
+ <entry><emphasis>Total Buy</emphasis></entry>
+ <entry><emphasis>Total Sell</emphasis></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Bank ABC</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>NET_SALE</entry>
+ <entry></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Stock:SYMBOL</entry>
+ <entry>0</entry>
+ <entry>0</entry>
+ <entry>NET_PROFIT</entry>
+ <entry>(Loss)</entry>
+ </row>
+
+ <row>
+ <entry>Assets:Stock:SYMBOL</entry>
+ <entry>-NUM_SHARES</entry>
+ <entry>NET_SELL_PRICE</entry>
+ <entry></entry>
+ <entry>NET_SALE</entry>
+ </row>
+
+ <row>
+ <entry>Income:Capital Gain</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>(Loss)</entry>
+ <entry>NET_PROFIT</entry>
+ </row>
+
+ </tbody>
+ </tgroup>
+ </table>
+ </sect4>
+ </sect3>
- <entry></entry>
+ <sect3 id="invest-sell-man-sep">
+ <title>Separate the Capital Gain/Loss Transaction from the Sale
+ Transaction.</title>
- <entry>(Loss)</entry>
+ <para>This is <emphasis>required</emphasis> if using <emphasis>scrubbing
+ </emphasis> to automatically calculate and create capital gain/loss
+ transactions (otherwise scrubbing will not detect them and will create
+ an incorrectly valued gain/loss transaction).
+ </para>
- <entry>PROFIT</entry>
- </row>
+ <sect4 id="invest-sell-man-sep-gr">
+ <title>Separated, Gross Pricing</title>
+
+ <table>
+ <title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are
+ Separate Transactions, Sale Transaction</title>
+
+ <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*"/>
+ <tbody>
+ <row>
+ <entry><emphasis>Account</emphasis></entry>
+ <entry><emphasis>Number of Shares</emphasis></entry>
+ <entry><emphasis>Share Price</emphasis></entry>
+ <entry><emphasis>Total Buy</emphasis></entry>
+ <entry><emphasis>Total Sell</emphasis></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Bank ABC</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>NET_SALE</entry>
+ <entry></entry>
+ </row>
+
+ <row>
+ <entry>Expenses:Commission</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>COMMISSION</entry>
+ <entry></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Stock:SYMBOL</entry>
+ <entry>-NUM_SHARES</entry>
+ <entry>GROSS_SELL_PRICE</entry>
+ <entry></entry>
+ <entry>GROSS_SALE</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+
+ <table>
+ <title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are
+ Separate Transactions, Capital Gain/Loss Transaction</title>
+
+ <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*"/>
+ <tbody>
+ <row>
+ <entry><emphasis>Account</emphasis></entry>
+ <entry><emphasis>Number of Shares</emphasis></entry>
+ <entry><emphasis>Share Price</emphasis></entry>
+ <entry><emphasis>Total Buy</emphasis></entry>
+ <entry><emphasis>Total Sell</emphasis></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Stock:SYMBOL</entry>
+ <entry>0</entry>
+ <entry>0</entry>
+ <entry>GROSS_PROFIT</entry>
+ <entry>(Loss)</entry>
+ </row>
+
+ <row>
+ <entry>Income:Capital Gain</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>(Loss)</entry>
+ <entry>GROSS_PROFIT</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </sect4>
+
+ <sect4 id="invest-sell-man-sep-net">
+ <title>Separated, Net Pricing</title>
+
+ <table>
+ <title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are
+ Separate Transactions, Sale Transaction</title>
+
+ <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*"/>
+ <tbody>
+ <row>
+ <entry><emphasis>Account</emphasis></entry>
+ <entry><emphasis>Number of Shares</emphasis></entry>
+ <entry><emphasis>Share Price</emphasis></entry>
+ <entry><emphasis>Total Buy</emphasis></entry>
+ <entry><emphasis>Total Sell</emphasis></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Bank ABC</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>NET_SALE</entry>
+ <entry></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Stock:SYMBOL</entry>
+ <entry>-NUM_SHARES</entry>
+ <entry>NET_SELL_PRICE</entry>
+ <entry></entry>
+ <entry>NET_SALE</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+
+ <table>
+ <title>Selling Shares Split Scheme, Sale and Capital Gain/Loss Are
+ Separate Transactions, Capital Gain/Loss Transaction</title>
+
+ <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*"/>
+ <tbody>
+ <row>
+ <entry><emphasis>Account</emphasis></entry>
+ <entry><emphasis>Number of Shares</emphasis></entry>
+ <entry><emphasis>Share Price</emphasis></entry>
+ <entry><emphasis>Total Buy</emphasis></entry>
+ <entry><emphasis>Total Sell</emphasis></entry>
+ </row>
+
+ <row>
+ <entry>Assets:Stock:SYMBOL</entry>
+ <entry>0</entry>
+ <entry>0</entry>
+ <entry>NET_PROFIT</entry>
+ <entry>(Loss)</entry>
+ </row>
+
+ <row>
+ <entry>Income:Capital Gain</entry>
+ <entry></entry>
+ <entry></entry>
+ <entry>(Loss)</entry>
+ <entry>NET_PROFIT</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </sect4>
+ </sect3>
+ </sect2>
- </tbody>
- </tgroup>
- </table>
+ <sect2 id="invest-sell-man-examples">
+ <title>Examples of Selling Shares with Manually Entry of Capital Gain or
+ Loss</title>
- <para>If you will be recording the sale of the stock as a capital gain (or
- loss), please see <xref linkend="chapter_capgain" /> and <xref linkend="chapter_dep" />
- for more information on this topic.</para>
+ <para>In these examples we will use the AMZN account created in the
+ previous section.
+ </para>
- <sect2 id="invest-sellexample2">
- <title>Example - Sale of stock with profit</title>
+ <sect3 id="invest-sell-man-prof-comb-gross">
+ <title>Example: Sale of Shares with Profit, Manual Profit/Loss
+ Calculation, Sale & Profit Combined, Gross Pricing</title>
- <para>As an example we will use the AMZN account created in the previous section.
- So you bought 100 shares of AMZN for $20 per
- share, then later sell them all for $36 per share with a commission of $75. In the split
- transaction scheme above, PRICEBUY is $20 (the original buying price),
- NUM_SHARES is 100, TOTALBUY is $2000 (the original buying cost),
- GROSS_SALE is $3600, and finally PROFIT is $1525
- (GROSS_SALE-TOTALBUY-COMMISSION).</para>
+ <para>In this example you bought 100 shares of AMZN for $20 per share,
+ then later sell them all for $36 per share with a commission of $75. In
+ the split transaction scheme above, GROSS_BUY_PRICE is $20 (the original
+ buying price), NUM_SHARES is 100, GROSS_BUY is $2000 (the original
+ buying cost), GROSS_SALE is $3600, and finally GROSS_PROFIT is $1600
+ (GROSS_SALE-GROSS_BUY).</para>
<table>
- <title>Selling Stock Split Transaction Scheme</title>
+ <title>Selling Shares Split Scheme, Sale & Gain Combined, Gross
+ Pricing</title>
<?dbfo table-width="70%" ?>
@@ -1587,7 +2048,7 @@ Income
</row>
<row>
- <entry>Expenses:Commissions</entry>
+ <entry>Expenses:Commission</entry>
<entry></entry>
@@ -1611,7 +2072,7 @@ Income
</row>
<row>
- <entry>Income:Cap Gain (Long):AMZN</entry>
+ <entry>Income:Capital Gain (Long Term):AMZN</entry>
<entry></entry>
@@ -1625,60 +2086,78 @@ Income
</tgroup>
</table>
- <screenshot id="invest-sellstock">
+ <screenshot id="invest-sellstockManProfComb">
<mediaobject>
<imageobject role="html">
<imagedata fileref="figures/invest_sellstock.png" format="PNG"
- srccredit="Cristian Marchi" width="510px"></imagedata>
+ srccredit="Chris Good" width="510px"></imagedata>
</imageobject>
<imageobject role="fo">
<imagedata fileref="figures/invest_sellstock.png" format="PNG"
- srccredit="Cristian Marchi"></imagedata>
+ srccredit="Chris Good"></imagedata>
</imageobject>
<textobject>
- <phrase>Selling Stock Example</phrase>
+ <phrase>Selling Shares Example</phrase>
</textobject>
- <caption><para>An example of selling stock for gain. You bought 100
- shares of AMZN for $20 per share, and sold for $36.</para></caption>
+ <caption><para>An example of selling shares for gain. You bought 100
+ shares of AMZN for $20 per share, and sold for $36.</para>
+ </caption>
</mediaobject>
</screenshot>
- <screenshot id="invest-sellstock2">
+ <note><para>In the above screenshot, it appears there are 2 transactions
+ for Mar 21st 2006. This is because the register is in <guilabel>
+ Auto-Split Ledger</guilabel> view and there are 2 splits for the
+ register account in the 1 transaction. <guilabel>Transaction Journal
+ </guilabel> view may be clearer. Refer to
+ <xref linkend="txns-registers-txntypes" />. 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>Basic Ledger</guilabel> view.</para>
+ </note>
+
+ <para> </para>
+
+ <screenshot id="invest-sellstockManProfComb2">
<mediaobject>
<imageobject role="html">
<imagedata fileref="figures/invest_sellstock2.png" format="PNG"
- srccredit="Cristian Marchi" width="510px"></imagedata>
+ srccredit="Chris Good" width="510px"></imagedata>
</imageobject>
<imageobject role="fo">
<imagedata fileref="figures/invest_sellstock2.png" format="PNG"
- srccredit="Cristian Marchi"></imagedata>
+ srccredit="Chris Good"></imagedata>
</imageobject>
<textobject>
- <phrase>Selling Stock Example</phrase>
+ <phrase>Selling Shares Example</phrase>
</textobject>
<caption><para>An image of the account tree after the example of
- selling stock for gain. </para></caption>
+ selling shares for gain. </para></caption>
</mediaobject>
</screenshot>
- </sect2>
-
- <sect2 id="invest-sellexampleloss">
- <title>Example - Sale of stock with loss</title>
+ </sect3>
- <para>As an example we will use the IBM account created in the previous section.
- You then have bought 51.7598 shares of IBM for $96.6001
- per share, then later sell them all for $90 per share. In the split
- transaction scheme below, PRICEBUY is $96.6001 (the original buying price),
- NUM_SHARES is 51.7598, TOTAL_BUY is $5,000 (the original buying price),
- (Loss) is $341.62, and finally GROSS_SALE is $4658.38. Assume the commission
- was $100.00.</para>
+ <sect3 id="invest-sell-man-prof-comb-net">
+ <title>Example: Sale of Shares with Profit, Manual Profit/Loss
+ Calculation, Sale & Profit Combined, Net Pricing</title>
+
+ <para>In this example you bought 100 shares of AMZN for $20 per share
+ (including commissions), then later sell them all for $36 per share with
+ a commission of $75. In the split transaction scheme above, NUM_SHARES
+ is 100, NET_BUY_PRICE is $20 (the original buying price), NET_BUY is
+ $2000 (the original buying cost), NET_SELL_PRICE is $35.25
+ (($3600 - $75) / 100)), GROSS_SALE is $3600, NET_SALE is $3525, and
+ finally NET_PROFIT is $1525 (NET_SALE - NET_BUY).
+ </para>
<table>
- <title>Selling Shares at loss Split Transaction Scheme</title>
+ <title>Selling Shares Split Scheme, Sale & Gain Combined, Net
+ Pricing</title>
<?dbfo table-width="70%" ?>
@@ -1691,131 +2170,316 @@ Income
<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>4558.38</entry>
-
+ <entry>3525.00</entry>
<entry></entry>
</row>
<row>
- <entry>Assets:Brokerage Account:Stock:IBM</entry>
-
+ <entry>Assets:Brokerage Account:Stock:AMZN</entry>
<entry>0</entry>
-
<entry>0</entry>
-
+ <entry>1525.00</entry>
<entry></entry>
-
- <entry>341.62</entry>
</row>
<row>
- <entry>Expenses:Commissions</entry>
-
+ <entry>Assets:Brokerage Account:Stock:AMZN</entry>
+ <entry>-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>100</entry>
-
<entry></entry>
+ <entry>1525.00</entry>
</row>
+ </tbody>
+ </tgroup>
+ </table>
- <row>
- <entry>Assets:Brokerage Account:Stock:IBM</entry>
+ <screenshot id="invest-sellstockManProfCombNet">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/invest_sellstockManProfCombNet.png" format="PNG"
+ srccredit="Chris Good" width="510px"></imagedata>
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/invest_sellstockManProfCombNet.png" format="PNG"
+ srccredit="Chris Good"></imagedata>
+ </imageobject>
- <entry>-51.7598</entry>
+ <textobject>
+ <phrase>Selling Shares Example</phrase>
+ </textobject>
- <entry>90.00</entry>
+ <caption><para>An example of selling shares for gain using net pricing
+ in transaction journal view. You bought 100 shares of AMZN for $20
+ per share, and sold for $36.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
- <entry></entry>
+ <para> </para>
+
+ </sect3>
+
+ <sect3 id="invest-sell-man-prof-sep-gross">
+ <title>Example: Sale of Shares with Profit, Manual Profit/Loss
+ Calculation, Sale & Profit Separated, Gross Pricing</title>
+
+ <para>You bought 100 shares of AMZN for $20 per share and commissions $20,
+ then later sell them all for $36 per share with a commission of $75. In
+ the split transaction scheme above, GROSS_BUY_PRICE is $20 (the original
+ buying price), NUM_SHARES is 100, GROSS_BUY is $2000 (the original
+ buying cost), GROSS_SALE is $3600, and finally GROSS_PROFIT is $1600
+ (GROSS_SALE-GROSS_BUY).
+ </para>
+
+ <table>
+ <title>Selling Shares Split Scheme, Sale Transaction</title>
+
+ <?dbfo table-width="70%" ?>
- <entry>4658.38</entry>
+ <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>Income:Cap Gain (Long):IBM</entry>
+ <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>-100</entry>
+ <entry>36.00</entry>
<entry></entry>
+ <entry>3600.00</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+
+ <table>
+ <title>Selling Shares Split Scheme, Gain Transaction</title>
- <entry>341.62</entry>
+ <?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>
- <note>
- <para>You may either enter the loss as a positive number in the
- <quote>buy</quote> column or as a negative number in the <quote>sell</quote>
- column, <application>&app;</application> will move the <quote>negative profit</quote>
- to the other column.</para>
- </note>
-
- <screenshot id="invest-sellstockLoss">
+ <screenshot id="invest-sellstockManProfSep">
<mediaobject>
- <imageobject role="html">
- <imagedata fileref="figures/invest_sellstockLoss.png" format="PNG"
- srccredit="Cristian Marchi" width="510px"></imagedata>
+ <imageobject role="html">
+ <imagedata fileref="figures/invest_sellstockManProfSep.png" format="PNG"
+ srccredit="Chris Good" width="510px"></imagedata>
</imageobject>
<imageobject role="fo">
- <imagedata fileref="figures/invest_sellstockLoss.png" format="PNG"
- srccredit="Cristian Marchi"></imagedata>
+ <imagedata fileref="figures/invest_sellstockManProfSep.png" format="PNG"
+ srccredit="Chris Good"></imagedata>
</imageobject>
<textobject>
- <phrase>Selling Stock at loss Example</phrase>
+ <phrase>Selling Shares Example</phrase>
</textobject>
- <caption><para>Above is a screenshot of the example of selling
- stock. You bought $5000 worth of IBM shares with a stock value of
- $96.6001, and sold for $90.</para></caption>
+ <caption><para>An example of selling shares for gain where the sale and
+ gain are recorded in separate transactions, in <guilabel>Transaction
+ Journal</guilabel> view. You bought 100 shares of AMZN for $20 per
+ share, and sold for $36.</para>
+ </caption>
</mediaobject>
</screenshot>
- <screenshot id="invest-sellstockLoss2">
+ </sect3>
+
+ <sect3 id="invest-sell-man-prof-sep-net">
+ <title>Example: Sale of Shares with Profit, Manual Profit/Loss
+ Calculation, Sale & Profit Separated, Net Pricing</title>
+
+ <para>You bought 100 shares of AMZN for $20 per share (including
+ commissions), then later sell them all for $36 per share with a
+ commission of $75. In the split transaction scheme above, NUM_SHARES is
+ 100, NET_BUY_PRICE is $20 (the original buying price), NET_BUY is $2000
+ (the original buying cost),
+ NET_SELL_PRICE is $35.25 (($3600 - $75) / 100)), GROSS_SALE is $3600,
+ NET_SALE is $3525, and finally NET_PROFIT is $1525 (NET_SALE - NET_BUY).
+ </para>
+
+ <table>
+ <title>Selling Shares Split Scheme, Sale Transaction</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>-100</entry>
+ <entry>35.25</entry>
+ <entry></entry>
+ <entry>3525.00</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+
+ <table>
+ <title>Selling Shares Split Scheme, Gain Transaction</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>1525.00</entry>
+ <entry></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>
+
+ <screenshot id="invest-sellstockManProfSepNet">
<mediaobject>
- <imageobject role="html">
- <imagedata fileref="figures/invest_sellstockLoss2.png" format="PNG"
- srccredit="Cristian Marchi" width="510px"></imagedata>
+ <imageobject role="html">
+ <imagedata fileref="figures/invest_sellstockManProfSepNet.png" format="PNG"
+ srccredit="Chris Good" width="510px"></imagedata>
</imageobject>
<imageobject role="fo">
- <imagedata fileref="figures/invest_sellstockLoss2.png" format="PNG"
- srccredit="Cristian Marchi"></imagedata>
+ <imagedata fileref="figures/invest_sellstockManProfSep.png" format="PNG"
+ srccredit="Chris Good"></imagedata>
</imageobject>
<textobject>
- <phrase>Selling Stock at loss Example</phrase>
+ <phrase>Selling Shares Example</phrase>
</textobject>
- <caption><para>An image of the account tree after the example of
- selling stock for loss. </para></caption>
+ <caption><para>An example of selling shares for gain where the sale and
+ gain are recorded in separate transactions, in <guilabel>Transaction
+ Journal</guilabel> view. You bought 100 shares of AMZN for $20 per
+ share, and sold for $36.</para>
+ </caption>
</mediaobject>
</screenshot>
+
+ </sect3>
</sect2>
<sect2 id="invest-sellLots">
- <title>Automatic Calculation of Capital Gain or Loss Using Lots</title>
+ <title>Selling Shares with Automatic Calculation of Capital Gain or Loss
+ Using Lots</title>
<sect3 id="invest-sellLotsIntro">
<title>Introduction</title>
@@ -1946,6 +2610,13 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
</para>
<orderedlist>
+ <listitem>
+ <para>Record the sale transaction using Net Pricing (but stop short
+ of entering the Capital Gain transaction as it will be created by
+ scrubbing). See <xref linkend="invest-sell-man-prof-sep-net" />.
+ </para>
+ </listitem>
+
<!-- Manual Lot Creation and Linking -->
<listitem><para><xref linkend="invest-sellManual" /> (Optional
depending on cost method)</para>
@@ -1968,7 +2639,6 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
</listitem>
</orderedlist>
-
</sect3>
<sect3 id="invest-sellManual">
@@ -2109,16 +2779,27 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
</para>
</listitem>
+ <listitem>
+ <para>
+ Scrubbing does not recognize commissions or fees so makes no
+ allowance for them in the calculation of gain or loss. Therefore
+ you must use <emphasis>Net Pricing</emphasis> rather than
+ <emphasis>Gross Pricing</emphasis> if you wish to use scrubbing.
+ See <xref linkend="invest-buy-com" />.
+ </para>
+
+ </listitem>
+
<listitem>
- <para>Scrubbing does not work correctly if there has been a previous
- sale where the capital gain splits have been manually entered as
- part of the sale transaction. Therefore ensure previous sales are
- recorded as 2 transactions:
+ <para>Scrubbing does not recognize capital gain/loss transaction
+ splits if they have been manually entered as part of the sale
+ transaction. Therefore ensure previous sales are recorded as 2
+ transactions:
</para>
<table>
- <title>Transaction 1 dealing with value received, reduction of the
- number of shares and (optionally) commission
+ <title>Transaction 1 dealing with value received and the reduction
+ of the number of shares
</title>
<tgroup cols="5">
<tbody>
@@ -2137,13 +2818,6 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
<entry></entry>
</row>
<row>
- <entry>Commission (optional)</entry>
- <entry></entry>
- <entry></entry>
- <entry>Debit</entry>
- <entry></entry>
- </row>
- <row>
<entry>Security</entry>
<entry>-NumSold</entry>
<entry>SaleUnitPrice</entry>
@@ -2197,7 +2871,7 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
</sect3>
<sect3 id="invest-sellManualExample">
- <title>Example of Manual Lot Creation and Linking</title>
+ <title>Example 1: Manual Lot Creation and Linking</title>
<para>Here is an example of selling part of a security holding using
the LIFO method. In this example, the most recent buy transaction
@@ -2363,6 +3037,40 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
</para>
</listitem>
+ <listitem>
+ <para>Close the <guilabel>Lots in Account SSSS</guilabel> window and
+ return to the security account register.
+ </para>
+
+ <figure pgwide="1">
+ <title>Selling Shares - Capital Gains - Register after manual
+ linking and scrubbing a single lot
+ </title>
+ <screenshot id="invest-lots2RegAftScrub1Lot">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/investLots2_RegAfterScrub1Lot.png"
+ format="PNG" srccredit="Chris Good" width="510px"></imagedata>
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/investLots2_RegAfterScrub1Lot.png"
+ format="PNG" srccredit="Chris Good" ></imagedata>
+ </imageobject>
+
+ <textobject>
+ <phrase>Example of Register after scrubbing a
+ single lot
+ </phrase>
+ </textobject>
+
+ <caption><para>An image of the Register after scrubbing a
+ single lot.</para>
+ </caption>
+ </mediaobject>
+ </screenshot>
+ </figure>
+ </listitem>
+
<listitem><para>Continue to
<xref linkend="invest-sellChgCapGainsAcct" /></para>
</listitem>
@@ -2370,7 +3078,7 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
</sect3>
<sect3 id="invest-sellAutoExample">
- <title>Example 1 of Automatic Creation of Capital Gain Or Loss
+ <title>Example 2: Automatic Creation of Capital Gain Or Loss
Transactions</title>
<para>Create the capital gains transaction by following these steps:
@@ -2381,8 +3089,9 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
<para>Open the security account's register.</para>
</listitem>
- <listitem><para>Ensure the sell transaction has been entered with no
- splits for capital gains or losses.</para>
+ <listitem><para>Ensure any previous manually entered capital gain/loss
+ transaction splits have been entered in separate transactions to the
+ the sell transactions.</para>
</listitem>
<listitem><para>Select <menuchoice><guimenu>Actions</guimenu>
@@ -2417,30 +3126,19 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
<listitem><para>Creates a separate transaction per lot for
capital gain/loss.</para>
-
- <note><para>
- If there are already gain/loss splits as part of a sell
- transaction, <application>&app;</application> scrubbing does
- not recognize them. So if manually adding gain/loss,
- separate gain/loss transaction splits from the transaction
- that reduces the <guilabel>No of Shares</guilabel>) by putting
- them in a separate transaction if you may use scrubbing in
- future.</para>
- </note>
</listitem>
</itemizedlist>
</listitem>
- <listitem><para>Continue with the instructions in the next section.
- </para>
+ <listitem><para>Continue to
+ <xref linkend="invest-sellChgCapGainsAcct" /></para>
</listitem>
-
</orderedlist>
</sect3>
<sect3 id="invest-sellAutoExample2">
- <title>Example 2 of Automatic Creation of Capital Gain Or Loss
- Transactions - 2 Sales at Once</title>
+ <title>Example 3: Automatic Creation of Capital Gain Or Loss
+ Transactions, 2 Sales at Once</title>
<para>Here is an example of FIFO scrubbing without manual lot creation.
In this example, the transactions for 2 sales are scrubbed at once
@@ -2599,8 +3297,8 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
</sect3>
<sect3 id="invest-sellFifoSplit">
- <title>Example 3 of Automatic Creation of Capital Gain Or Loss
- Transactions - After a Simple Stock Split</title>
+ <title>Example 4: Automatic Creation of Capital Gain Or Loss
+ Transactions - After a Simple Stock Split</title>
<para>Here is an example of FIFO scrubbing without manual lot
creation/linking, where the Stock Split Assistant has been used for a
simple stock split. In this example, 100 shares of security XYZ were
@@ -2718,7 +3416,9 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
</sect3>
<sect3 id="invest-sellChgCapGainsAcctExample">
- <title>Example of Changing the Orphaned Gains-CCC to Gain/Loss Account</title>
+ <title>
+ Example 5: Changing the Orphaned Gains-CCC to Gain/Loss Account
+ </title>
<orderedlist>
<listitem>
@@ -2733,11 +3433,11 @@ url="https://www.gnucash.org/docs/v&series-stable;/C/gnucash-help/tool-lots.html
<screenshot id="invest-lots4AftScrub1LotReg">
<mediaobject>
<imageobject role="html">
- <imagedata fileref="figures/investLots4_AfterScrub1LotReg.png"
+ <imagedata fileref="figures/investLots2_RegAfterScrub1Lot.png"
format="PNG" srccredit="Chris Good" width="510px"></imagedata>
</imageobject>
<imageobject role="fo">
- <imagedata fileref="figures/investLots4_AfterScrub1LotReg.png"
+ <imagedata fileref="figures/investLots2_RegAfterScrub1Lot.png"
format="PNG" srccredit="Chris Good" ></imagedata>
</imageobject>
diff --git a/guide/C/figures/invest2Lots0RegB4Scrub.png b/guide/C/figures/invest2Lots0RegB4Scrub.png
old mode 100755
new mode 100644
index 0c7b30e..0a0b20d
Binary files a/guide/C/figures/invest2Lots0RegB4Scrub.png and b/guide/C/figures/invest2Lots0RegB4Scrub.png differ
diff --git a/guide/C/figures/invest2Lots1B4Scrub.png b/guide/C/figures/invest2Lots1B4Scrub.png
old mode 100755
new mode 100644
index 5094d05..7289352
Binary files a/guide/C/figures/invest2Lots1B4Scrub.png and b/guide/C/figures/invest2Lots1B4Scrub.png differ
diff --git a/guide/C/figures/invest2Lots2LotsAftScrubAcct.png b/guide/C/figures/invest2Lots2LotsAftScrubAcct.png
old mode 100755
new mode 100644
index e8a89f6..86ded44
Binary files a/guide/C/figures/invest2Lots2LotsAftScrubAcct.png and b/guide/C/figures/invest2Lots2LotsAftScrubAcct.png differ
diff --git a/guide/C/figures/invest2Lots3RegAftScrubAcct.png b/guide/C/figures/invest2Lots3RegAftScrubAcct.png
old mode 100755
new mode 100644
index 6b384dd..089b524
Binary files a/guide/C/figures/invest2Lots3RegAftScrubAcct.png and b/guide/C/figures/invest2Lots3RegAftScrubAcct.png differ
diff --git a/guide/C/figures/investLots0_RegB4Scrub.png b/guide/C/figures/investLots0_RegB4Scrub.png
index ed15564..e6beb42 100644
Binary files a/guide/C/figures/investLots0_RegB4Scrub.png and b/guide/C/figures/investLots0_RegB4Scrub.png differ
diff --git a/guide/C/figures/investLots1_BeforeCreateLot.png b/guide/C/figures/investLots1_BeforeCreateLot.png
index 3b4d724..bb4f111 100644
Binary files a/guide/C/figures/investLots1_BeforeCreateLot.png and b/guide/C/figures/investLots1_BeforeCreateLot.png differ
diff --git a/guide/C/figures/investLots2_BeforeScrub1Lot.png b/guide/C/figures/investLots2_BeforeScrub1Lot.png
index 870ab3b..324d27a 100644
Binary files a/guide/C/figures/investLots2_BeforeScrub1Lot.png and b/guide/C/figures/investLots2_BeforeScrub1Lot.png differ
diff --git a/guide/C/figures/investLots2_RegAfterScrub1Lot.png b/guide/C/figures/investLots2_RegAfterScrub1Lot.png
new file mode 100644
index 0000000..39fe80e
Binary files /dev/null and b/guide/C/figures/investLots2_RegAfterScrub1Lot.png differ
diff --git a/guide/C/figures/investLots4_AfterScrub1LotReg.png b/guide/C/figures/investLots4_AfterScrub1LotReg.png
deleted file mode 100644
index 239f372..0000000
Binary files a/guide/C/figures/investLots4_AfterScrub1LotReg.png and /dev/null differ
diff --git a/guide/C/figures/invest_SetupPortfolio2.png b/guide/C/figures/invest_SetupPortfolio2.png
index 4c14790..593b2e5 100644
Binary files a/guide/C/figures/invest_SetupPortfolio2.png and b/guide/C/figures/invest_SetupPortfolio2.png differ
diff --git a/guide/C/figures/invest_SetupPortfolio3.png b/guide/C/figures/invest_SetupPortfolio3.png
new file mode 100644
index 0000000..2dde2c5
Binary files /dev/null and b/guide/C/figures/invest_SetupPortfolio3.png differ
diff --git a/guide/C/figures/invest_sellstock.png b/guide/C/figures/invest_sellstock.png
old mode 100644
new mode 100755
index 349e959..fa4b226
Binary files a/guide/C/figures/invest_sellstock.png and b/guide/C/figures/invest_sellstock.png differ
diff --git a/guide/C/figures/invest_sellstockLoss.png b/guide/C/figures/invest_sellstockLoss.png
deleted file mode 100644
index 553b1a0..0000000
Binary files a/guide/C/figures/invest_sellstockLoss.png and /dev/null differ
diff --git a/guide/C/figures/invest_sellstockManProfCombNet.png b/guide/C/figures/invest_sellstockManProfCombNet.png
new file mode 100755
index 0000000..419580c
Binary files /dev/null and b/guide/C/figures/invest_sellstockManProfCombNet.png differ
diff --git a/guide/C/figures/invest_sellstockManProfSep.png b/guide/C/figures/invest_sellstockManProfSep.png
new file mode 100644
index 0000000..7d9148c
Binary files /dev/null and b/guide/C/figures/invest_sellstockManProfSep.png differ
diff --git a/guide/C/figures/invest_sellstockManProfSepNet.png b/guide/C/figures/invest_sellstockManProfSepNet.png
new file mode 100644
index 0000000..da05849
Binary files /dev/null and b/guide/C/figures/invest_sellstockManProfSepNet.png differ
diff --git a/guide/C/figures/invest_setup_portfolio1.png b/guide/C/figures/invest_setup_portfolio1.png
index 8110d13..e3a272a 100644
Binary files a/guide/C/figures/invest_setup_portfolio1.png and b/guide/C/figures/invest_setup_portfolio1.png differ
Summary of changes:
guide/C/ch_invest.xml | 1642 ++++++++++++++------
guide/C/ch_txns.xml | 6 +-
guide/C/figures/invest2Lots0RegB4Scrub.png | Bin 153215 -> 138901 bytes
guide/C/figures/invest2Lots1B4Scrub.png | Bin 63653 -> 63985 bytes
guide/C/figures/invest2Lots2LotsAftScrubAcct.png | Bin 63551 -> 58682 bytes
guide/C/figures/invest2Lots3RegAftScrubAcct.png | Bin 154625 -> 198159 bytes
guide/C/figures/investLots0_RegB4Scrub.png | Bin 120185 -> 115222 bytes
guide/C/figures/investLots1_BeforeCreateLot.png | Bin 59928 -> 58772 bytes
guide/C/figures/investLots2_BeforeScrub1Lot.png | Bin 56576 -> 53431 bytes
guide/C/figures/investLots2_RegAfterScrub1Lot.png | Bin 0 -> 126927 bytes
guide/C/figures/investLots4_AfterScrub1LotReg.png | Bin 132253 -> 0 bytes
guide/C/figures/invest_SetupPortfolio2.png | Bin 68512 -> 58991 bytes
guide/C/figures/invest_SetupPortfolio3.png | Bin 0 -> 58091 bytes
guide/C/figures/invest_sellstock.png | Bin 88340 -> 87730 bytes
guide/C/figures/invest_sellstockLoss.png | Bin 89444 -> 0 bytes
guide/C/figures/invest_sellstockManProfCombNet.png | Bin 0 -> 87817 bytes
guide/C/figures/invest_sellstockManProfSep.png | Bin 0 -> 98537 bytes
guide/C/figures/invest_sellstockManProfSepNet.png | Bin 0 -> 91947 bytes
guide/C/figures/invest_setup_portfolio1.png | Bin 64710 -> 56205 bytes
help/C/Help_ch_GUIMenus.xml | 12 +-
help/C/Help_ch_Transactions.xml | 46 +-
21 files changed, 1178 insertions(+), 528 deletions(-)
mode change 100755 => 100644 guide/C/figures/invest2Lots0RegB4Scrub.png
mode change 100755 => 100644 guide/C/figures/invest2Lots1B4Scrub.png
mode change 100755 => 100644 guide/C/figures/invest2Lots2LotsAftScrubAcct.png
mode change 100755 => 100644 guide/C/figures/invest2Lots3RegAftScrubAcct.png
create mode 100644 guide/C/figures/investLots2_RegAfterScrub1Lot.png
delete mode 100644 guide/C/figures/investLots4_AfterScrub1LotReg.png
create mode 100644 guide/C/figures/invest_SetupPortfolio3.png
mode change 100644 => 100755 guide/C/figures/invest_sellstock.png
delete mode 100644 guide/C/figures/invest_sellstockLoss.png
create mode 100755 guide/C/figures/invest_sellstockManProfCombNet.png
create mode 100644 guide/C/figures/invest_sellstockManProfSep.png
create mode 100644 guide/C/figures/invest_sellstockManProfSepNet.png
More information about the gnucash-changes
mailing list