[Gnucash-changes] r14172 - gnucash-docs/trunk - update docs for release

Chris Lyttle wilddev at cvs.gnucash.org
Wed May 24 01:08:55 EDT 2006


Author: wilddev
Date: 2006-05-24 01:08:42 -0400 (Wed, 24 May 2006)
New Revision: 14172
Trac: http://svn.gnucash.org/trac/changeset/14172

Added:
   gnucash-docs/trunk/guide/C/figures/currency_PutTogether_AfterStocks.png
   gnucash-docs/trunk/guide/C/figures/invest_merge2.png
   gnucash-docs/trunk/guide/C/figures/invest_merge3.png
   gnucash-docs/trunk/guide/C/figures/invest_simplesplit1.png
   gnucash-docs/trunk/guide/C/figures/invest_split1.png
   gnucash-docs/trunk/guide/C/figures/invest_split2.png
   gnucash-docs/trunk/guide/C/figures/invest_split3.png
   gnucash-docs/trunk/guide/C/figures/invest_split4.png
   gnucash-docs/trunk/guide/C/figures/invest_split5.png
   gnucash-docs/trunk/guide/C/figures/invest_stockmerge1.png
Modified:
   gnucash-docs/trunk/ChangeLog
   gnucash-docs/trunk/guide/C/ch_bus_ap.xml
   gnucash-docs/trunk/guide/C/ch_bus_ar.xml
   gnucash-docs/trunk/guide/C/ch_bus_pay.xml
   gnucash-docs/trunk/guide/C/ch_currency.xml
   gnucash-docs/trunk/guide/C/ch_invest.xml
   gnucash-docs/trunk/guide/C/figures/bus_ap_billedit.png
   gnucash-docs/trunk/guide/C/figures/bus_ap_billnew.png
   gnucash-docs/trunk/guide/C/figures/bus_ap_billpost.png
   gnucash-docs/trunk/guide/C/figures/bus_ap_jobnew.png
   gnucash-docs/trunk/guide/C/figures/bus_ap_payment.png
   gnucash-docs/trunk/guide/C/figures/bus_ap_vendorfind.png
   gnucash-docs/trunk/guide/C/figures/bus_ap_vendornew.png
   gnucash-docs/trunk/guide/C/figures/bus_pay_ex1.png
   gnucash-docs/trunk/guide/C/figures/bus_pay_ex2.png
   gnucash-docs/trunk/guide/C/figures/bus_pay_ex3.png
   gnucash-docs/trunk/guide/C/figures/bus_pay_ex4.png
Log:
update docs for release

Modified: gnucash-docs/trunk/ChangeLog
===================================================================
--- gnucash-docs/trunk/ChangeLog	2006-05-24 04:17:56 UTC (rev 14171)
+++ gnucash-docs/trunk/ChangeLog	2006-05-24 05:08:42 UTC (rev 14172)
@@ -1,5 +1,48 @@
 2006-05-23  Chris Lyttle  <chris at wilddev.net>
 
+	* Updated the following (from Bengt Thuree <bengt at thuree.com>):
+	'guide/C/ch_currency.xml'
+
+	* Added the following new screenshots (from Bengt Thuree
+	<bengt at thuree.com>):
+	'guide/C/figures/currency_PutTogether_AfterStocks.png'
+	
+	* Updated the following (from Dave Herman <dvherman at bigfoot.com>):
+        'guide/C/ch_invest.xml'
+
+        * Added the following new screenshots (from Dave
+	Herman <dvherman at bigfoot.com>):
+	'guide/C/figures/invest_split1.png'
+	'guide/C/figures/invest_split3.png'
+	'guide/C/figures/invest_split5.png'
+	'guide/C/figures/invest_merge2.png'
+	'guide/C/figures/invest_split2.png'
+	'guide/C/figures/invest_split4.png'
+	'guide/C/figures/invest_merge3.png'
+	'guide/C/figures/invest_stockmerge1.png'
+	'guide/C/figures/invest_simplesplit1.png'
+
+	* Updated the following (from Patrick Schweiger <pks at spiffykitty.com>):
+	'guide/C/ch_bus_ar.xml'
+	'guide/C/ch_bus_ap.xml'
+	'guide/C/ch_bus_pay.xml'
+
+	* Added the following new screenshots (from Patrick Schweiger
+	<pks at spiffykitty.com>):
+	'guide/C/figures/bus_pay_ex1.png'
+	'guide/C/figures/bus_pay_ex3.png'
+	'guide/C/figures/bus_ap_jobnew.png'
+	'guide/C/figures/bus_ap_vendorfind.png'
+	'guide/C/figures/bus_ap_vendornew.png'
+	'guide/C/figures/bus_pay_ex2.png'
+	'guide/C/figures/bus_ap_billedit.png'
+	'guide/C/figures/bus_pay_ex4.png'
+	'guide/C/figures/bus_ap_payment.png'
+	'guide/C/figures/bus_ap_billpost.png'
+	'guide/C/figures/bus_ap_billnew.png'
+
+2006-05-23  Chris Lyttle  <chris at wilddev.net>
+
 	* xmldocs.make: fix make html so it copies pictures into the html
 	directory. The generated html will be left in the build directory.
 

Modified: gnucash-docs/trunk/guide/C/ch_bus_ap.xml
===================================================================
--- gnucash-docs/trunk/guide/C/ch_bus_ap.xml	2006-05-24 04:17:56 UTC (rev 14171)
+++ gnucash-docs/trunk/guide/C/ch_bus_ap.xml	2006-05-24 05:08:42 UTC (rev 14172)
@@ -1,12 +1,13 @@
 <!--
       (Do not remove this comment block.)
   Originally designed by Carol Champagne.
-  Version: 1.8.4
+  Version: 1.9.0
   Last modified: April 10th 2004
   Maintainers: 
                Chris Lyttle <chris at wilddev.net>
   Author:
   		Jon Lapham <lapham at extracta.com.br>
+        updated Patrick Schweiger <pks at spiffykitty.com>
   Translators:
                (translators put your name and email here)
 -->
@@ -14,21 +15,32 @@
  <title>Accounts Payable</title>
  <para>Accounts Payable (or A/P) refers to the accounting of products or services which a company has bought and needs to pay off.</para>
 
-  <sect1 id="bus_ap_concepts1">
+  <sect1 id="bus-ap-concepts1">
   <title>Basic Concepts</title>
-  <para>This chapter will focus on Accounts Payable (or A/P).  A/P refers to the accounting of products or services that your company has bought, for which payment needs to be scheduled.</para>
+  <para>This chapter focuses on Accounts Payable (or A/P).  A/P refers to the accounting of products or services that your company has bought, for which payment needs to be scheduled.</para>
    </sect1>
 
-  <sect1 id="bus_ap_setup1">
+  <sect1 id="bus-ap-setup1">
   <title>Initial Setup</title>
-  <para>To setup GnuCash to work with handling accounts payable for a company, there are 2 preliminary things that must be done.  The first thing to do is to build an appropriate Account Hierarchy and the second is to register the company in GnuCash.</para>
+  <para>To set up GnuCash to handle accounts payable for a company, two preliminary things must be done.  The first is to build an appropriate Account Hierarchy and the second is to register the company in GnuCash.</para>
 
-  <sect2 id="bus_ap_setupacct2">
+  <sect2 id="bus-ap-setupacct2">
   <title>Account Setup</title>
-  <para>There are many different ways to setup a business account hierarchy.  You can start with the Business Accounts setup which is available from the New Account druid, or you could build one manually.  To access the prebuilt Business Accounts, start GnuCash and click on <guimenu>File</guimenu> -> <guimenu>New File</guimenu> and proceed until you see the list of available accounts, select Business Accounts.</para>
-  <para>Most likely, the prebuilt Business Account hierarchy will not be perfect for your needs, you will need to perform some amount of manual adjustments for the accounts to function well with your situation.  This chapter will present example account structures which you can add to your existing accounts.</para>
 
-  <para>Accounts Payable (or A/P) refers to products or services bought by the company for which payment has not yet been sent.  This is represented on the balance sheet as a liability, because the expectation is that you will have to pay for it.  To use GnuCash's integrated accounts payable system, you must first setup an account (usually a sub-account under Liabilities) defined with account type <emphasis>A/Payable</emphasis>.  It is within this account that the integrated A/P system will place transactions.</para>
+      <para>There are many different ways to set up a business account
+      hierarchy. You can start with the Business Accounts setup which is
+      available from the New Account Hierarchy druid, or you could build one
+      manually. To access the prebuilt Business Accounts, start GnuCash and
+      click on <guimenu>File</guimenu> -&gt; <guimenu>New File</guimenu> and
+      proceed until you see the list of available accounts, select Business
+      Accounts.</para>
+
+      <para>The prebuilt Business Account hierarchy will not meet your needs
+      exactly. You will need make adjustments for the hierarchy to function
+      well with your particular situation. It should be close enough that it
+      is recommended you begin with it.</para>
+
+      <para>Accounts Payable (or A/P) refers to products or services bought by your company for which payment has not yet been sent.  This is represented on the balance sheet as a liability because you will have to pay for them.  To use GnuCash's integrated accounts payable system, you must first setup an account of the <emphasis>A/Payable</emphasis> type.  The <emphasis>A/Payable</emphasis> account is usually a sub-account under Liabilities.  It is within this account that the integrated A/P system places transactions.</para>
   <literallayout>
 Basic A/P Account Hierarchy:
 
@@ -40,79 +52,114 @@
    -AP Expenses
   </literallayout>
 
- <note>
- <para>Note that you will need to add real asset accounts and real expense accounts to this hierarchy.  But, the most important aspects of this hierarchy are that you need an expense account and an Accounts Payable account, with account type set to <emphasis>A/Payable</emphasis>.</para>
- </note>
+ 
+ <para>You need to add additional asset accounts and real expense accounts to make this hierarchy useful.  The important aspects of this hierarchy are that you need an expense account and an Accounts Payable account, with account type set to <emphasis>A/Payable</emphasis>.</para>
   </sect2>
 
