r19736 - gnucash-docs/branches/2.2/guide/C - Backport r19735: Bug #621573

[Yawar Amin]

Author: yawaramin
Date: 2010-10-30 23:37:19 -0400 (Sat, 30 Oct 2010)
New Revision: 19736
Trac: http://svn.gnucash.org/trac/changeset/19736

Modified:
   gnucash-docs/branches/2.2/guide/C/ch_txns.xml
Log:
Backport r19735: Bug #621573

Simplify explanation of entering a split transaction and remove comment
about register bug (no longer applicable). Separate the explanation into
paragraphs covering the mechanics, the specific example, and the outcome.
Also, refer to the screenshot through a DocBook xref tag for general
portability, and remove the redundant screenshot caption.

Modified: gnucash-docs/branches/2.2/guide/C/ch_txns.xml
===================================================================
--- gnucash-docs/branches/2.2/guide/C/ch_txns.xml	2010-10-31 03:34:11 UTC (rev 19735)
+++ gnucash-docs/branches/2.2/guide/C/ch_txns.xml	2010-10-31 03:37:19 UTC (rev 19736)
@@ -130,38 +130,48 @@
       <guilabel>Assets:Checking</guilabel> and
       <guilabel>Income:Salary</guilabel>.</para>
 
-      <para>To add a paycheck transaction from the
-      <guilabel>Assets:Checking</guilabel> account register window, click on a
-      new transaction line, and click on <guilabel>Split</guilabel>. First
-      enter the description of this transaction on the first line (eg:
-      "Employers R Us"). In the "split" line below this, enter the deposit
-      into <guilabel>Assets:Checking</guilabel> (eg:$670) (This is due to a
-      current bug, that demands the first line in a split is the actual
-      account). Follow this with the various tax deposits
-      (<guilabel>Assets:Checking</guilabel> (eg: $670),
-      <guilabel>Expenses:Taxes:Federal</guilabel> (eg: $180),
-      <guilabel>Expenses:Taxes:Medicare</guilabel> (eg: $90), and
-      <guilabel>Expenses:Taxes:Social Security</guilabel> (eg: $60)) and
-      lastly the gross total of your paycheck (eg: $1000) as a withdrawal
-      transfer from <guilabel>Income:Salary</guilabel>. The final split should
-      look like this:</para>
+      <para>To add the paycheck split transaction from the
+      <guilabel>Assets:Checking</guilabel> account register window, click
+      on a new transaction line and click <guilabel>Split</guilabel>. Enter
+      the description of this transaction on the first line (e.g.
+      <quote>Employers R Us</quote>). In the split line below this, enter
+      the various splits that make up this transaction, one by one. To
+      enter the splits, first choose the account, then enter the amount by
+      which to change the account. Then click the next split line and
+      repeat the process.</para>
 
-      <screenshot id="txns-register-multiaccount">
+      <para>In this example, choose the deposit account
+      (<guilabel>Assets:Checking</guilabel>) and then enter the amount that
+      is being deposited into it (e.g. $670). Follow this by entering the
+      amounts for the various taxes:
+      <guilabel>Expenses:Taxes:Federal</guilabel>, $180;
+      <guilabel>Expenses:Taxes:Medicare</guilabel>, $90; and
+      <guilabel>Expenses:Taxes:Social Security</guilabel>, $60. Finally,
+      enter the gross total of your paycheck ($1,000 in this example) as a
+      withdrawal transfer from <guilabel>Income:Salary</guilabel>.</para>
+
+      <para>The final split should look like <xref
+      linkend="txns-register-multiaccount"/>. Remember to press <keycap
+      function="enter">Enter</keycap> after finishing the entry. But you
+      should also know that when you press <keycap
+      function="enter">Enter</keycap>, the split view will be
+      <quote>folded</quote> back into a simplified transaction view. The
+      splits are still there; you just have to click
+      <guilabel>Split</guilabel> to view them. See <xref
+      linkend="txns-registers-features2"/> for details.</para>
+
+      <figure id="txns-register-multiaccount">
+        <title>Entering a split transaction</title>
         <mediaobject>
           <imageobject>
             <imagedata fileref="figures/txns_register_multiaccount.png"
                        format="PNG" srccredit="Bengt Thuree" />
           </imageobject>
-
           <textobject>
             <phrase>Account Register - Split Transaction</phrase>
           </textobject>
-
-          <caption><para>This image shows <guilabel>Assets:Checking -
-          Register</guilabel> after adding a split transaction for
-          salary.</para></caption>
         </mediaobject>
-      </screenshot>
+      </figure>
     </sect2>
 
     <sect2 id="txns-registers-features2">