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