-  <sect2 id="bus_ap_setupcname2">
-  <title>Register Your Company in GnuCash</title>
-  <para>After you have built your account structure, you will want to register the GnuCash file as belonging to your company.  To do so, add your Business Name, Address and GST number.  Click on <guimenu>File</guimenu> -> <guimenu>Properties</guimenu>.  Type the Business name and address, add an empty line and add the GST number: <quote>GST: 1234-5678RT</quote>.  Click <guilabel>OK</guilabel>.</para>
+  <sect2 id="bus-ap-setupcname2">
+  <title>Company Registration</title>
+
+      <para>After you have built the account structure, register the GnuCash
+      file as belonging to your company. To register your company, select
+      <guimenu>File</guimenu> -&gt; <guimenu>Properties</guimenu>:</para>
+
+      <itemizedlist>
+        <listitem>
+          <para>Enter the name of your company along with contact information
+          such as your phone number, fax number, e-mail address and website
+          URL.</para>
+        </listitem>
+
+        <listitem>
+          <para>Enter your company's tax payer id number in the
+          <guilabel>Company ID</guilabel> field.</para>
+        </listitem>
+
+       </itemizedlist>
   </sect2>
   </sect1>
 
-  <sect1 id="bus_ap_components1">
+  <sect1 id="bus-ap-components1">
   <title>System Components</title>
-  <para>GnuCash has an integrated accounts payable system.  The transactions generated by the A/P system will be placed within the Accounts Payable account, as a record of what occurs, but you do not directly work within this account.  Rather, you will principally be working with the 4 integrated GnuCash A/P application components, available from the sub-menu <guimenu>Business</guimenu> -> <guimenu>Vendors</guimenu>.  These 4 application components are:</para>
+  <para>GnuCash has an integrated accounts payable system.  The transactions generated by the A/P system are placed within the Accounts Payable account, as a record of what occurs.  Generally you do not directly work with this account but use the four integrated GnuCash A/P application components.  The A/P components are available from the<guimenu>Business</guimenu> -&gt; <guimenu>Vendor</guimenu> sub-menu.  These A/P components are:</para>
 
   <itemizedlist>
   <listitem>
   <para><guilabel>Vendors</guilabel> are people or companies from which you buy products or services on credit.</para>
   </listitem>
   <listitem>
-  <para><guilabel>Bills</guilabel> represent the physical bill you receive from a vendor, requesting payment.  A bill contains an itemized list of things you purchased.</para>
+  <para><guilabel>Bills</guilabel> represent the physical bills vendors send to request payment from you.  A bill contains an itemized list of things you purchased.</para>
   </listitem>
   <listitem>
-  <para><guilabel>Jobs</guilabel> (optional) is where you register Vendor Jobs, a grouping mechanism by which you can group bills to a particular vendor.</para>
+  <para><guilabel>Jobs</guilabel> (optional) is where you register Vendor Jobs.  Jobs are mechanism by which you can group multiple bills from a particular vendor.</para>
   </listitem>
   <listitem>
-  <para><guilabel>Process Payments</guilabel> is where you register money payments to a vendor to whom you owe money.</para>
+  <para><guilabel>Process Payments</guilabel> is where you register payments to a vendor to whom you owe money.</para>
   </listitem>
   </itemizedlist>
 
-  <para>In the next 4 sections of this chapter, the above 4 application components will be introduced.</para>
+  <para>The following sections introduce the individual Accounts Payable application components.</para>
  </sect1>
 
-  <sect1 id="bus_ap_vendors1">
+  <sect1 id="bus-ap-vendors1">
   <title>Vendors</title>
- <para>A vendor is a company or person from whom you purchase goods or services.  The vendors must be register within the A/P system.</para>
+ <para>A vendor is a company or person from whom you purchase goods or services.  Vendors must be registered within the A/P system.</para>
  
-  <sect2 id="bus_ap_vendornew2">
+  <sect2 id="bus-ap-vendornew2">
   <title>New</title>
- <para>To register a new vendor, enter the menu <guimenu>Business</guimenu> -> <guimenu>Vendor</guimenu> -> <guimenu>New Vendor</guimenu>.  Fill in the appropriate general information about the vendor, such as Company Name, Address, Phone, Fax, etc.  Below is a list of the other options: </para>
+ <para>To register a new vendor, select the <guimenu>Business</guimenu> -&gt; <guimenu>Vendor</guimenu> -&gt; <guimenu>New Vendor</guimenu> menu item.  Fill in general information about the vendor, such as Company Name, Address, Phone, Fax, etc.  Below is a list of the other options: </para>
+
  <itemizedlist>
  <listitem>
- <para><guilabel>Identification - Vendor Number</guilabel> - can be any number you would like to refer to this vendor, or you may leave it blank and a number will be chosen automatically.</para>
+ <para><guilabel>Identification - Vendor Number</guilabel> - can be any number by which you would like to refer to this vendor.  You may leave it blank and a number will be chosen automatically.</para>
  </listitem>
  <listitem>
- <para><guilabel>Identification - Active</guilabel> - this check box is used to differentiate active vendors from inactive ones.</para>
+ <para><guilabel>Identification - Active</guilabel> - differentiates active vendors from inactive ones. This is useful when you have many past vendors, and you want to see only those marked active</para>
  </listitem>
  <listitem>
- <para><guilabel>Payment Address - Name</guilabel> - this is the contact name of the person to receive the payment.</para>
+ <para><guilabel>Payment Address - Name</guilabel> - is the contact name of the person to receive payments you make.</para>
  </listitem>
  <listitem>
- <para><guilabel>Notes</guilabel> - you can enter any text you would like to in this area, additional commentaries about this vendor.  For example, the names of contact people from within the vendor's company.</para>
+ <para><guilabel>Notes</guilabel> - records any additional comments about the vendor.  Use it to track names of contact people within the vendor's company, for example.</para>
  </listitem>
  <listitem>
- <para><guilabel>Payment Information - Currency</guilabel> - here you can specify what the default payment currency will be.</para>
+ <para><guilabel>Payment Information - Currency</guilabel> - specifies the default payment currency.</para>
  </listitem>
  <listitem>
- <para><guilabel>Payment Information - Terms</guilabel> - here you can specify what the default payment terms will be.  These terms must be preregistered using <guimenu>Business</guimenu> -> <guimenu>Billing Terms</guimenu>.</para>
+ <para><guilabel>Payment Information - Terms</guilabel> - specifies the default payment terms for this vendor.  Payment terms must be preregistered using <guimenu>Business</guimenu> -&gt; <guimenu>Billing Terms</guimenu>.</para>
  </listitem>
+
  <listitem>
- <para><guilabel>Payment Information - Tax Included</guilabel> - this specifies whether tax has already been included in the bill.  You can choose <guilabel>Yes</guilabel>, <guilabel>No</guilabel>, or <guilabel>Use Global</guilabel>.  Yes means that the tax is already included in the bill, No means tax has not been included in the bill, and Use Global means to use the global tax table specified in the "Tax Table" option below.</para>
+ <para><guilabel>Payment Information - Tax Included</guilabel> - specifies if tax is included in bills from this vendor.  You can choose <guilabel>Yes</guilabel>, <guilabel>No</guilabel>, or <guilabel>Use Global</guilabel>.
+          <itemizedlist>
+              <listitem>
+                <para><guilabel>Yes</guilabel> means that tax is already
+                included in amounts on bills.</para>
+              </listitem>
+
+              <listitem>
+                <para><guilabel>No</guilabel> means tax is not included.</para>
+              </listitem>
+
+              <listitem>
+                <para><guilabel>Use Global</guilabel> means to use the setting
+                made in the global preferences accessible through
+                <guimenu>Edit</guimenu> -&gt;
+                <guimenu>Preferences</guimenu>.</para>
+              </listitem>
+            </itemizedlist></para>
  </listitem>
  <listitem>
- <para><guilabel>Payment Information - Tax Table</guilabel> - this allows you to specify a specific preregistered tax table to apply to bills from this vendor.  Tax tables must be registered from the menu item <guimenu>Business</guimenu> -> <guimenu>Tax Table</guimenu>.</para>
+ <para><guilabel>Payment Information - Tax Table</guilabel> - specifies a default tax table to apply to bills from this vendor.  Tax tables must be registered using the <guimenu>Business</guimenu> -&gt; <guimenu>Tax Table</guimenu> menu item.</para>
  </listitem>
  </itemizedlist>
 
   <para>This is what the New Vendor registration window looks like:</para>
-	<screenshot id="bus_ap_vendornew">
+	<screenshot id="bus-ap-vendornew">
 	  <mediaobject>
 	    <imageobject>
 	      <imagedata fileref="figures/bus_ap_vendornew.png" 
-	      srccredit="Jon Lapham" format="PNG"/>
+	      srccredit="Patrick Schweiger" format="PNG"/>
             </imageobject>
 	    <textobject>
 	        <phrase>New Vendor Registration Window</phrase>
@@ -125,15 +172,15 @@
         </screenshot>
 
   </sect2>
-  <sect2 id="bus_ap_vendorfind2">
+  <sect2 id="bus-ap-vendorfind2">
   <title>Find and Edit</title>
 
- <para>To search for a preexisting vendor, use the <guimenu>Business</guimenu> -> <guimenu>Vendors</guimenu> -> <guimenu>Find Vendors</guimenu> application.  From the results of the search, you can select a vendor to edit, or view.</para>
-	<screenshot id="bus_ar_vendorfind">
+ <para>To search for an existing vendor, use the <guimenu>Business</guimenu> -&gt; <guimenu>Vendor</guimenu> -&gt; <guimenu>Find Vendor</guimenu> window.  You select a vendor to <guibutton>View/Edit</guibutton> from the results of the search.  This window is also used to look up a vendor when entering bills and processing payments.</para>
+	<screenshot id="bus-ar-vendorfind">
 	  <mediaobject>
 	    <imageobject>
 	      <imagedata fileref="figures/bus_ap_vendorfind.png" 
-	      srccredit="Jon Lapham" format="PNG"/>
+	      srccredit="Patrick Schweiger" format="PNG"/>
             </imageobject>
 	    <textobject>
 	        <phrase>Find Vendor Window</phrase>
@@ -145,19 +192,33 @@
           </mediaobject>
         </screenshot>
 
+      <para>If many vendors match the search criteria you provide, the
+      search can be refined by running an additional search within the current
+      results. The current result set is searched when the <guilabel>Refine
+      Current Search</guilabel> radio button is selected. In fact, GnuCash
+      selects this option for you after you run the initial search.</para>
+
+      <para>If the vendor you are searching for does not match the supplied
+      search criteria, change the search criteria, click the <guilabel>New
+      Search</guilabel> radio button and then the <guibutton>Find</guibutton>
+      button. The relevant step is the <guilabel>New Search</guilabel>
+      selection. If the vendor is not in the result of the original search,
+      and you only search within this set, the vendor cannot be found,
+      regardless of new search criteria.</para>
+
  <note>
