gnucash-docs maint: Multiple changes pushed
Geert Janssens
gjanssens at code.gnucash.org
Mon Jun 6 13:40:05 EDT 2016
Updated via https://github.com/Gnucash/gnucash-docs/commit/c768b012 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/df47fc56 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/cef453cb (commit)
from https://github.com/Gnucash/gnucash-docs/commit/96699629 (commit)
commit c768b012db3216d835f1f4e3220ce75323cf7904
Author: Chris Good <chris.good at ozemail.com.au>
Date: Mon Apr 18 10:09:46 2016 +1000
Document Investment Return of Capital in the Guide - Bug 765131
diff --git a/guide/C/ch_invest.xml b/guide/C/ch_invest.xml
index f8a6d7f..8902034 100644
--- a/guide/C/ch_invest.xml
+++ b/guide/C/ch_invest.xml
@@ -1881,6 +1881,73 @@ Income
</sect2>
</sect1>
+
+ <sect1 id="invest-retofcap">
+ <title>Return of Capital</title>
+
+ <para>This refers to a transaction where an investment returns capital to
+ the investor and doesn't have any accounting implications other than
+ reducing the cost basis. The number of shares held is not changed.
+ </para>
+
+ <para>A Return of Capital transaction can be entered in the stock register
+ by entering the stock split with
+ </para>
+
+ <informaltable>
+ <tgroup cols="2">
+ <tbody>
+ <row>
+ <entry>Shares</entry><entry>0</entry>
+ </row>
+
+ <row>
+ <entry>Price</entry><entry>0</entry>
+ </row>
+
+ <row>
+ <entry>Sell</entry><entry>Return of Capital value</entry>
+ </row>
+
+ </tbody>
+ </tgroup>
+ </informaltable>
+
+ <para>The other side of the double entry would usually be a debit to the
+ brokerage bank account.
+ </para>
+
+ <screenshot id="invest-ret-of-cap">
+ <mediaobject>
+ <imageobject role="html">
+ <imagedata fileref="figures/invest_ret_of_cap.png" format="PNG"
+ srccredit="Chris Good" width="510px"></imagedata>
+ </imageobject>
+ <imageobject role="fo">
+ <imagedata fileref="figures/invest_ret_of_cap.png" format="PNG"
+ srccredit="Chris Good"></imagedata>
+ </imageobject>
+ <textobject>
+ <phrase>Example of return of capital transactions</phrase>
+ </textobject>
+
+ <caption><para>An image of the Stock Account register after a return
+ of capital.</para></caption>
+ </mediaobject>
+ </screenshot>
+
+ <note><para>It is not possible to use the Stock Split Assistant to do this
+ type of transaction.</para>
+ </note>
+
+ <tip><para>If you accidentally entered a non-zero price in the stock split,
+ <application>&app;</application> may have created an unwanted price database
+ entry which could cause reports to be wrong. Check for and remove such an
+ unwanted entry from the price database using <menuchoice><guimenu>Tools
+ </guimenu><guimenuitem>Price Editor</guimenuitem></menuchoice>.</para>
+ </tip>
+
+ </sect1>
<!-- Stock Splits - Simple
diff --git a/guide/C/figures/invest_ret_of_cap.png b/guide/C/figures/invest_ret_of_cap.png
new file mode 100644
index 0000000..e24d711
Binary files /dev/null and b/guide/C/figures/invest_ret_of_cap.png differ
commit df47fc56e6a94d275962366a93fcc977754ad1dd
Author: Chris Good <chris.good at ozemail.com.au>
Date: Thu Apr 21 07:23:29 2016 +1000
Clarify Account type designations in the Tutorial - Bug 712764
diff --git a/guide/C/ch_accts.xml b/guide/C/ch_accts.xml
index 28ab59d..9485926 100644
--- a/guide/C/ch_accts.xml
+++ b/guide/C/ch_accts.xml
@@ -200,6 +200,11 @@ Translators:
information. Funds represent ownership shares of a variety of
investments, and like stocks they do not offer any guaranteed cash
value.</para>
+
+ <para><application>&app;</application> treats account types Stock and
+ Mutual Fund the same.
+ </para>
+
</listitem>
<listitem>
@@ -219,10 +224,15 @@ Translators:
</listitem>
<listitem>
- <para><guilabel>Other Assets</guilabel> No matter how diverse they
- are, <application>&app;</application> handles many other situations easily. The group
- category, <quote>Other Assets</quote>, covers all assets not listed above.</para>
+ <para><guilabel>Asset</guilabel> No matter how diverse they
+ are, <application>&app;</application> handles many other situations
+ easily. The account type <quote>Asset</quote>, covers all assets not
+ listed above.</para>
+ <para><application>&app;</application> treats account types Cash,
+ Bank and Asset the same.
+ </para>
+
<para>Accounts are repositories of information used to track or record
the kinds of actions that occur related to the purpose for which the
account is established.</para>
@@ -235,7 +245,7 @@ Translators:
<para>For personal finances a person can follow the business groupings
or not, as they seem useful to the activities the person is tracking
- and to the kind of reporting that person needs to have to manage his
+ and to the kind of reporting that person needs to have to manage their
financial assets. For additional information, consult
<xref linkend="chapter_other_assets"/> of this Guide.</para>
</listitem>
@@ -280,6 +290,11 @@ Translators:
all other loans, generally larger long-term loans such as a mortgage
or vehicle loan. This account can help you keep track of how much
you owe and how much you have already repaid.</para>
+
+ <para><application>&app;</application> treats account types Credit
+ Card and Liability the same.
+ </para>
+
</listitem>
</orderedlist>
@@ -394,6 +409,24 @@ Translators:
</mediaobject>
</screenshot>
</sect2>
+
+ <sect2 id="accts-other-types">
+ <title>Other Account Types</title>
+
+ <para>There are some special other account types.</para>
+
+ <para><emphasis>Trading</emphasis> Multiple currency transactions have
+ splits in <quote>Trading</quote> accounts to make the transaction
+ balance in each currency as well as in total value. See
+ <xref linkend="chapter_currency" /> for more information.
+ </para>
+
+ <para><emphasis>Money Market</emphasis> and <emphasis>Credit Line
+ </emphasis>are used only in the OFX importer, apparently for
+ completeness with the specification.
+ </para>
+ </sect2>
+
</sect1>
<sect1 id="accts-examples1">
commit cef453cb6f47fae1b8e34bf45282403c27d81302
Author: Chris Good <chris.good at ozemail.com.au>
Date: Fri Apr 22 10:22:26 2016 +1000
Explain how to use Find Transaction to report per-employee - Bug 751686
diff --git a/guide/C/ch_bus_pay.xml b/guide/C/ch_bus_pay.xml
index 38113d0..789da47 100644
--- a/guide/C/ch_bus_pay.xml
+++ b/guide/C/ch_bus_pay.xml
@@ -45,7 +45,31 @@ Simple Payroll Account Layout:
</literallayout>
<note>
- <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 (<emphasis>Expenses:Salaries</emphasis> 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
+ (<emphasis>Expenses:Salaries</emphasis> for example) and use reports to
+ view per-employee information.
+ </para>
+
+ <para>The Transaction report can be used to sort and total by description or
+ memo (but not by part of them).
+ </para>
+
+ <para>
+ To report on the Salaries transactions for a specific employee where the
+ employee name or code is entered in the transaction description or memo,
+ use the <guilabel>Find Transaction</guilabel> assistant
+ (<menuchoice><guimenu>Edit</guimenu><guimenuitem>Find</guimenuitem>
+ </menuchoice>) to select the transactions, and then report on them
+ using <menuchoice><guimenu>Reports</guimenu><guimenuitem>Account Report
+ </guimenuitem></menuchoice>. Further formatting or analysis may be done
+ by copying and pasting the report into a spreadsheet. See
+ <ulink type="help" url="ghelp:gnucash-help?tool-find-txn">Find
+ Transaction</ulink> in the <application>&app;</application> Help Manual.
+ </para>
</note>
</para>
diff --git a/help/C/Help_ch_Reports.xml b/help/C/Help_ch_Reports.xml
index 4b0a958..f03f2d2 100644
--- a/help/C/Help_ch_Reports.xml
+++ b/help/C/Help_ch_Reports.xml
@@ -59,7 +59,18 @@
See <xref linkend="prefs-accounting-period" />.
</para>
</tip>
-
+
+ <tip>
+ <para>If you cannot find a specific report to suit your requirements, you
+ may be able to use the <guilabel>Find Transaction</guilabel> assistant
+ (<menuchoice><guimenu>Edit</guimenu><guimenuitem>Find</guimenuitem>
+ </menuchoice>) to select a set of transactions, and then report them
+ using <menuchoice><guimenu>Reports</guimenu><guimenuitem>Account Report
+ </guimenuitem></menuchoice>. Further formatting or analysis may be done
+ by copying and pasting the report into a spreadsheet.
+ </para>
+ </tip>
+
<para>After you have configured a report, you can save the configuration for
future use by clicking either the <guibutton>Save Report Configuration
</guibutton> or <guibutton>Save Report Configuration As...</guibutton>
diff --git a/help/C/Help_ch_Tools_Assistants.xml b/help/C/Help_ch_Tools_Assistants.xml
index 6c8fcbc..06e1953 100644
--- a/help/C/Help_ch_Tools_Assistants.xml
+++ b/help/C/Help_ch_Tools_Assistants.xml
@@ -117,7 +117,15 @@
</note>
<para>When search criteria are selected, you can press the <guibutton>Find</guibutton> button. You will be
- presented with the search results in a new register tab.</para>
+ presented with the search results in a new register tab. A report of the
+ search results may created and printed using <menuchoice><guimenu>
+ Reports</guimenu><guimenuitem>Account Report</guimenuitem></menuchoice>.
+ The Account Report has limited formatting options but, like all
+ <application>&app;</application> reports, being in html format, can be
+ copied and pasted into a spreadsheet for further formatting.
+ Alternatively, the Account Report can be exported to an html file, and
+ the html file may be opened in a spreadsheet.
+ </para>
<note>
<para>Press the <guibutton>Close</guibutton> button to close the <guilabel>Find Transaction</guilabel> dialog.</para>
Summary of changes:
guide/C/ch_accts.xml | 41 +++++++++++++++++++--
guide/C/ch_bus_pay.xml | 26 ++++++++++++-
guide/C/ch_invest.xml | 67 ++++++++++++++++++++++++++++++++++
guide/C/figures/invest_ret_of_cap.png | Bin 0 -> 75879 bytes
help/C/Help_ch_Reports.xml | 13 ++++++-
help/C/Help_ch_Tools_Assistants.xml | 10 ++++-
6 files changed, 150 insertions(+), 7 deletions(-)
create mode 100644 guide/C/figures/invest_ret_of_cap.png
More information about the gnucash-changes
mailing list