gnucash-docs maint: Multiple changes pushed
Frank H.Ellenberger
fell at code.gnucash.org
Thu Jul 15 23:12:14 EDT 2021
Updated via https://github.com/Gnucash/gnucash-docs/commit/0389e0aa (commit)
via https://github.com/Gnucash/gnucash-docs/commit/e4f9068b (commit)
from https://github.com/Gnucash/gnucash-docs/commit/4998ad75 (commit)
commit 0389e0aa1e073e097052886f7758f34e426a7268
Merge: 4998ad75 e4f9068b
Author: Frank H. Ellenberger <frank.h.ellenberger at gmail.com>
Date: Fri Jul 16 05:07:41 2021 +0200
Merge PR #189 into maint
diff --cc docbook/gnc-docbookx.dtd
index bfec6d2d,fd3269de..5f4aee49
--- a/docbook/gnc-docbookx.dtd
+++ b/docbook/gnc-docbookx.dtd
@@@ -49,7 -49,8 +49,9 @@@ own entity definitions to use across al
<!ENTITY appname "GnuCash"> <!-- This should be used, where no further markup is desired, e.g. in GUI elements, URLs -->
<!ENTITY app "<application>GnuCash</application>"> <!-- This should be used in normal text -->
<!ENTITY app-fq "<application>Finance::Quote</application>">
+ <!ENTITY app-aoo "<application>Apache OpenOffice</application>">
+ <!ENTITY app-lo "<application>LibreOffice</application>">
+<!ENTITY app-py "<application>Python</application>">
<!-- Operating Systems (3 letters), Bundles: -->
<!ENTITY lin "<systemitem class='osname'>Linux</systemitem>">
commit e4f9068be65fa6100a4cc853e16d37ccd95f0d61
Author: TANIGUCHI Yasuaki <yasuakit at gmail.com>
Date: Wed Jul 14 22:04:21 2021 +0900
Add entities for Apache OpenOffice, LibreOffice, and a GnuCash file
fin.c.
Replace hardcorded Office Suite and path of fin.c with the entities.
Replace k(thousand) with 000.
Add commas into the numbers over 1,000 except user's input.
Change Terminology's list from itemizedlist to variablelist.
Move Car loan section before personal loan section.
Fix some typos.
diff --git a/docbook/gnc-docbookx.dtd b/docbook/gnc-docbookx.dtd
index 3f5a934b..fd3269de 100644
--- a/docbook/gnc-docbookx.dtd
+++ b/docbook/gnc-docbookx.dtd
@@ -49,6 +49,8 @@ own entity definitions to use across all of our DocBook pages. -->
<!ENTITY appname "GnuCash"> <!-- This should be used, where no further markup is desired, e.g. in GUI elements, URLs -->
<!ENTITY app "<application>GnuCash</application>"> <!-- This should be used in normal text -->
<!ENTITY app-fq "<application>Finance::Quote</application>">
+<!ENTITY app-aoo "<application>Apache OpenOffice</application>">
+<!ENTITY app-lo "<application>LibreOffice</application>">
<!-- Operating Systems (3 letters), Bundles: -->
<!ENTITY lin "<systemitem class='osname'>Linux</systemitem>">
@@ -61,12 +63,13 @@ own entity definitions to use across all of our DocBook pages. -->
Last version of branch n -->
<!ENTITY vers-last-2 "2.6.21">
<!--
- 3. Some common directories - change rarely.
+ 3. Some common files and directories - change rarely.
FIXME: OS independed?
-->
<!ENTITY dir-conf "~/.conf/gnucash/">
<!ENTITY dir-data "~/.local/share/gnucash/">
<!ENTITY dir-old "~/.gnucash/"> <!-- Up to 2.6.21 common for conf & data -->
+<!ENTITY file-finc "libgnucash/app-utils/calculation/fin.c">
<!--
4. Some common URLs - should be changed on demand.
diff --git a/guide/C/appendixa.xml b/guide/C/appendixa.xml
index aaae878f..22b2250b 100644
--- a/guide/C/appendixa.xml
+++ b/guide/C/appendixa.xml
@@ -179,7 +179,7 @@
<listitem>
<para>You will now have a file in the desired output format. An enterprising individual could go so far as
- to write a stylesheet to transform the &app; data file to an OpenOffice spreadsheet (or
+ to write a stylesheet to transform the &app; data file to an &app-aoo;/&app-lo; Calc (or
vice-versa, for that matter). Such things as <acronym>QIF</acronym> ought to be a little
less work.
</para>
diff --git a/guide/C/ch_bus_features.xml b/guide/C/ch_bus_features.xml
index 8dd6442a..bc50f880 100644
--- a/guide/C/ch_bus_features.xml
+++ b/guide/C/ch_bus_features.xml
@@ -1267,8 +1267,8 @@
</para>
<para>To include a company logo, banner heading and background image, use your favorite graphics
- application such as <application>The Gimp</application> or <application>OpenOffice
- Draw</application> to save the images in either <acronym>GIF</acronym> or
+ application such as <application>The Gimp</application> or &app-aoo;/&app-lo;
+ Draw to save the images in either <acronym>GIF</acronym> or
<acronym>PNG</acronym> format. Then import them into the style sheet using the
<guilabel>Images</guilabel> section described above.
</para>
diff --git a/guide/C/ch_loans.xml b/guide/C/ch_loans.xml
index 7e588d85..1dea9703 100644
--- a/guide/C/ch_loans.xml
+++ b/guide/C/ch_loans.xml
@@ -35,74 +35,114 @@
this list if you encounter an unfamiliar word in the later sections.
</para>
- <itemizedlist>
- <listitem>
- <para><emphasis>Amortization</emphasis> - the repayment plan which will insure that a loan is eventually
- paid off, typically utilizing equal valued monthly payments. These payments are usually
- split into principal and interest, where the amount of principal per payment increases
- (and interest decreases) as the amortization period elapses.
- </para>
- </listitem>
+ <variablelist>
+ <varlistentry>
+ <term>Amortization</term>
- <listitem>
- <para><emphasis>Borrower</emphasis> - the person or company that receives the money from a loan.
- </para>
- </listitem>
+ <listitem>
+ <para>The repayment plan which will insure that a loan is eventually paid off, typically utilizing equal
+ valued monthly payments. These payments are usually split into principal and interest,
+ where the amount of principal per payment increases (and interest decreases) as the
+ amortization period elapses.
+ </para>
+ </listitem>
+ </varlistentry>
- <listitem>
- <para><emphasis>Default</emphasis> - when a borrower fails to repay a loan according to the terms agreed
- upon with the lender.
- </para>
- </listitem>
+ <varlistentry>
+ <term>Borrower</term>
- <listitem>
- <para><emphasis>Deferment</emphasis> - a temporary delay in the repayment of a loan.
- </para>
- </listitem>
+ <listitem>
+ <para>The person or company that receives the money from a loan.
+ </para>
+ </listitem>
+ </varlistentry>
- <listitem>
- <para><emphasis>Delinquency</emphasis> - is the term that refers to late payments.
- </para>
- </listitem>
+ <varlistentry>
+ <term>Default</term>
- <listitem>
- <para><emphasis>Disbursement</emphasis> - amount of the loan paid to the borrower. Some loans have
- multiple disbursements, meaning the borrower does not receive the full amount of the
- loan at one time.
- </para>
- </listitem>
+ <listitem>
+ <para>The time when a borrower fails to repay a loan according to the terms agreed upon with the lender.
+ </para>
+ </listitem>
+ </varlistentry>
- <listitem>
- <para><emphasis>Interest</emphasis> - the expense charged by the lender to the borrower for the use of the
- money loaned. This is typically expressed in terms of a yearly percentage charged on the
- principal borrowed, known as the <emphasis>Annual Percentage Rate</emphasis> or APR.
- </para>
- </listitem>
+ <varlistentry>
+ <term>Deferment</term>
- <listitem>
- <para><emphasis>Lender</emphasis> - the company or person who lends money to a borrower.
- </para>
- </listitem>
+ <listitem>
+ <para>A temporary delay in the repayment of a loan.
+ </para>
+ </listitem>
+ </varlistentry>
- <listitem>
- <para><emphasis>Loan Fee</emphasis> - a processing fee removed from the principal at the time the borrower
- receives a loan.
- </para>
- </listitem>
+ <varlistentry>
+ <term>Delinquency</term>
- <listitem>
- <para><emphasis>Principal</emphasis> - the original amount of the loan, or the amount of the original loan
- that is still owed. When you make a monthly payment on a loan, part of the money pays
- the interest, and part pays the principal.
- </para>
- </listitem>
+ <listitem>
+ <para>It is the term that refers to late payments.
+ </para>
+ </listitem>
+ </varlistentry>
- <listitem>
- <para><emphasis>Promissory Note</emphasis> - the legal agreement between the borrower and lender
- concerning the loan.
- </para>
- </listitem>
- </itemizedlist>
+ <varlistentry>
+ <term>Disbursement</term>
+
+ <listitem>
+ <para>An amount of the loan paid to the borrower. Some loans have multiple disbursements, meaning the
+ borrower does not receive the full amount of the loan at one time.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Interest</term>
+
+ <listitem>
+ <para>The expense charged by the lender to the borrower for the use of the money loaned. This is typically
+ expressed in terms of a yearly percentage charged on the principal borrowed, known as
+ the <emphasis>Annual Percentage Rate</emphasis> or <acronym>APR</acronym>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Lender</term>
+
+ <listitem>
+ <para>The company or person who lends money to a borrower.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Loan Fee</term>
+
+ <listitem>
+ <para>A processing fee removed from the principal at the time the borrower receives a loan.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Principal</term>
+
+ <listitem>
+ <para>The original amount of the loan, or the amount of the original loan that is still owed. When you
+ make a monthly payment on a loan, part of the money pays the interest, and part pays
+ the principal.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Promissory Note</term>
+
+ <listitem>
+ <para>The legal agreement between the borrower and lender concerning the loan.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</sect2>
</sect1>
@@ -125,11 +165,14 @@
money from a loan is an asset. With these parameters, we can now present a basic loan account
structure:
</para>
-<screen>Basic Loan Account Structure
+ <bridgehead>
+ Basic Loan Account Structure
+ </bridgehead>
+<screen>
-Asset
-Current Assets
- -Savings Account
+ -Saving
-Fixed Assets
-Asset Purchased
-Liability
@@ -140,11 +183,9 @@
-Mortgage Interest
-Mortgage Adm Fees</screen>
<para>&app; has a number of predefined loan account hierarchies available, including Car Loans and Home
- Mortgage Loans. To access these predefined account structures, click on
- <menuchoice>
- <guimenu>Actions</guimenu> <guimenuitem>New Account Hierarchy...</guimenuitem>
- </menuchoice>
- and select the loan types in which you are interested.
+ Mortgage Loans. To access these predefined account structures, click on <menuchoice>
+ <guimenu>Actions</guimenu><guimenuitem>New Account Hierarchy...</guimenuitem>
+ </menuchoice> and select the loan types in which you are interested.
</para>
</sect1>
@@ -153,11 +194,9 @@
<para>Determining loan amortization schedules, periodic payment amounts, total payment value, or interest
rates can be somewhat complex. To help facilitate these kinds of calculations, &app; has a
- built-in <guilabel>Loan Repayment Calculator</guilabel>. To access the calculator, go to
- <menuchoice>
+ built-in <guilabel>Loan Repayment Calculator</guilabel>. To access the calculator, go to <menuchoice>
<guimenu>Tools</guimenu> <guimenuitem>Loan Repayment Calculator</guimenuitem>
- </menuchoice>
- .
+ </menuchoice>.
</para>
<screenshot id="loans_fcalc">
@@ -185,63 +224,91 @@
compounding and payment methods.
</para>
- <itemizedlist>
- <listitem>
- <para><emphasis>Payment Periods</emphasis> - the number of payment periods.
- </para>
- </listitem>
+ <variablelist>
+ <varlistentry>
+ <term>Payment Periods</term>
- <listitem>
- <para><emphasis>Interest Rate</emphasis> - the nominal interest rate of the loan, ie: the yearly interest
- rate.
- </para>
- </listitem>
+ <listitem>
+ <para>The number of payment periods.
+ </para>
+ </listitem>
+ </varlistentry>
- <listitem>
- <para><emphasis>Present Value</emphasis> - the present value of the loan, ie: current amount owed on the
- loan.
- </para>
- </listitem>
+ <varlistentry>
+ <term>Interest Rate</term>
- <listitem>
- <para><emphasis>Periodic Payment</emphasis> - the amount to pay per period.
- </para>
- </listitem>
+ <listitem>
+ <para>The nominal interest rate of the loan, i.e., the yearly interest rate.
+ </para>
+ </listitem>
+ </varlistentry>
- <listitem>
- <para><emphasis>Future Value</emphasis> - the future value of the loan, ie: the amount owed after all
- payment periods are over.
- </para>
- </listitem>
+ <varlistentry>
+ <term>Present Value</term>
- <listitem>
- <para><emphasis>Compounding</emphasis> - two interest compounding methods exist, discrete or continuous.
- For discrete compounding select the compounding frequency from the popup menu with a range
- from yearly to daily.
- </para>
- </listitem>
+ <listitem>
+ <para>The present value of the loan, i.e., current amount owed on the loan.
+ </para>
+ </listitem>
+ </varlistentry>
- <listitem>
- <para><emphasis>Payments</emphasis> - the popup menu allows you to select the payment frequency with a
- range from yearly to daily. You can also select whether your payments occur at the
- beginning or end of the period. Payments made at the beginning of the payment period have
- interest applied to the payment as well as any previous money paid or money still owed.
- </para>
- </listitem>
- </itemizedlist>
+ <varlistentry>
+ <term>Periodic Payment</term>
+
+ <listitem>
+ <para>The amount to pay per period.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Future Value</term>
+
+ <listitem>
+ <para>The future value of the loan, i.e., the amount owed after all payment periods are over.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Compounding</term>
+
+ <listitem>
+ <para>Two interest compounding methods exist, discrete or continuous. For discrete compounding select the
+ compounding frequency from the popup menu with a range from yearly to daily.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Payments</term>
+
+ <listitem>
+ <para>The popup menu allows you to select the payment frequency with a range from yearly to daily. You can
+ also select whether your payments occur at the beginning or end of the period. Payments
+ made at the beginning of the payment period have interest applied to the payment as well
+ as any previous money paid or money still owed.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
<sect2 id="loans_calcsexample1_2">
<title>Example: Monthly Payments</title>
- <para>What is your monthly payment on a $100000 30 year loan at a fixed rate of 4% compounded monthly?
+ <para>What is your monthly payment on a $100,000 30 year loan at a fixed rate of 4% compounded monthly?
</para>
- <para>This scenario is shown in the example image above. To perform this calculation, set Payment Periods
- to 360 (12 months x 30 years), Interest Rate to 4, Present Value to 100000, leave Periodic
- Payment empty and set Future Value to 0 (you do not want to owe anything at the end of the
- loan). Compounding is Monthly, Payments are Monthly, assume End of Period Payments, and
- Discrete Compounding. Now, click on the <guibutton>Calculate</guibutton> button next to the
- Periodic Payment area. You should see $-477.42.
+ <para>This scenario is shown in the example image above. To perform this calculation, set
+ <guilabel>Payment Periods</guilabel> to <userinput>360</userinput> (12 months x 30 years),
+ <guilabel>Interest Rate</guilabel> to <userinput>4</userinput>, <guilabel>Present
+ Value</guilabel> to <userinput>100000</userinput>, leave <guilabel>Periodic
+ Payment</guilabel> empty and set <guilabel>Future Value</guilabel> to
+ <userinput>0</userinput> (you do not want to owe anything at the end of the loan).
+ <guilabel>Compounding</guilabel> is Monthly, <guilabel>Payments</guilabel> are Monthly,
+ assume End of Period Payments, and Discrete Compounding. Now, click on the
+ <guibutton>Calculate</guibutton> button next to the Periodic Payment area. You should see
+ $<computeroutput>-477.42</computeroutput>.
</para>
<para>Answer: You must make monthly payments of 477.42.
@@ -251,7 +318,7 @@
<sect2 id="loans_calcsexample2_2">
<title>Example: Length of Loan</title>
- <para>How long will you be paying back a $20000 loan at 10% fixed rate interest compounded monthly if you
+ <para>How long will you be paying back a $20,000 loan at 10% fixed rate interest compounded monthly if you
pay $500 per month?
</para>
@@ -263,8 +330,8 @@
is <emphasis>Monthly</emphasis>, <guilabel>Payments</guilabel> are
<emphasis>Monthly</emphasis>, assume <guilabel>End</guilabel> of <guilabel>Period</guilabel>
payments, and <guilabel>Discrete</guilabel> <guilabel>Compounding</guilabel>. Now, click on
- the <guibutton>Calculate</guibutton>. You should see 49 in the <guilabel>Payment
- Periods</guilabel> field.
+ the <guibutton>Calculate</guibutton>. You should see <computeroutput>49</computeroutput> in
+ the <guilabel>Payment Periods</guilabel> field.
</para>
<para>Answer: You will pay off the loan in 4 years and 1 month (49 months).
@@ -275,8 +342,7 @@
<title>Advanced: Calculation Details</title>
<para>In order to discuss the mathematical formulas used by the <guilabel>Loan Repayment
- Calculator</guilabel>, we first must define some variables.
-<screen>
+ Calculator</guilabel>, we first must define some variables.<screen>
n == number of payment periods
%i == nominal interest rate, NAR, charged
PV == Present Value
@@ -336,8 +402,9 @@ Continuous Interest: <emphasis>i = ln[(1+ieff)^PF]</emphasis></screen>
X = 1 for beginning of period payments</screen>
<para>From this equation, functions which solve for the individual variables can be derived. For a
detailed explanation of the derivation of this equation, see the comments in the file
- src/calculation/fin.c from the &app; source code. The A, B, and C variables are defined
- first, to make the later equations simpler to read.
+ <ulink url="&url-gh-gc-maint;&file-finc;"><filename>&file-finc;</filename></ulink> from
+ the &app; source code. The A, B, and C variables are defined first, to make the later
+ equations simpler to read.
</para>
<screen>
<emphasis>A = (1 + i)^n - 1</emphasis>
@@ -355,8 +422,8 @@ The simple case for when PMT == 0 gives the solution:
</screen>
<para>The case where PMT != 0 is fairly complex and will not be presented here. Rather than involving an
exactly solvable function, determining the interest rate when PMT !=0 involves an
- iterative process. Please see the src/calculation/fin.c source file for a detailed
- explanation.
+ iterative process. Please see the <filename>&file-finc;</filename> source file for a
+ detailed explanation.
</para>
</sect3>
@@ -365,7 +432,7 @@ The simple case for when PMT == 0 gives the solution:
<para>Let’s recalculate <xref linkend="loans_calcsexample1_2"/>, this time using the mathematical
formulas rather than the <guilabel>Loan Repayment Calculator</guilabel>. What is your
- monthly payment on a $100000 30 year loan at a fixed rate of 4% compounded monthly?
+ monthly payment on a $100,000 30 year loan at a fixed rate of 4% compounded monthly?
</para>
<para>First, let’s define the variables: n = (30*12) = 360, PV = 100000, PMT = unknown, FV = 0, i =
@@ -399,10 +466,10 @@ The simple case for when PMT == 0 gives the solution:
<xref linkend="loans_accounts1" />.
</para>
- <para>As an example, assume you have $60k in you bank account, and you buy a $150k house. The mortgage is
- charging 6% APR, and has administrative fees (closing costs, etc) of 3%. You decide to put
- $50k down, and thus will need to borrow $103k, which will give you $100 after the closing
- costs are paid (3% of $100k).
+ <para>As an example, assume you have $60,000 in you Saving account, and you buy a $150,000 house. The
+ mortgage is charging 6% APR, and has administrative fees (closing costs, etc) of 3%. You
+ decide to put $50,000 down, and thus will need to borrow $103,000, which will give you $100
+ after the closing costs are paid (3% of $100,000).
</para>
<para>Your accounts before borrowing the money:
@@ -426,10 +493,10 @@ The simple case for when PMT == 0 gives the solution:
</mediaobject>
</screenshot>
- <para>The purchase of the house is recorded with a split transaction in the
- <emphasis>Assets:House</emphasis> account, with $50k coming from the bank (IE: your down
- payment), and $100k coming from the Mortgage. You can place the $3k closing costs in the same
- split, and we increase the house loan to $103k to include the closing costs as well.
+ <para>The purchase of the house is recorded with a split transaction in the <emphasis>Assets:Fixed
+ Assets:House</emphasis> account, with $50,000 coming from the bank (i.e., your down payment),
+ and $100,000 coming from the Mortgage. You can place the $3,000 closing costs in the same
+ split, and we increase the house loan to $103,000 to include the closing costs as well.
</para>
<para><table>
@@ -493,7 +560,7 @@ The simple case for when PMT == 0 gives the solution:
</entry>
<entry>
- $3000
+ $3,000
</entry>
<entry></entry>
@@ -546,6 +613,30 @@ The simple case for when PMT == 0 gives the solution:
</screenshot>
</sect1>
+ <sect1 id="loans_CarLoan">
+ <title>Automobile Loan (How-To)</title>
+
+ <para>The automobile Loan, or in common terms, car Loan, is treated more or less exactly as the house
+ loan. The only difference is different accounts, and different interest rates. The basic car
+ loan account structure is as follows:<screen>-Asset
+ -Current Assets
+ -Saving
+ -Fixed Assets
+ -Car
+-Liability
+ -Loans
+ -Car Loan
+-Expenses
+ -Interest
+ -Car Loan Interest
+ -Car Loan Adm Fees</screen>
+ </para>
+
+ <para>For more information, please check <xref
+ linkend="loans_mortgage1" />.
+ </para>
+ </sect1>
+
<sect1 id="loans_personalLoanToSomeOne">
<title>A Personal Loan to a friend (How-To)</title>
@@ -566,7 +657,7 @@ The simple case for when PMT == 0 gives the solution:
-Interest Income
-Person</screen>
<para>This example will show how to track a personal loan of 2,000 USD (default currency) to your friend
- Peter
+ Peter.
</para>
<sect2 id="loans_personalLoanToSomeOne_loan">
@@ -577,8 +668,7 @@ The simple case for when PMT == 0 gives the solution:
rate of 5%.
</para>
- <para>In summary we have the below details. Peter’s loan details:
- <itemizedlist>
+ <para>In summary we have the below details. Peter’s loan details:<itemizedlist>
<listitem>
<para>Pinciple Amount - $2,000
</para>
@@ -604,7 +694,7 @@ The simple case for when PMT == 0 gives the solution:
<para>So how do you calculate the Monthly Payment?
</para>
- <para>You have a number of different options, like paper and pen, &lin; Calculator, Open Office’s
+ <para>You have a number of different options, like paper and pen, &lin; Calculator, &app-aoo;/&app-lo;
Calc module, but the easiest is to use &app; <link linkend="loans_calcs1"><guilabel>Loan
Repayment Calculator</guilabel></link>. This tells you that the Monthly Payment should be
$115.56.
@@ -612,8 +702,8 @@ The simple case for when PMT == 0 gives the solution:
<para>But you need to know how much of this is Interest and how much is Principal to be able to do a
proper bookkeeping. For this you need a more powerful tool, something like the
- <application>Calc</application> module in <application>OpenOffice.org</application>, and in
- particular the <acronym>PMT</acronym> function.
+ <application>Calc</application> module in &app-aoo;/&app-lo;, and in particular the
+ <acronym>PMT</acronym> function.
</para>
<screenshot id="loans_OpenOfficePrivateLoanDetails">
@@ -627,9 +717,8 @@ The simple case for when PMT == 0 gives the solution:
<phrase>Calculation of Private Loan details</phrase>
</textobject>
- <caption>
- <para>Detailed view over the private loan to Peter
- </para>
+ <caption id="loans_OpenOfficePrivateLoanDetails.caption">
+ Detailed view over the private loan to Peter
</caption>
</mediaobject>
</screenshot>
@@ -638,14 +727,32 @@ The simple case for when PMT == 0 gives the solution:
<sect2 id="loans_personalLoanToSomeOne_accounts">
<title>Accounts for the loan</title>
- <para>Let’s start with the following accounts (all accounts have the same currency, in this case
- USD)
+ <para>Let’s start with the following accounts. They all have the same currency, in this case USD.<example>
+ <title>Accounts for the loan to Peter</title>
+
+ <itemizedlist>
+ <listitem>
+ <simpara>Assets:Bank:USD
+ </simpara>
+ </listitem>
+
+ <listitem>
+ <simpara>Assets:Money owed to you:Peter
+ </simpara>
+ </listitem>
+
+ <listitem>
+ <simpara>Income:Interest Income:Peter
+ </simpara>
+ </listitem>
+
+ <listitem>
+ <simpara>Equity:Opening Balances:USD
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </example>
</para>
-<screen>
-Assets:Bank:USD
-Assets:Money owed to you:Peter
-Income:Interest Income:Peter
-Equity:Opening Balances:USD</screen>
</sect2>
<sect2 id="loans_personalLoanToSomeOne_InitialSetup">
@@ -654,11 +761,11 @@ Equity:Opening Balances:USD</screen>
<para>When you have lent money to your friend, you have in fact moved money from an Asset account (like
Bank, Checking or similar) to your Asset account <emphasis>Money owed to you</emphasis>. To
record this you enter the following transaction into the <emphasis>Assets:Money owed to
- you:Friend</emphasis> account.
+ you:Peter</emphasis> account.
</para>
<para><table>
- <title>Personal loan to a Friend</title>
+ <title>Personal loan to Peter</title>
<tgroup cols="3">
<tbody>
@@ -678,7 +785,7 @@ Equity:Opening Balances:USD</screen>
<row>
<entry>
- Assets:Money owed to you:Friend
+ Assets:Money owed to you:Peter
</entry>
<entry>
@@ -778,7 +885,7 @@ Equity:Opening Balances:USD</screen>
</mediaobject>
</screenshot>
- <para>The balance on Peter’s loan is now $2,000 - $107.23 = $1,892.77
+ <para>The balance on Peter’s loan is now $2,000 - $107.23 = $1,892.77.
</para>
</sect2>
@@ -816,7 +923,7 @@ Equity:Opening Balances:USD</screen>
</listitem>
</itemizedlist>
- <para>This can be translated to the following &app; entry
+ <para>This can be translated to the following &app; entry.
</para>
<screenshot id="loans_PrivateLoanSecondPayment">
@@ -837,10 +944,10 @@ Equity:Opening Balances:USD</screen>
</mediaobject>
</screenshot>
- <para>The balance on Peter’s loan is now $1,892.77 - $107.67 = $1,785.10
+ <para>The balance on Peter’s loan is now $1,892.77 - $107.67 = $1,785.10.
</para>
- <para>The Chart of accounts looks now like this
+ <para>The Chart of accounts looks now like this:
</para>
<screenshot id="loans_PrivateLoanSecondPaymentAccounts">
@@ -855,8 +962,7 @@ Equity:Opening Balances:USD</screen>
</textobject>
<caption>
- <para>Chart of Accounts after second payment
- </para>
+ Chart of Accounts after second payment
</caption>
</mediaobject>
</screenshot>
@@ -867,39 +973,12 @@ Equity:Opening Balances:USD</screen>
<para>The interest amount will be less and less for every payment (since it is calculated on a smaller
loan amount all the time), until the last payment where it is more or less 0. Please review
- the Figure of Detailed view over private loan to Peter for more details
+ <link linkend="loans_OpenOfficePrivateLoanDetails" endterm="loans_OpenOfficePrivateLoanDetails.caption" />
+ for more details.
</para>
</sect2>
</sect1>
- <sect1 id="loans_CarLoan">
- <title>Automobile Loan (How-To)</title>
-
- <para>The Automobile Loan, or in common terms, Car Loan, is treated more or less exactly as the House
- loan. The only difference is different accounts, and different interest rates.
- </para>
-
- <para><screen>Basic Car Loan Account Structure
-
--Asset
- -Current Assets
- -Savings Account
- -Fixed Assets
- -Car
--Liability
- -Loans
- -Car Loan
--Expenses
- -Interest
- -Car Loan Interest
- -Car Loan Adm Fees</screen>
- </para>
-
- <para>For more information, please check <xref
- linkend="loans_mortgage1" />
- </para>
- </sect1>
-
<sect1 id="loans_Reconciling">
<title>Reconciling with the Loan Statements (How-To)</title>
@@ -909,7 +988,7 @@ Equity:Opening Balances:USD</screen>
<para>During the period you should have recorded all the various loan related transactions, and every one
of them are touching the <guilabel>Liability:Loans:<replaceable>Loan</replaceable></guilabel>
account. For instance, paying off a bit of the loan decreases your <emphasis>Bank
- Account,</emphasis> and increases the <emphasis>Loan account</emphasis>, <emphasis>Loan
+ Account</emphasis> and <emphasis>Loan account</emphasis>, and increases the <emphasis>Loan
Interest</emphasis> as well as perhaps <emphasis>Loan administration fee</emphasis>.
</para>
@@ -921,7 +1000,7 @@ Equity:Opening Balances:USD</screen>
</para>
<para>For more information on how to Reconcile, please check <xref
- linkend="txns-reconcile1" />
+ linkend="txns-reconcile1" />.
</para>
</sect1>
@@ -934,8 +1013,6 @@ Equity:Opening Balances:USD</screen>
registered various Unrealized gains over the time.
</para>
- <para></para>
-
<sect2>
<title>Simple Transaction</title>
@@ -963,12 +1040,13 @@ Equity:Opening Balances:USD</screen>
you record this?
</para>
- <para>To record this you need to increase our bank account with the $600k, and decrease some other
- accounts with $600k. The house account only contains $300k which is what you bought it
- for, so you move this amount to your bank account. That means you are lacking $300k.
- This amount you fetch from the <emphasis>Income:Captial Gains Long:House</emphasis>
- account. The split transaction you enter into your <emphasis>bank</emphasis> account
- (<emphasis>Assets:Current Assets:Saving</emphasis>) should look like this.
+ <para>To record this you need to increase your Saving account with the $600,000, and decrease some other
+ accounts with $600,000. The house account only contains $300,000 which is what you
+ bought it for, so you move this amount to your Saving account. That means you are
+ lacking $300,000. This amount you fetch from the <emphasis>Income:Captial Gains
+ Long:House</emphasis> account. The split transaction you enter into your
+ <emphasis>Saving</emphasis> account (<emphasis>Assets:Current Assets:Saving</emphasis>)
+ should look like this.
</para>
<para><table>
@@ -1036,11 +1114,11 @@ Equity:Opening Balances:USD</screen>
sell it for $230,000. How do you record this?
</para>
- <para>To record this you need to increase your bank account with the $230k, and decrease some other
- accounts with $230k. The house account contains $300k which is more than what you sold
- it for. So let’s move $230k of it to your bank account. After this you have $70k
- remaining in your house account which needs to be removed. You move it to our
- <emphasis>Income:Capital Gains Long:House</emphasis> account, which will indicate a
+ <para>To record this you need to increase your Saving account with the $230,000, and decrease some other
+ accounts with $230,000. The house account contains $300,000 which is more than what you
+ sold it for. So let’s move $230,000 of it to your Saving account. After this you
+ have $70,000 remaining in your house account which needs to be removed. You move it to
+ our <emphasis>Income:Capital Gains Long:House</emphasis> account, which will indicate a
loss. The split transaction you enter into your <emphasis>house</emphasis> account
(<emphasis>Assets:Fixed Assets:House</emphasis>) should look like this.
</para>
@@ -1111,7 +1189,7 @@ Equity:Opening Balances:USD</screen>
<title>A More Complex Transaction</title>
<para>In this example, we will touch a little on some more complicated accounting principles. For more
- details on this subject, please check <xref linkend="chapter_capgain"></xref>
+ details on this subject, please check <xref linkend="chapter_capgain"></xref>.
</para>
<para>Here we will only touch on the case when you have accurately estimated the current value of your
@@ -1147,14 +1225,14 @@ Equity:Opening Balances:USD</screen>
<para>How do you record this sell transaction?
</para>
- <para>To record this you need to increase your bank account with the $600k, and decrease some other
- accounts with $600k. You must first change from unrealized gain to realized gain for your
+ <para>To record this you need to increase your Saving account with the $600,000, and decrease some other
+ accounts with $600,000. You must first change from unrealized gain to realized gain for your
<emphasis>Income</emphasis> accounts. Lastly you need to transfer the full amounts from the
<emphasis>Assets:Fixed Assets:House</emphasis> sub-accounts.
</para>
- <para>The transaction you enter into your <emphasis>Income:Realized Gain:House</emphasis> account account
- should look like this.
+ <para>The transaction you enter into your <emphasis>Income:Realized Gain:House</emphasis> account should
+ look like this.
</para>
<para><table>
@@ -1268,7 +1346,7 @@ Equity:Opening Balances:USD</screen>
</para>
<para>After having recorded these transactions you see that your House Asset have a value of 0, your
- Savings account have increased with $600,000, and lastly, the <emphasis>Income:Realized
+ Saving account have increased with $600,000, and lastly, the <emphasis>Income:Realized
Gain</emphasis> have increased to $300,000.
</para>
</sect2>
Summary of changes:
docbook/gnc-docbookx.dtd | 5 +-
guide/C/appendixa.xml | 2 +-
guide/C/ch_bus_features.xml | 4 +-
guide/C/ch_loans.xml | 494 +++++++++++++++++++++++++-------------------
4 files changed, 293 insertions(+), 212 deletions(-)
More information about the gnucash-changes
mailing list