- <para>To return a list of all registered active vendors, set the search criterion to "matches regex", and place a single dot "." in the text field area.  Then, click <guibutton>Find</guibutton>.  The regular expression "." means to match anything.</para>
+ <para>To return a list of all registered active vendors, set the search criterion to "matches regex", and place a single dot "." in the text field area.  Make sure <guilabel>Search only active data</guilabel> is checked, then click <guibutton>Find</guibutton>.  The regular expression "." means to match anything.</para>
  </note>
 
   </sect2>
   </sect1>
 
-  <sect1 id="bus_ap_bills1">
+  <sect1 id="bus-ap-bills1">
   <title>Bills</title>
- <para>A bill is the paperwork you receive from a customer requesting payment for a product or services you purchased.  GnuCash can be used to generate and track bills.</para>
-  <sect2 id="bus_ap_billnew2">
+ <para>A bill is a request for payment you receive from a vendor.  GnuCash can track bills.</para>
+  <sect2 id="bus-ap-billnew2">
   <title>New</title>
- <para>When you receive a bill from a vendor and want to enter it into GnuCash, you must create a new bill.  This is accomplished using the application available at <guimenu>Business</guimenu> -> <guimenu>Vendors</guimenu> -> <guimenu>New Bill</guimenu>.  The New Bill window should be filled in appropriately:</para>
+ <para>When you receive a bill from a vendor and want to enter it into GnuCash, you must create a new bill.  To create a new bill use the <guimenu>Business</guimenu> -&gt; <guimenu>Vendor</guimenu> -&gt; <guimenu>New Bill</guimenu> menu item, and fill in the resulting window appropriately.</para>
   <itemizedlist>
   <listitem>
   <para><guilabel>Invoice Info - Invoice ID</guilabel> (optional) - the identification number of the invoice as emitted by the vendor (IE: the vendor's internal number for this invoice).</para>
@@ -169,30 +230,27 @@
   <para><guilabel>Billing Info - Vendor</guilabel> - the issuing vendor.</para>
   </listitem>
   <listitem>
-  <para><guilabel>Billing Info - Job</guilabel> (optional) - the vendor job to associate with this bill.</para>
+  <para><guilabel>Billing Info - Job</guilabel> (optional) - associates a vendor job with this bill.  Vendor jobs are described in the following section.</para>
   </listitem>
   <listitem>
-  <para><guilabel>Billing Info - Billing ID</guilabel> (optional) - the vendor's ID for the bill (e.g.: their invoice #).  Can be left blank.</para>
+  <para><guilabel>Billing Info - Billing ID</guilabel> (optional) - the vendor's ID for the bill (e.g.: their invoice #).</para>
   </listitem>
   <listitem>
-  <para><guilabel>Billing Info - Terms</guilabel> - the payback terms agreement for this bill, a list of preregistered terms is available within the pop up menu.</para>
+  <para><guilabel>Billing Info - Terms</guilabel> - the pay back terms agreement for this bill. A list of registered terms is available within the pop up menu.  If you specified a a default value for the selected vendor, this field is initialized with the default.</para>
   </listitem>
   <listitem>
-  <para><guilabel>Chargeback Project - Customer</guilabel> (optional) - the customer to associate with this bill, for purposes of charging the customer later.</para>
+  <para><guilabel>Chargeback Project - Customer</guilabel> (optional) - the customer to associate with this bill.  This is used to charge your customer later.</para>
   </listitem>
   <listitem>
   <para><guilabel>Chargeback Project - Job</guilabel> (optional) - the customer job to associate with this bill.</para>
   </listitem>
-  <listitem>
-  <para><guilabel>Notes</guilabel> (optional) - any notes concerning the bill go here.</para>
-  </listitem>
   </itemizedlist>
 
-	<screenshot id="bus_ap_billnew">
+	<screenshot id="bus-ap-billnew">
 	  <mediaobject>
 	    <imageobject>
 	      <imagedata fileref="figures/bus_ap_billnew.png" 
-	      srccredit="Jon Lapham" format="PNG"/>
+	      srccredit="Patrick Schweiger" format="PNG"/>
             </imageobject>
 	    <textobject>
 	        <phrase>New Bill Registration Window</phrase>
@@ -204,16 +262,17 @@
           </mediaobject>
         </screenshot>
 
-  <para>Once you fill in all the information for the new bill, you will be presented with the <guilabel>Edit Bill</guilabel> window.</para>
+
+  <para>When you click the <guibutton>OK</guibutton> the <guilabel>Edit Bill</guilabel> opens.</para>
   </sect2>
-  <sect2 id="bus_ap_billedit2">
+  <sect2 id="bus-ap-billedit2">
   <title>Edit</title>    
-  <para>From the Edit Bill window you can enter an itemized list of things purchased on this bill, in a manner similar to how the account register works.</para>  
-  	<screenshot id="bus_ap_billedit">
+  <para>From the Edit Bill window you can enter an itemized list of things purchased, in a manner similar to how the account register works.</para>  
+  	<screenshot id="bus-ap-billedit">
 	  <mediaobject>
 	    <imageobject>
 	      <imagedata fileref="figures/bus_ap_billedit.png" 
-	      srccredit="Jon Lapham" format="PNG"/>
+	      srccredit="Patrick Schweiger" format="PNG"/>
             </imageobject>
 	    <textobject>
 	        <phrase>Edit Bill Window</phrase>
@@ -224,37 +283,37 @@
           </mediaobject>
         </screenshot>
 
-  <para>There are 11 columns in the Invoice Entries area:</para>
+  <para>There are 12 columns in the Invoice Entries area:</para>
   <itemizedlist>
   <listitem>
-  <para><guilabel>Date</guilabel> - The date this item was sold</para>
+  <para><guilabel>Date</guilabel> - The date this item was sold.</para>
   </listitem>
   <listitem>
   <para><guilabel>Invoiced?</guilabel> - <guilabel>X</guilabel>  means the item is attached to this invoice, an empty box means the item is not attached to this invoice.  If the box is empty you can attach the item to the invoice by first selecting the item row and then clicking in this box.</para>
   </listitem>
   <listitem>
-  <para><guilabel>Description</guilabel> (optional) - what the item is called</para>
+  <para><guilabel>Description</guilabel> (optional) - is what the item or service is called.</para>
   </listitem>
   <listitem>
-  <para><guilabel>Action</guilabel> (optional) - user defined field.  Can place Cost Center info here, or use one of the 3 predefined actions, Hours, Material, or Project.</para>
+  <para><guilabel>Action</guilabel> (optional) - is a user defined field.  You can place Cost Center information here, or use one of the 3 predefined actions, Hours, Material, or Project.</para>
   </listitem>
   <listitem>
-  <para><guilabel>Expense Account</guilabel> - which expense account will be changed for this bill</para>
+  <para><guilabel>Expense Account</guilabel> - selects the expense account to change for this item.</para>
   </listitem>
   <listitem>
-  <para><guilabel>Quantity</guilabel> - how many of the items were sold to you</para>
+  <para><guilabel>Quantity</guilabel> - tracks how many of the items you bought.</para>
   </listitem>
   <listitem>
-  <para><guilabel>Unit Price</guilabel> - the unit price of the item</para>
+  <para><guilabel>Unit Price</guilabel> - is the unit price of the item.</para>
   </listitem>
   <listitem>
-  <para><guilabel>Taxable?</guilabel> - is this item taxable?  <guilabel>X</guilabel> means yes, a blank field means no.</para>
+  <para><guilabel>Taxable?</guilabel> - is this item taxable?  <guilabel>X</guilabel> means yes, a blank field means no. You can click the field to toggle the setting.</para>
   </listitem>
   <listitem>
   <para><guilabel>Tax Included?</guilabel> - has the tax already been included in the unit price?  <guilabel>X</guilabel> means yes, a blank field means no.</para>
   </listitem>
   <listitem>
-  <para><guilabel>Tax Table</guilabel> (optional) - this is a pop up menu of all the available tax tables.  If you set the item as taxable and set that the tax has not been included in the unit price, then this tax table is used to compute the amount of tax.</para>
+  <para><guilabel>Tax Table</guilabel> (optional) - this is a pop up menu of all the available tax tables.  If the item is taxable and tax has not been included in the unit price, then this tax table is used to compute the amount of tax.</para>
   </listitem>
   <listitem>
   <para><guilabel>Subtotal</guilabel> (uneditable) - computed subtotal for this item (less tax)</para>
@@ -267,15 +326,15 @@
   <para>When you have finished entering all the items, <guilabel>Post</guilabel> the bill. </para>
   </sect2>
 
-  <sect2 id="bus_ap_billpost2">
+  <sect2 id="bus-ap-billpost2">
   <title>Post</title>
-  <para>When you have finished editing a bill, you should <guilabel>Post</guilabel> the bill.  You do not have to post the bill, you can simply close it and return to it later, however you need to eventually post it when you are finished editing.  Posting the bill will place the bill transactions into an accounts payable account.  The Post Bill window will appear asking you to enter the Post Date, the Due Date, a Description, and Post to Account (from which you can select from a list of A/Payable accounts).</para>
+  <para>When you finish editing a bill, you should <guilabel>Post</guilabel> the bill.  You do not have to post the bill, you can close it and return to it later. You have to post the bill eventually.  Posting a bill places its transactions into an accounts payable account.  The Post Bill window appears and asks you to enter information:</para>
 
-  	<screenshot id="bus_ap_billpost">
+  	<screenshot id="bus-ap-billpost">
 	  <mediaobject>
 	    <imageobject>
 	      <imagedata fileref="figures/bus_ap_billpost.png" 
-	      srccredit="Jon Lapham" format="PNG"/>
+	      srccredit="Patrick Schweiger" format="PNG"/>
             </imageobject>
 	    <textobject>
 	        <phrase>Post Bill Window</phrase>
@@ -286,41 +345,118 @@
 	    </caption>
           </mediaobject>
         </screenshot>
+
+  <itemizedlist>
+    <listitem>
+      <para><guilabel>Post Date</guilabel> - specifies the date for the transactions entered into the accounts payable account.</para>
+    </listitem>
+    <listitem>
+      <para><guilabel>Due Date</guilabel> - is the date on which payment for the bill is expected.</para>
+          
+          <itemizedlist>
+            <listitem>
+              <para>If you specified payment terms when you created the bill,
+              the date is calculated according to selected terms, and
+              the entry field is insensitive.</para>
+            </listitem>
+
+            <listitem>
+              <para>If you did not specify payment terms, enter the expected
+              payment due date here.</para>
+            </listitem>
+          </itemizedlist>
+    </listitem>
+
+    <listitem>
+       <para><guilabel>Description</guilabel> - is an arbitrary
+       description. When bill transactions are placed in the accounts
+       payable account, this description is entered in the memo field of
+       those transactions.</para>
+    </listitem>
+
+    <listitem>
+       <para><guilabel>Post To Account</guilabel> - selects the accounts
+        payable account in which bill transactions are posted. You can
+        select the account from a list of existing A/Payable
+        accounts.</para>
+     </listitem>
+
+
+        <listitem>
+          <para><guilabel>Accumulate Splits</guilabel> - determines if bill
+          items which transfer to the same account are combined into a single
+          split for that account or entered individually. For the sample
+          bill for Letterhead and Envelopes, the setting affects post
+          results as follows:</para>
+
+          <itemizedlist>
+            <listitem>
+              <para>Checked (splits are accumulated) - a single transfer of
+              $100.00 to the Expenses:Office Supplies account is recorded.</para>
+            </listitem>
+
+            <listitem>
+              <para>Not checked - the transaction created in the A/Payable
+              account, shows two transfers to Expenses:Office Supplies account
+              $75.00 and $25.00.  The memo fields in the splits indicate the
+              purchase of Letterhead and Envelopes (the item descriptions
+              entered on the bill) respectively.</para>
+            </listitem>
+          </itemizedlist>
+        </listitem>
+  </itemizedlist>
   </sect2>
 
-  <sect2 id="bus_ap_billfind2">
+  <sect2 id="bus-ap-billfind2">
   <title>Find</title>
-  <para>To find a preexisting bill, use the <guimenu>Business</guimenu> -> <guimenu>Vendors</guimenu> -> <guimenu>Find Bill</guimenu> application.  From the results of the search, you can select a bill to edit, or view.</para>
+  <para>To find an existing bill, use the <guimenu>Business</guimenu> -&gt; <guimenu>Vendor</guimenu> -&gt; <guimenu>Find Bill</guimenu> application.  From the results of the search, you can select a bill to edit, or view.</para>
   <note>
-  <para>Note, before you can edit a preexisting posted bill, you will need to unpost it.</para>
+  <para>Before you can edit a posted bill, you will need to <guilabel>Unpost</guilabel> it.</para>
   </note>
 
+  <note>
+  <para>There are other ways to access an existing bill.  These are similar to accessing invoices for your customers.  See the section on finding invoices in the accounts receivable chapter for more information.</para>
+  </note>
+
   </sect2>
   </sect1>
 
-  <sect1 id="bus_ap_jobs1">
+  <sect1 id="bus-ap-jobs1">
   <title>Vendor Jobs</title>
-  <para>You can use the optional GnuCash feature called Vendor Jobs to associate bills which fall under a single vendor.  This is useful for when you have multiple "jobs" for the same vendor, and would like to view all the bills for one job.</para>
-  <para>To use vendor jobs, you must create them using the <guimenu>Business</guimenu> -> <guimenu>Vendors</guimenu> -> <guimenu>New Jobs</guimenu> application.  Once there, you will see the <guilabel>New Job</guilabel> window.  The editable fields are:</para>
-   <itemizedlist>
-   <listitem>
-   <para><guilabel>Job Info - Job Number</guilabel> (optional) - enter the number for this job.  If left blank, a reasonable number will be chosen for you.</para>
-   </listitem>
-   <listitem>
-   <para><guilabel>Job Info - Job Name</guilabel> - the name you want to call this job.</para>
-   </listitem>
-   <listitem>
-   <para><guilabel>Owner Info - Vendor</guilabel> - the vendor associated with this job.</para>
-   </listitem>
-   <listitem>
-   <para><guilabel>Owner Info - Billing ID</guilabel> - the vendor's reference to this job (e.g. their PO Number).  It's the "Billing Identification" that they require on your invoices to them.</para>
-   </listitem>
-   <listitem>
-   <para><guilabel>Job Active</guilabel> - toggles this job being active or not.  This is useful to use when you have lots of inactive jobs, it is easier to find all the active ones.</para>
-   </listitem>
-   </itemizedlist>
+  <para>Vendor Jobs are used to group multiple bills from a single vendor.  Use of the vendor jobs feature is optional.  The feature is useful when you have multiple "jobs" for the same vendor, and would like to view all the bills for a single job.</para>
+  <para>To use vendor jobs, you must create them using the <guimenu>Business</guimenu> -&gt; <guimenu>Vendor</guimenu> -&gt; <guimenu>New Job</guimenu> application.  You will see the <guilabel>New Job</guilabel> window.  The editable fields are:</para>
 
-  	<screenshot id="bus_ap_jobnew">
+
+    <itemizedlist>
+      <listitem>
+        <para><guilabel>Job Info - Job Number</guilabel> (optional) - enter
+        the number for this job. If left blank, a number will be chosen for
+        you.</para>
+      </listitem>
+
+      <listitem>
+        <para><guilabel>Job Info - Job Name</guilabel> - the name you want to
+        assign to the new job.</para>
+      </listitem>
+
+      <listitem>
+        <para><guilabel>Owner Info - Vendor</guilabel> - the vendor for
+        whom the job is created.</para>
+      </listitem>
+
+      <listitem>
+        <para><guilabel>Owner Info - Billing ID</guilabel> - the vendor's
+        reference to this job (e.g. their PO Number).</para>
+      </listitem>
+
+      <listitem>
+        <para><guilabel>Job Active</guilabel> - toggles this job being active
+        or not. This is useful when you have many inactive jobs, since it is
+        easier to search only among jobs that are marked active.</para>
+      </listitem>
+    </itemizedlist>
+
+  	<screenshot id="bus-ap-jobnew">
 	  <mediaobject>
 	    <imageobject>
 	      <imagedata fileref="figures/bus_ap_jobnew.png" 
@@ -335,42 +471,58 @@
           </mediaobject>
         </screenshot>
 
-  <para>To find a preexisting vendor job, use the <guimenu>Business</guimenu> -> <guimenu>Vendors</guimenu> -> <guimenu>Find Job</guimenu> application.  From the results of the search, you can select a job to edit, or view.</para>
+
+    <para>To edit an existing vendor job, use the
+    <guimenu>Business</guimenu> -&gt; <guimenu>Vendor</guimenu> -&gt;
+    <guimenu>Find Job</guimenu> application. Select the desired job in the
+    search results, and click the <guilabel>View/Edit Job</guilabel>
+    button.</para>
+
+    <para>To select from the bills associated with a given job, use
+    <guimenu>Business</guimenu> -&gt; <guimenu>Vendor</guimenu> -&gt;
+    <guimenu>Find Job</guimenu> application. Select the desired job in the
+    search results and click the <guilabel>View Invoices</guilabel> button. A
+    window listing bills associated with this job appears. Select a
+    bill and click the <guilabel>View Invoice</guilabel> button to open a
+    bill editor in the main application window.</para>
   </sect1>
 
-  <sect1 id="bus_ap_payment1">
+  <sect1 id="bus-ap-payment1">
   <title>Process Payment</title>
-  <para>Eventually, you will need to pay your bills.  To do so, use the Process Payment application found in <guimenu>Business</guimenu> -> <guimenu>Vendors</guimenu> -> <guimenu>Process Payment</guimenu>.</para>
+  <para>Eventually, you need to pay your bills.  To do so, use the Process Payment application found in <guimenu>Business</guimenu> -&gt; <guimenu>Vendor</guimenu> -&gt; <guimenu>Process Payment</guimenu>.</para>
   <para>The Process Payment application consists of:</para>
   <itemizedlist>
   <listitem>
-  <para><guilabel>Payment Info - Vendor</guilabel> - the vendor you wish to pay</para>
+  <para><guilabel>Payment Information - Vendor</guilabel> - the vendor you wish to pay.</para>
   </listitem>
   <listitem>
-  <para><guilabel>Payment Info - Date</guilabel> - the date you wish to make the payment, normally the current date.</para>
+  <para><guilabel>Payment Information - Bill</guilabel> - the bill you wish to pay.</para>
   </listitem>
   <listitem>
-  <para><guilabel>Payment Info - Amount</guilabel> - the amount of money to transfer in this payment.</para>
+  <para><guilabel>Payment Information - Date</guilabel> - the date you wish to make the payment, normally the current date.</para>
   </listitem>
   <listitem>
-  <para><guilabel>Payment Info - Num</guilabel> - the check number.</para>
+  <para><guilabel>Payment Information - Amount</guilabel> - the amount of money to transfer in this payment.</para>
   </listitem>
   <listitem>
-  <para><guilabel>Payment Info - Memo</guilabel> - any comments about this payment.</para>
+  <para><guilabel>Payment Information - Num</guilabel> - the check number.</para>
   </listitem>
   <listitem>
+  <para><guilabel>Payment Information - Memo</guilabel> - any comments about this payment.</para>
+  </listitem>
+  <listitem>
   <para><guilabel>Post To</guilabel> - the A/Payable account to post this transaction.</para>
   </listitem>
   <listitem>
-  <para><guilabel>Transfer Account</guilabel> - the account where the money will come from (a checking account for example) to make this payment.</para>
+  <para><guilabel>Transfer Account</guilabel> - the account from which money for the payments comes from, such as a checking account.</para>
   </listitem>
   </itemizedlist>
     <para>Below is the GnuCash Accounts Receivable payment window.</para>
-  	<screenshot id="bus_ap_payment">
+  	<screenshot id="bus-ap-payment">
 	  <mediaobject>
 	    <imageobject>
 	      <imagedata fileref="figures/bus_ap_payment.png" 
-	      srccredit="Jon Lapham" format="PNG"/>
+	      srccredit="Patrick Schweiger" format="PNG"/>
             </imageobject>
 	    <textobject>
 	        <phrase>Process Payment</phrase>

Modified: gnucash-docs/trunk/guide/C/ch_bus_ar.xml
===================================================================
--- gnucash-docs/trunk/guide/C/ch_bus_ar.xml	2006-05-24 04:17:56 UTC (rev 14171)
+++ gnucash-docs/trunk/guide/C/ch_bus_ar.xml	2006-05-24 05:08:42 UTC (rev 14172)
@@ -359,7 +359,7 @@
           <para><guilabel>Invoice Information - Invoice ID</guilabel> - the
           identification number of this invoice. This is your internal number
           for this invoice. If you leave it blank, an invoice number will be
-          generated automically.</para>
+          generated automatically.</para>
         </listitem>
 
         <listitem>
@@ -489,7 +489,7 @@
           <itemizedlist>
             <listitem>
               <para><guilabel>$</guilabel> means <guilabel>Discount</guilabel>
-              is a montary value</para>
+              is a monetary value</para>
             </listitem>
 
             <listitem>
@@ -627,7 +627,7 @@
             </listitem>
 
             <listitem>
-              <para>If you did no specify payment terms, enter the expected
+              <para>If you did not specify payment terms, enter the expected
               payment due date here.</para>
             </listitem>
           </itemizedlist>
@@ -635,15 +635,15 @@
 
         <listitem>
           <para><guilabel>Description</guilabel> - is an arbitrary
-          description. When invoice transactions are placed the accounts
+          description. When invoice transactions are placed in the accounts
           receivable account, this description is entered in the memo field of
           those transactions.</para>
         </listitem>
 
         <listitem>
           <para><guilabel>Post To Account</guilabel> - selects the accounts
-          receivable account in which invoice transcations are posted. You can
-          select the account from a list existing A/Receivable
+          receivable account in which invoice transactions are posted. You can
+          select the account from a list of existing A/Receivable
           accounts.</para>
         </listitem>
 
@@ -661,9 +661,9 @@
             </listitem>
 
             <listitem>
-              <para>Not checked - the transaction created A/Receivable
+              <para>Not checked - the transaction created in the A/Receivable
               account, shows two transfers from Income:Sales account $100.00
-              and $475.00. The memo field in the splits indicate the sale of
+              and $475.00. The memo fields in the splits indicate the sale of
               Nails and the Hammer (the item descriptions entered on the
               invoice) respectively.</para>
             </listitem>
@@ -789,7 +789,7 @@
       <note>
         <para>GnuCash optionally compresses files. Disable compression and
         save before editing the file. To enable or disable compression use
-        <guimenu>Edit</guimenu> -&gt; <guimenu>Preferenecs</guimenu>, access
+        <guimenu>Edit</guimenu> -&gt; <guimenu>Preferences</guimenu>, access
         the <guilabel>General</guilabel> tab, and select or deselect the
         <guilabel>Compress Files</guilabel> check box.</para>
       </note>
@@ -856,7 +856,7 @@
       </mediaobject>
     </screenshot>
 
-    <para>To edit an existing existing customer job, use the
+    <para>To edit an existing customer job, use the
     <guimenu>Business</guimenu> -&gt; <guimenu>Customer</guimenu> -&gt;
     <guimenu>Find Job</guimenu> application. Select the desired job in the
     search results, and click the <guilabel>View/Edit Job</guilabel>
@@ -1041,4 +1041,4 @@
       </mediaobject>
     </screenshot>
   </sect1>
-</chapter>
\ No newline at end of file
+</chapter>

Modified: gnucash-docs/trunk/guide/C/ch_bus_pay.xml
===================================================================
--- gnucash-docs/trunk/guide/C/ch_bus_pay.xml	2006-05-24 04:17:56 UTC (rev 14171)
+++ gnucash-docs/trunk/guide/C/ch_bus_pay.xml	2006-05-24 05:08:42 UTC (rev 14172)
@@ -6,27 +6,29 @@
                Chris Lyttle <chris at wilddev.net>
   Author:
   		Jon Lapham <lapham at extracta.com.br>
+        updated Patrick Schweiger <pks at spiffykitty.com>
   Originally designed by Carol Champagne.
   Translators:
                (translators put your name and email here)
 -->
  <chapter id="chapter14">
  <title>Payroll</title>
- <para>Payroll is a financial record of wages, net pay, paid vacations, and deductions for an employee.  This chapter will demonstrate how to track payroll in GnuCash</para>
- <sect1 id="bus_pay_concepts1">
+ <para>Payroll is a financial record of wages, net pay, paid vacations, and deductions for an employee.  This chapter demonstrates how to track payroll using GnuCash</para>
+ <sect1 id="bus-pay-concepts1">
  <title>Basic Concepts</title>
-  <para>Payroll is a financial record of wages, net pay, paid vacations, and deductions for an employee.  Basically, anything that relates to giving money or benefits to an employee.  This is one of the more complex tasks in terms of accounting, simply because there are many different accounts, people, and agencies involved in the act of paying an employee's salary.</para>
-  <para>Payroll is typically accounted for as an expense.  Sometimes, accountants will "store" some payroll expenses in a short term liability account.  This is useful for things such as payroll taxes, which may be paid to the government at a different times from paying employee salaries.  This chapter will present a methodology which expenses payroll immediately for salaries, but store taxes in a liability account.</para>
+  <para>Payroll is a financial record of wages, net pay, paid vacations, and deductions for an employee.  Basically, anything that relates to giving money or benefits to an employee.  Payroll is one of the more complex tasks in accounting, because there are many different accounts, people, and agencies involved in paying salaries.</para>
+  <para>Payroll is typically accounted for as an expense.  Sometimes accountants "store" some payroll expenses in a short term liability account.  This is useful for things such as payroll taxes, which may be paid at a different time than the employee.  The employee might get paid biweekly, while taxes are paid quarterly.  This chapter presents a methodology which expenses payroll immediately for salaries, but stores taxes in liability accounts.</para>
   <note>
-  <para>GnuCash does not (yet) have an integrated payroll system.  What this means is that while you can track payroll expenses in GnuCash, the actual calculation of taxes and deductions will have to be done outside of GnuCash.</para>
+  <para>GnuCash does not have an integrated payroll system.  While you can track payroll expenses in GnuCash, the calculation of taxes and deductions has to be done outside of GnuCash.</para>
   </note>
   </sect1>
-  
- <sect1 id="bus_pay_acct1">
+
+ <sect1 id="bus-pay-acct1">
  <title>Account Setup</title>
-  <para>Some considerations that must be addressed when setting up your accounts is how your local tax laws work.  Because there are so many different ways payroll taxes can be handled throughout the world, this section will present a simple structure.  From this, you should be able to adapt your particular payroll deductions setup.</para>
-  <para>Let us assume that you must pay 2 taxes, Tax1 and Tax2 and that each has an employee contributed component and an employer contributed component.</para>
-  <para>The employee's salary and these two taxes will have to have expense accounts associated, and the taxes will have to have liability accounts.  The tax liability account is the place where you accumulate the withheld taxes for all of your employees, which is later paid to the appropriate government agency.</para>
+
+  <para>Local tax law must be considered when setting up accounts.  Because there are many different ways payroll taxes are handled throughout the world, this section presents a very simple structure.  From this, you should be able to adapt your particular payroll deductions setup.</para>
+  <para>Assume that you must pay 2 taxes, Tax1 and Tax2 and that each has an employee contributed and an employer contributed component.</para>
+  <para>The employee's salary and these two taxes are expense accounts. The tax components are liability accounts.  The tax liability accounts are where you accumulate the taxes withheld for all of your employees.  The taxes are later paid to the appropriate government agency.</para>
   <para>
   <literallayout>
 Simple Payroll Account Layout:
@@ -38,23 +40,26 @@
    -Tax2  (short term "storage" account)
 -Expenses
    -Salaries
-   -Taxes
+   -Tax1
+   -Tax2
   </literallayout>
 
   <note>
-  <para>There is a temptation to create per-employee sub-accounts, to track each employee separately.  However, this often leads to unmanageably large lists of accounts.  Imagine how your account structure would look after a few years of employees coming and going in your company.  It is much simpler to keep all of your employees payroll records within a single account (Expense:Salaries for example) and use reports to view per-employee information.</para>
+  <para>Resist the temptation to create per-employee sub-accounts to track individual salaries.  Creating a sub-account for each employee leads to unmanageably large lists of accounts.  Imagine the account structure after a few years of employees coming and going.  It is much simpler to keep all of your employees' payroll records within a single account (Expenses:Salaries for example) and use reports to view per-employee information.</para>
   </note>
   </para>
 
   </sect1>
 
- <sect1 id="bus_pay_protocol1">
+ <sect1 id="bus-pay-protocol1">
  <title>Protocol</title>
-  <para>GnuCash does not (yet) have an integrated payroll system.  You can use GnuCash to track your payroll expenses, but you will need to develop a payroll protocol and perform the calculations outside of GnuCash, in a spreadsheet for example.  In this section, one such protocol is presented, which you can use as a model.</para>
+  <para>GnuCash does not have an integrated payroll system.  GnuCash can track your payroll expenses, but you need to develop a payroll protocol and perform the calculations outside of GnuCash, in a spreadsheet for example.  In this section, one such protocol is presented. You can use the sample protocol as a model.</para>
 
-  <sect2 id="bus_pay_protocolone2">
+  <sect2 id="bus-pay-protocolone2">
   <title>Step 1: Deductions list</title>
-  <para>The first step to the payroll protocol is to create a list of all the possible taxes and deductions for each employee, which should include definitions and formulas for calculating each value.  This step of the protocol will only need to be done once, and again in the future when the payroll laws or tax rates change.  For our simple payroll situation with the two taxes, such a list would look like this:</para>
+  <para>The first step to the payroll protocol is to create a list of all the possible taxes and deductions for each employee.  Each entry should include definitions and formulas for calculating each value.  Once the protocol is established it needs to be changed only when payroll laws or tax rates change.</para>
+
+ <para>In the proposed scenario, such a list would look like this:</para>
   <itemizedlist spacing="compact">
   <listitem>
   <para><emphasis>E_GROSS_SALARY</emphasis> - Employee gross salary</para>
@@ -75,23 +80,25 @@
   <note>
   <para>The employee's net salary (E_NET_SALARY) is defined as E_GROSS_SALARY - E_TAX1 - E_TAX2 and need not be placed in this list since it is composed of items that already exist.</para>
   </note>
-  <para>You will want to place the actual formulas for calculating each deduction in this list.  Sometimes, these formulas can be quite complex, and sometimes the formula may simply say "look this number up in table XYZ of the tax codes."</para>
-  <para>Notice that you can calculate some interesting values using the above definitions, such as the total cost to the company: E_GROSS_SALARY + C_TAX1 + C_TAX2.</para>
+  <para>Place the actual formulas for calculating each deduction in this list.  Sometimes these formulas are quite complex, and sometimes they simply say "look it up in table XYZ of the tax codes".</para>
+  <para>Notice that you can calculate some interesting values using the above definitions.  One such value is the total cost to the company: E_GROSS_SALARY + C_TAX1 + C_TAX2.</para>
   </sect2>
 
-  <sect2 id="bus_pay_protocoltwo2">
+  <sect2 id="bus-pay-protocoltwo2">
   <title>Step 2: Create the Transaction Map</title>
-  <para>When you record payroll in GnuCash, it is done with a single split transaction.  This split transaction will populate the appropriate expense and liability accounts.  If, in the future, you want to discover any of the payroll details for a particular employee, simply open the split transaction.</para>
-  <para>With the deductions list from above in hand, an employee split transaction map can be generated which maps each of the items in the list to a GnuCash account.</para>
+  <para>When you record payroll in GnuCash, do so with a single split transaction.  This split transaction populates the appropriate expense and liability accounts.  If you need to look the payroll details at a later time, open the split transaction.</para>
+  <para>With the deductions list from above, an employee split transaction map can be generated.  Each of the items in the list is mapped to a GnuCash account.</para>
 
   <para>
   <table>
   <title>Transaction Map</title>
   <tgroup cols="3">
-  <tbody>
+  <thead>
   <row>
 <entry>Account</entry><entry>Increase</entry><entry>Decrease</entry>
   </row>
+  </thead>
+  <tbody>
   <row>
 <entry>Assets:Checking</entry><entry></entry><entry>E_NET_SALARY</entry>
   </row>
@@ -120,32 +127,36 @@
   </tgroup>
   </table>
   </para>
+
+  <para>Note that the C_TAX1 and C_TAX2 components have entries in the both the liability and expense accounts.  The company component of each tax is expensed at the time of payroll, but remains a liability until taxes are due.</para>
   </sect2>
 
-  <sect2 id="bus_pay_protocolthree2">
+  <sect2 id="bus-pay-protocolthree2">
   <title>Step 3: Pay the Employee</title>
-  <para>Go to the account from which the employee will be paid, for example your Asset:Checking account. Open a split transaction and enter the real values using the Transaction Map above as a guide.  Repeat this for all employees.</para>
+  <para>Go to the account from which the employee will be paid, for example your Assets:Checking account. Open a split transaction and enter the real values using the Transaction Map above as a guide.  Repeat this for all employees.</para>
   <tip>
-  <para>This manual process is tedious, especially if you have a large number of employees.  One GnuCash tool you will certainly want to make use of when entering employee payroll is duplicate transaction (use the <guibutton>Duplicate</guibutton> tool bar button).  Using this will save you from having to enter all the transaction splits for each employee.  You will still need to change the amounts of money to match each employee's real payroll values, but at least you do not need to build the split each time.</para>
+  <para>This manual process is tedious, especially if you have a large number of employees.</para>
+  <para>One GnuCash tool you certainly want use when entering employee payroll is duplicate transaction (use the <guibutton>Duplicate</guibutton> tool bar button).  This saves you from having to enter all the transaction splits for each employee.  You still need to change the amounts of money to match each employee's real payroll values, but you will not have to build the split for each employee.</para>
+  <para>If payroll transactions do not change significantly every pay period, you can also use the duplicate transaction feature to duplicate each employee's most recent payroll transaction for the current pay period.  If you find you are doing so all the time, read about the Schedule Transactions feature and save even more time!</para>
   </tip>
   </sect2>
 
-  <sect2 id="bus_pay_protocolfour2">
+  <sect2 id="bus-pay-protocolfour2">
   <title>Step 4: Pay the Government</title>
-  <para>The final thing to do is to pay the taxes to the government.  The liability accounts have been collecting the taxes for various government agencies, and periodically you will need to send a check to the government to pay this charge.  To do so, you simply enter a 2 account transaction in (for example) your checking account to pay off the tax liability.  The transaction will be between the checking account and the liability account, no expense account are involved.</para>
+  <para>The final thing to do is to pay the taxes to the government.  The liability accounts have been collecting the taxes for various government agencies, and periodically you need to send a check to the government to pay this charge.  To do so, you simply enter a 2 account transaction in (for example) your checking account to pay off the tax liability.  The transaction is between the checking account and the liability account, no expense account is involved.  The expense accounts are charged at the time the tax liability is recorded.</para>
   </sect2>
 
   </sect1>
   
- <sect1 id="bus_pay_example1">
+ <sect1 id="bus-pay-example1">
  <title>Example</title>
   <para>Using the account setup seen previously, let's go through an example.  Assume that there are 2 employees (E1 and E2) which each earn $1000 per month gross salary. The employee contribution to Tax1 and Tax2 are 10% and 5% respectively.  The company contribution to Tax1 and Tax2 are 15% and 10% each on top of the employees gross salary.</para>
   <para>Staring with $50k in the bank, and before doing any payroll, the account hierarchy looks like this:</para>
-	<screenshot id="bus_pay_ex1">
+	<screenshot id="bus-pay-ex1">
 	  <mediaobject>
 	    <imageobject>
 	      <imagedata fileref="figures/bus_pay_ex1.png" 
-	      srccredit="Jon Lapham" format="PNG"/>
+	      srccredit="Patrick Schweiger" format="PNG"/>
             </imageobject>
 	    <textobject>
 	        <phrase>Payroll Example 1</phrase>
@@ -157,7 +168,7 @@
           </mediaobject>
         </screenshot>
 
-  <sect2 id="bus_pay_exampleprotocol2">
+  <sect2 id="bus-pay-exampleprotocol2">
   <title>Build Protocol</title>
   <para>The deductions list for employee 1:</para>
    <itemizedlist>
@@ -182,10 +193,12 @@
   <table>
   <title>Transaction Map for Employee 1</title>
   <tgroup cols="3">
-  <tbody>
+  <thead>
   <row>
 <entry>Account</entry><entry>Increase</entry><entry>Decrease</entry>
   </row>
+  </thead>
+  <tbody>
   <row>
 <entry>Assets:Checking</entry><entry></entry><entry>$850 (E_NET_SALARY)</entry>
   </row>
@@ -218,16 +231,16 @@
   </sect2>
 
 
-  <sect2 id="bus_pay_examplepay2">
+  <sect2 id="bus-pay-examplepay2">
   <title>Pay an Employee</title>
 
-  <para>Now, enter the first split transaction for employee 1 in the checking account.  The split transaction will look like this:</para>
+  <para>Now, enter the first split transaction for employee 1 in the checking account.  The split transaction looks like this:</para>
 
-	<screenshot id="bus_pay_ex2">
+	<screenshot id="bus-pay-ex2">
 	  <mediaobject>
 	    <imageobject>
 	      <imagedata fileref="figures/bus_pay_ex2.png" 
-	      srccredit="Jon Lapham" format="PNG"/>
+	      srccredit="Patrick Schweiger" format="PNG"/>
             </imageobject>
 	    <textobject>
 	        <phrase>Payroll Example 2</phrase>
@@ -240,15 +253,15 @@
         </screenshot>
 
   <tip>
-  <para>When paying employees, enter only the employee name in the Description area.  If you decide to use GnuCash's check printing capabilities, the check will automatically be made out to the employee correctly.  If you want to record other information in the transaction besides the employee name, use the Notes area, available when viewing the Register in double-line mode.</para>
+  <para>When paying employees, enter only the employee name in the Description area.  If you decide to use GnuCash's check printing capabilities, the check is automatically made out to the correct employee.  If you want to record other information in the transaction besides the employee name, use the Notes area, available when viewing the Register in double-line mode.</para>
   </tip>
   <para>Repeat this for the second employee, which leaves the account hierarchy looking like this:</para>
 
-	<screenshot id="bus_pay_ex3">
+	<screenshot id="bus-pay-ex3">
 	  <mediaobject>
 	    <imageobject>
 	      <imagedata fileref="figures/bus_pay_ex3.png" 
-	      srccredit="Jon Lapham" format="PNG"/>
+	      srccredit="Patrick Schweiger" format="PNG"/>
             </imageobject>
 	    <textobject>
 	        <phrase>Payroll Example 3</phrase>
@@ -260,15 +273,15 @@
           </mediaobject>
         </screenshot>
   </sect2>
-  <sect2 id="bus_pay_examplegovt2">
+  <sect2 id="bus-pay-examplegovt2">
   <title>Pay the Government</title>
-  <para>The Liability:Tax1 and Liability:Tax2 accounts will continue to track how much you must pay to the government agencies responsible for each.  When it is time to pay these agencies, make a transaction from the checking account to the liability accounts.  No expense accounts are involved.  The main account will then appear like this for this example:</para>
+  <para>The Liabilities:Tax1 and Liabilities:Tax2 accounts continue to track how much you must pay to the government agencies responsible for each.  When it is time to pay these agencies, make a transaction from the checking account to the liability accounts.  No expense accounts are involved.  The main account will then appear like this for this example:</para>
 
-	<screenshot id="bus_pay_ex4">
+	<screenshot id="bus-pay-ex4">
 	  <mediaobject>
 	    <imageobject>
 	      <imagedata fileref="figures/bus_pay_ex4.png" 
-	      srccredit="Jon Lapham" format="PNG"/>
+	      srccredit="Patrick Schweiger" format="PNG"/>
             </imageobject>
 	    <textobject>
 	        <phrase>Payroll Example 4</phrase>

Modified: gnucash-docs/trunk/guide/C/ch_currency.xml
===================================================================
--- gnucash-docs/trunk/guide/C/ch_currency.xml	2006-05-24 04:17:56 UTC (rev 14171)
+++ gnucash-docs/trunk/guide/C/ch_currency.xml	2006-05-24 05:08:42 UTC (rev 14172)
@@ -1,4 +1,3 @@
-<?xml version="1.0" encoding="UTF-8"?>
 <!--
       (Do not remove this comment block.)
   Version: 1.9.0
@@ -312,7 +311,7 @@
          If the <guibutton>Get Quotes</guibutton> button is disabled, 
          that means that the perl module Finance::Quote is not installed. 
          For information on how to install it, please see 
-         <xref linkend="invest_stockprice_auto2" ></xref>
+         <xref linkend="invest-stockprice-auto2" ></xref>
       </para></note>
 
       <para><screenshot id="currency_AfterGetOnlineQuotes">
@@ -335,7 +334,7 @@
       currencies you are using in your various accounts. This will happend
       everytime you click on <guibutton>Get Quotes</guibutton> or have GnuCash
       downloading quotes/exchange rates automatically as per <xref
-      linkend="invest_stockprice_auto2" /></para>
+      linkend="invest-stockprice-auto2" /></para>
 
       <para>And if you check the main Chart of Accounts you now see that
       GnuCash has automatically converted the HKD amount to USD amount on the
@@ -421,13 +420,12 @@
 -Assets                          (USD)
    -Current Assets           (USD)
       -US Bank                 (USD)
-      -Jamaican Bank       (EUR)
-   -Fixed Assets
-      -Boat
+      -Jamaican Bank       (JMD)
+   -Fixed Assets           (USD)
+      -Boat                (JMD)
 -Equity                          (USD)
    -Opening Balances
       -USD            (USD)
-      -EUR            (HKD)
 
 Note: the currency of each account is shown in parenthesis.
  </literallayout>
@@ -513,6 +511,13 @@
           boat</para></caption>
         </mediaobject>
       </screenshot>
+      <para>The Chart of Accounts now reflects that your bank account has been 
+      reduced with the value of the boat (JMD 509,000), and that your Fixed Assets
+      boat account has been increased with the same amount. If you also have turned
+      on the CoA (Column Choice) "Total (USD)" you will see the corresponding
+      value in USD. The USD value will always reflect the latest currency exchange
+      rate you have either automatically or manually updated GnuCash with.
+      </para>
     </sect2>
 
     <sect2 id="currency_purchase3">
@@ -629,8 +634,8 @@
       <para>If the "Exchange Data" dialog popup do not appear, open it
       manually by right click on the last row, and select <guilabel>Edit
       Exchange Rate</guilabel> In the following pop up window, enter the
-      actual number of stocks (16,500) in the last entry box (not the 
-      default entry box)</para>
+      actual number of stocks (16,500) as the <guilabel>To Amount:</guilabel> 
+      </para>
       
       <screenshot id="currency_purchase_ToAmount.png">
         <mediaobject>
@@ -772,7 +777,7 @@
       <para>Entering an currency you are selling is done in the same way as
       buying one except the you are now transfering money from the Currency
       account to your Savings account (very much similar to (<xref
-      linkend="invest_sell1" />).</para>
+      linkend="invest-sell1" />).</para>
 
       <para>The proper recording of the currency sale *must* be done using a
       split transaction. In the split transaction, you must account for the
@@ -1206,9 +1211,10 @@
       Remember to execute the transaction from the stocks associated bank
       account, and if the Exchange Rate window do not pop up, right click the
       row and manually start it. Enter the number of stocks you purchase in
-      the last entry.</para>
+      the last entry (To Amount:).</para>
 
-      <para><table>
+      <para>
+        <table>
           <title>Purchasing oversea stocks</title>
 
           <tgroup cols="4">
@@ -1254,14 +1260,37 @@
               </row>
             </tbody>
           </tgroup>
-        </table></para>
+        </table>
+      </para>
+        
+      <para>As you can see in the Chart of Accounts, you have now purchased stocks in three
+      different currencise (HK, USD, as well as in SEK), but the Chart of Account (as seen below)
+      do not indicate how much it is valued in your home currency, AUD.</para>
+      <screenshot id="currency_PutTogether_AfterStocks.png">
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="figures/currency_PutTogether_AfterStocks.png"
+                       format="PNG" srccredit="Bengt Thuree" />
+          </imageobject>
+
+          <textobject>
+            <phrase>Chart of Account after Stocks</phrase>
+          </textobject>
+          <caption><para>
+            Some of the accounts in Chart of Accounts after the stock purchase
+          </para></caption>
+        </mediaobject>
+      </screenshot>
+
+      <para>Next section will ensure you get the various exchange rates so GnuCash can show your
+      total worth in the local currency (AUD in this case)</para>
     </sect2>
 
     <sect2>
       <title>Get the online quotes</title>
 
       <para>To get the current exchange rates and stock quotes, go to
-      <guimenu>Tools</guimenu> -&gt; <guimenu>Price Editor</guimenu> and the
+      <guimenu>Tools</guimenu> -&gt; <guimenu>Price Editor</guimenu> and then
       click on <guibutton>Get Quotes</guibutton>. </para>
 
       <para></para>
@@ -1273,12 +1302,20 @@
 
       <para>Peter has run into some difficulties all the way over in Europe
       Land. Since he is a very dear pal of yours, you decide to help him out
-      with a personal loan of 80,000 Euro. </para>
+      with a personal loan of 40,000 Euro.</para>
 
-      <para><literallayout>Assets:Money owed to me:Euro:Peter            (Euro)
-Income:Interest Income:Peter                  (Euro)</literallayout>This is a
-      simpe currency transaction from your Savings Account (AUD), to your
-      Assets:Money owed to me:Peter (EURO) account. </para>
+      <para>
+        <literallayout>
+Assets:Money owed to me:Euro:Peter            (Euro)
+Income:Interest Income:Peter                  (Euro)
+Expenses:Bank Charge                          (AUD)
+        </literallayout>
+      </para>
+      <para>This is a
+        simpe currency transaction from your Savings Account (AUD), to your
+        Assets:Money owed to me:Peter (EURO) account. You got the exchange rate
+        of 0.606161, which means you need to withdraw AUD 65,989.10, as well as
+        pay the service fee of 35 AUD.</para>
     </sect2>
 
     <sect2>
@@ -1380,4 +1417,4 @@
     
   </sect1>
   
-</chapter>
\ No newline at end of file
+</chapter>

Modified: gnucash-docs/trunk/guide/C/ch_invest.xml
===================================================================
--- gnucash-docs/trunk/guide/C/ch_invest.xml	2006-05-24 04:17:56 UTC (rev 14171)
+++ gnucash-docs/trunk/guide/C/ch_invest.xml	2006-05-24 05:08:42 UTC (rev 14172)
@@ -1,7 +1,9 @@
 <!--
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
       (Do not remove this comment block.)
   Version: 2.0.0
-  Last modified: April 27, 2006
+  Last modified: May 15, 2006
   Version: 1.8.4
   Last modified: April 10th 2004
   Maintainers: 
@@ -478,7 +480,8 @@
     shares of stock purchased from before you started using GnuCash. For these stocks,
     follow the instructions in the <link linkend="invest-buy-stock2"><emphasis>Entering
     Preexisting Shares</emphasis></link> section below. If your have just purchased your stocks,
-    then use the <link linkend="invest-buy-new2"><emphasis>Buying New Shares</emphasis></link> section.</para>
+    then use the <link linkend="invest-buy-new2"><emphasis>Buying New Shares</emphasis>
+    </link> section.</para>
 
     <sect2 id="invest-setup-stockaccounts2">
       <title>Setup Accounts for Stocks and Mutual Funds</title>
@@ -960,7 +963,7 @@
     </sect2>
 
     <sect2 id="invest-stockprice-auto2">
-      <title>Setting Stock Price Automatically</title>
+      <title>Configuring for automatic retrieval of quotes</title>
 
       <para>If you have more than a couple of commodities, you will tire of
       having to update their prices constantly. GnuCash has the ability to
@@ -1022,10 +1025,10 @@
         can be used to fetch the current prices of your stocks.  The file specified
         <quote>$HOME/gnucash-filename</quote> will depend on the name and location of your
         data file.
-        This can be determined by <quote>File -&gt; Open -&gt; Open</quote> the highlighted
-        file name will be highlighted, the directory path will be displayed above
-        the file listings.  The file name can also be found <quote>File -&gt;</quote> the item
-        numbered 1 is the name of the currently open file.</para>
+        This can be determined by the name displayed in the top frame of the GnuCash window,
+        before the <quote>-</quote>.  The file name can also be found <quote>File -&gt;</quote>
+        <quote>pull down list</quote>, the first item, numbered 1, is the name of the currently
+        open file.</para>
 
         <para>This can be automated by creating a crontab entry. For example,
         to update your file every Friday evening (16:00) after the relevant exchange
@@ -1610,6 +1613,286 @@
 
   </sect1>
 
+<!--  Stock Splits - Simple
+
+-->
+
+  <sect1 id="invest-splitsnmergers1">
+    <title>Splits and Mergers</title>
+
+    <para>Companies may split their stock for many reasons but the most common
+    is that the price has risen higher than management thinks is a reasonable price for
+    many investors. Some of these splits are simple exchanges (eg 2 for 1 or 3 for 2)
+    and some are complex exchanges with cash distributions.  Splits may also result in
+    fewer shares if the exchange rate is a reverse split (1 for 3 or .75 for 1).
+
+    </para>
+
+      <sect2 id="invest-simplesplit">
+        <title>Simple Stock Split</title>
+
+      <para>As an example, our holding of NST stock declared a 2 for 1 stock split effective
+      June 6, 2005.  The process for entering this transaction is; select 
+      <guimenu>Action</guimenu> -&gt; <guimenu>Stock Split</guimenu> to start
+      the druid.</para>
+
+      <screenshot id="invest-split1">
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="figures/invest_split1.png"
+                       format="PNG" srccredit="Dave Herman" ></imagedata>
+          </imageobject>
+
+          <textobject>
+            <phrase>An image of the stock split druid at step 1. </phrase>
+          </textobject>
+
+          <caption><para>An image of the selection of the stock split druid. </para></caption>
+        </mediaobject>
+      </screenshot>
+
+      <para>The first screen is an Introduction, select <guimenu>Forward</guimenu> to
+      display the selection of the account and stock for the split.  You will need to
+      create an entry for each <emphasis>Account:Stock</emphasis> combination you hold.</para>
+
+      <screenshot id="invest-split2">
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="figures/invest_split2.png"
+                       format="PNG" srccredit="Dave Herman" ></imagedata>
+          </imageobject>
+
+          <textobject>
+            <phrase>An image of the stock split druid at step 2 - Selection of Account/Stock.
+            </phrase>
+          </textobject>
+
+          <caption><para>An image of the stock split druid at step 2 - Selection of 
+           Account/Stock.</para></caption>
+        </mediaobject>
+      </screenshot>
+
+
+      <para>Select the <quote>Assets:Investments:DRIPs:NST</quote> and click on
+      <guimenu>Forward</guimenu>.</para>
+
+      <para>The next screen presents 5 fields in the Stock Splits Details window:</para>
+
+      <itemizedlist>
+        <listitem>
+          <para><guilabel>Date</guilabel> - Enter the date of the split.</para>
+        </listitem>
+
+        <listitem>
+          <para><guilabel>Shares</guilabel> -  The number of shares increased (or decreased)
+          in the transaction.</para>
+          <para>In our example it is a 2 for 1 split so the number of additional shares
+          is the number of shares currently in the register.</para>
+        </listitem>
+
+        <listitem>
+          <para><guilabel>Description</guilabel> - The Description should give a brief
+          explanation of the transaction.</para>
+        </listitem>
+
+        <listitem>
+          <para><guilabel>New Price</guilabel> - If desired the new price of the stock,
+          after the split, may be entered.</para>
+        </listitem>
+
+        <listitem>
+          <para><guilabel>Currency</guilabel> - The currency of the transaction
+          is required.  This should be the same as the stock purchase currency.</para>
+        </listitem>
+
+      </itemizedlist>
+            
+      <para>Click on the <guimenu>Forward</guimenu> button.</para>
+
+      <screenshot id="invest-split3">
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="figures/invest_split3.png"
+                       format="PNG" srccredit="Dave Herman" ></imagedata>
+          </imageobject>
+
+          <textobject>
+            <phrase>An image of the stock split druid at step 3 - Split Details. </phrase>
+          </textobject>
+
+          <caption><para>An image of the stock split druid at step 3 - Split Details. </para>
+          </caption>
+        </mediaobject>
+      </screenshot>
+
+
+      <para>The next screen will be skipped in this example as there was no
+      <quote>Cash in Lieu</quote>.
+      </para>
+
+      <screenshot id="invest-split4">
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="figures/invest_split4.png"
+                       format="PNG" srccredit="Dave Herman" ></imagedata>
+          </imageobject>
+
+          <textobject>
+            <phrase>An image of the stock split druid at step 4 - Cash in Lieu. </phrase>
+          </textobject>
+
+          <caption><para>An image of the stock split druid at step 4 - Cash in Lieu. </para>
+          </caption>
+        </mediaobject>
+      </screenshot>
+
+      <para>A final <quote>Finish</quote> screen will give a last option to;
+       <guimenu>Cancel</guimenu>, <guimenu>Back</guimenu> to modify any data entered or
+       <guimenu>Apply</guimenu> to complete the stock split with the data entered. </para>
+
+      <screenshot id="invest-simplesplit1">
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="figures/invest_simplesplit1.png"
+                       format="PNG" srccredit="Dave Herman" ></imagedata>
+          </imageobject>
+
+          <textobject>
+            <phrase>Example of simple stock split transaction in the stock's register</phrase>
+          </textobject>
+
+          <caption><para>An image of the <quote>Assets:Investments:DRIPs:NST</quote>
+          register after a simple stock split transaction. </para></caption>
+        </mediaobject>
+      </screenshot>
+
+    </sect2>
+
+<!--  Moderately Complex Stock Merger
+
+-->
+
+      <sect2 id="invest-merger1">
+        <title>Moderately Complex Stock Merger</title>
+
+      <para>As an example, assume you held AT&amp;T stock during the Nov. 18, 2005 merger of SBC
+      with AT&amp;T. For this example you will have purchased AT&amp;T on April 1, 2005, any
+      dividends will have been paid in cash, therefore not entered into the AT&amp;T
+      stock register. </para>
+
+      <para> The conditions of the merger were .77942 share of SBC stock were exchanged for
+      each share of AT&amp;T stock.  The merged company continued to use the symbol
+      <quote>T</quote> from AT&amp;T.</para>
+
+      <para>AT&amp;T paid a <quote>dividend</quote> of $1.20/share on the transaction date,
+      however this will not appear in the stock account as it was a cash distribution.</para>
+
+      <para>The process for entering this transaction is identical to the simple split until
+      the <quote>Details</quote> screen.  You will need to create an split entry in each
+      <emphasis>Investment Account:Stock</emphasis> account combination that has shares
+      splitting.</para>
+
+      <screenshot id="invest-merge2">
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="figures/invest_merge2.png"
+                       format="PNG" srccredit="Dave Herman" ></imagedata>
+          </imageobject>
+
+          <textobject>
+            <phrase>An image of the stock split druid at step 2. </phrase>
+          </textobject>
+
+          <caption><para>An image of the stock split druid at step 2 - Selection of 
+           Account/Stock (Investment Account:T).</para></caption>
+        </mediaobject>
+      </screenshot>
+
+
+      <para>Select the <quote>Assets:Investments:Brokerage Account:Stock:T</quote> and click on
+      <guimenu>Forward</guimenu>.</para>
+
+      <para>The next screen presents 5 fields in the Stock Splits Details window:</para>
+
+      <itemizedlist>
+        <listitem>
+          <para><guilabel>Date</guilabel> - Enter the date of the split.  Here we'll enter
+           November 18, 2005.</para>
+        </listitem>
+
+        <listitem>
+          <para><guilabel>Shares</guilabel> -  The number of shares increased (or decreased)
+          in the transaction.</para>
+          <para>In our example it is a .77942 for 1 split so the number of shares will
+          decrease from the number of shares currently in the register.  You may use GnuCash's
+          ability to preform calculations on an entry form by entering data directly
+          (E.g. <quote>(.77942*100)-100</quote>) to calculate the decrease in shares
+          from the split.</para>
+        </listitem>
+
+        <listitem>
+          <para><guilabel>Description</guilabel> - The Description should give a brief
+          explanation of the transaction.</para>
+        </listitem>
+
+        <listitem>
+          <para><guilabel>New Price</guilabel> - If desired the new price of the stock,
+          after the split, may be entered.</para>
+        </listitem>
+
+        <listitem>
+          <para><guilabel>Currency</guilabel> - The currency of the transaction
+          is required.  This should be the same as the stock purchase currency.</para>
+        </listitem>
+
+      </itemizedlist>
+            
+      <para>Click on the <guimenu>Forward</guimenu> button.</para>
+
+      <screenshot id="invest-merge3">
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="figures/invest_merge3.png"
+                       format="PNG" srccredit="Dave Herman" ></imagedata>
+          </imageobject>
+
+          <textobject>
+            <phrase>An image of the stock split druid at step 3. </phrase>
+          </textobject>
+
+          <caption><para>An image of the stock split druid at step 3 - Split Details. </para></caption>
+        </mediaobject>
+      </screenshot>
+
+      <para>The next screen will be skipped in this example as there was no
+      <quote>Cash in Lieu</quote>.
+      </para>
+
+      <para>A final <quote>Finish</quote> screen will give a last option to
+      <guimenu>Back</guimenu> to modify any data entered or <guimenu>Apply</guimenu>
+      to complete the stock split with the data entered. </para>
+
+      <screenshot id="invest-stockmerge1">
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="figures/invest_stockmerge1.png"
+                       format="PNG" srccredit="Dave Herman" ></imagedata>
+          </imageobject>
+
+          <textobject>
+            <phrase>Example of moderate stock split transaction in the stock's register</phrase>
+          </textobject>
+
+          <caption><para>An image of the Investment Account:T register after a
+           stock split transaction that decreases the shares. </para></caption>
+        </mediaobject>
+      </screenshot>
+
+    </sect2>
+
+  </sect1>
+
+
   <sect1 id="invest-todo1">
     <title>To-do</title>
 
@@ -1617,9 +1900,20 @@
     appeared in the 1.8.4 documentation which require being written up.</para>
 
     <itemizedlist>
+
+<!--  Working Location  !!!!!!!!!!!!
+
+
+-->
+
+<!--
       <listitem>
         <para>Recording Stock Splits and Mergers (How-To)</para>
       </listitem>
+-->
+      <listitem>
+        <para>Reconciling with the Brokerage Statement (How-To)</para>
+      </listitem>
 
       <listitem>
         <para>Recording Employee Stock Plans (Discussion)</para>
@@ -1629,9 +1923,6 @@
         <para>Stock Options (How-To)</para>
       </listitem>
 
-      <listitem>
-        <para>Reconciling with the Brokerage Statement (How-To)</para>
-      </listitem>
     </itemizedlist>
   </sect1>
 </chapter>

Modified: gnucash-docs/trunk/guide/C/figures/bus_ap_billedit.png
===================================================================
(Binary files differ)

Modified: gnucash-docs/trunk/guide/C/figures/bus_ap_billnew.png
===================================================================
(Binary files differ)

Modified: gnucash-docs/trunk/guide/C/figures/bus_ap_billpost.png
===================================================================
(Binary files differ)

Modified: gnucash-docs/trunk/guide/C/figures/bus_ap_jobnew.png
===================================================================
(Binary files differ)

Modified: gnucash-docs/trunk/guide/C/figures/bus_ap_payment.png
===================================================================
(Binary files differ)

Modified: gnucash-docs/trunk/guide/C/figures/bus_ap_vendorfind.png
===================================================================
(Binary files differ)

Modified: gnucash-docs/trunk/guide/C/figures/bus_ap_vendornew.png
===================================================================
(Binary files differ)

Modified: gnucash-docs/trunk/guide/C/figures/bus_pay_ex1.png
===================================================================
(Binary files differ)

Modified: gnucash-docs/trunk/guide/C/figures/bus_pay_ex2.png
===================================================================
(Binary files differ)

Modified: gnucash-docs/trunk/guide/C/figures/bus_pay_ex3.png
===================================================================
(Binary files differ)

Modified: gnucash-docs/trunk/guide/C/figures/bus_pay_ex4.png
===================================================================
(Binary files differ)

Added: gnucash-docs/trunk/guide/C/figures/currency_PutTogether_AfterStocks.png
===================================================================
(Binary files differ)


Property changes on: gnucash-docs/trunk/guide/C/figures/currency_PutTogether_AfterStocks.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: gnucash-docs/trunk/guide/C/figures/invest_merge2.png
===================================================================
(Binary files differ)


Property changes on: gnucash-docs/trunk/guide/C/figures/invest_merge2.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: gnucash-docs/trunk/guide/C/figures/invest_merge3.png
===================================================================
(Binary files differ)


Property changes on: gnucash-docs/trunk/guide/C/figures/invest_merge3.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: gnucash-docs/trunk/guide/C/figures/invest_simplesplit1.png
===================================================================
(Binary files differ)


Property changes on: gnucash-docs/trunk/guide/C/figures/invest_simplesplit1.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: gnucash-docs/trunk/guide/C/figures/invest_split1.png
===================================================================
(Binary files differ)


Property changes on: gnucash-docs/trunk/guide/C/figures/invest_split1.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: gnucash-docs/trunk/guide/C/figures/invest_split2.png
===================================================================
(Binary files differ)


Property changes on: gnucash-docs/trunk/guide/C/figures/invest_split2.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: gnucash-docs/trunk/guide/C/figures/invest_split3.png
===================================================================
(Binary files differ)


Property changes on: gnucash-docs/trunk/guide/C/figures/invest_split3.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: gnucash-docs/trunk/guide/C/figures/invest_split4.png
===================================================================
(Binary files differ)


Property changes on: gnucash-docs/trunk/guide/C/figures/invest_split4.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: gnucash-docs/trunk/guide/C/figures/invest_split5.png
===================================================================
(Binary files differ)


Property changes on: gnucash-docs/trunk/guide/C/figures/invest_split5.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream

Added: gnucash-docs/trunk/guide/C/figures/invest_stockmerge1.png
===================================================================
(Binary files differ)


Property changes on: gnucash-docs/trunk/guide/C/figures/invest_stockmerge1.png
___________________________________________________________________
Name: svn:mime-type
   + application/octet-stream



More information about the gnucash-changes mailing list