~ubuntu-branches/ubuntu/trusty/eqonomize/trusty

« back to all changes in this revision

Viewing changes to .pc/204_fix_doctype_version.patch/doc/en/index.docbook

  • Committer: Bazaar Package Importer
  • Author(s): Frank S. Thomas
  • Date: 2011-05-29 10:07:37 UTC
  • mfrom: (6.1.5 sid)
  • Revision ID: james.westby@ubuntu.com-20110529100737-16ab5i8fhxa0ir7j
Tags: 0.6-6
* debian/patches/: Added 204_bump_doctype_version.patch to fix FTBFS
  with kdoctools 4.6. Patch taken from kdesvn. (closes: #628327)
* Bumped Standards-Version from 3.8.4 to 3.9.2, no changes required.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<?xml version="1.0" ?>
2
 
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
3
 
  <!ENTITY eqonomize "<application>Eqonomize!</application>">
4
 
  <!ENTITY kappname "&eqonomize;"><!-- Do *not* replace kappname-->
5
 
  <!ENTITY % addindex "IGNORE">
6
 
  <!ENTITY % English "INCLUDE">
7
 
]>
8
 
 
9
 
<book lang="&language;">
10
 
 
11
 
<bookinfo>
12
 
<title>The &eqonomize; Handbook</title>
13
 
 
14
 
<authorgroup>
15
 
<author>
16
 
<firstname>Hanna</firstname>
17
 
<othername></othername>
18
 
<surname>K.</surname>
19
 
<affiliation>
20
 
<address><email>hanna_k@fmgirl.com</email></address>
21
 
</affiliation>
22
 
</author>
23
 
</authorgroup>
24
 
 
25
 
<!-- TRANS:ROLES_OF_TRANSLATORS -->
26
 
 
27
 
<copyright>
28
 
<year>2008</year>
29
 
<holder>Hanna K.</holder>
30
 
</copyright>
31
 
<!-- Translators: put here the copyright notice of the translation -->
32
 
<!-- Put here the FDL notice.  Read the explanation in fdl-notice.docbook
33
 
     and in the FDL itself on how to use it. -->
34
 
<legalnotice>&FDLNotice;</legalnotice>
35
 
 
36
 
<date>2006-09-05</date>
37
 
<releaseinfo>0.4</releaseinfo>
38
 
 
39
 
 
40
 
<abstract>
41
 
<para>
42
 
        &eqonomize; is a personal accounting software, with focus on efficiency and ease of use for the small household economy. &eqonomize; provides a complete solution, with bookkeeping by double entry and support for scheduled recurring transactions, security investments, and budgeting. It gives a clear overview of past and present transactions, and development of incomes and expenses, with descriptive tables and charts, as well as an approximation of future account values.
43
 
</para>
44
 
</abstract>
45
 
 
46
 
<keywordset>
47
 
<keyword>KDE</keyword>
48
 
<keyword>Eqonomize</keyword>
49
 
<keyword>Money</keyword>
50
 
<keyword>Finances</keyword>
51
 
<keyword>Bookkeeping</keyword>
52
 
<keyword>Budget</keyword>
53
 
</keywordset>
54
 
 
55
 
</bookinfo>
56
 
 
57
 
<chapter id="introduction">
58
 
<title>Introduction</title>
59
 
 
60
 
<para>
61
 
        &eqonomize; is a tool for keeping track of and monitoring personal finances. This means entering of everyday expenses and incomes – when you buy something, receive salary, pay bills, transfer money between bank accounts, invest in stock, etc. &eqonomize; provides tools for making this process as easy and efficient as possible. You can then effortlessly retrieve information and statistics about your financial situation. You can for example easily identify major leaks and direct saving efforts to the right areas. You can also monitor performance in relation to a budget and check what your choices might mean for your future wealth.
62
 
</para>
63
 
<para>
64
 
        The purpose of this manual is to describe how to practically use &eqonomize; for those who do not find the graphical user interface self-explanatory, as well as document some less obvious efficiency-enhancing features and explain how &eqonomize; interprets the data you provide.
65
 
</para>
66
 
<para>
67
 
        When first using &eqonomize; you should read <xref linkend="using-eqonomize"/>; especially the first parts <xref linkend="accounts_and_categories"/> and <xref linkend="transactions"/>, which step by step describes how to begin using the basic features.
68
 
</para>
69
 
<para>
70
 
        <xref linkend="accounting"/> provides a more theoretic explanation and description of &eqonomize;' approach to accounting.
71
 
</para>
72
 
<para>
73
 
        In addition there are some reference sections.
74
 
</para>
75
 
</chapter>
76
 
 
77
 
<chapter id="using-eqonomize">
78
 
<title>Using &eqonomize;</title>
79
 
 
80
 
<para>
81
 
        The main window consists of six different views. When &eqonomize; is started, the account view is shown. To change view click on the corresponding icon in the vertical list on the right side of the window.
82
 
</para>
83
 
 
84
 
<sect1 id="accounts_and_categories">
85
 
        <title>Accounts &amp; Categories</title>
86
 
        <para>
87
 
                The first time you start &eqonomize; the account view is displayed with a predefined set of accounts and categories. These can be considered as an example or a starting point for a setup matching your own conditions. You can either begin by modifying the suggested accounts and categories or start from scratch with <menuchoice><guimenu>File</guimenu><guimenuitem>New</guimenuitem></menuchoice> (<keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo>).
88
 
        </para>
89
 
        <mediaobject><imageobject><imagedata format="PNG" fileref="new-account.png"/></imageobject></mediaobject>
90
 
        <para>
91
 
                Accounts should be created to match your real world bank accounts plus at least one account for your cash. Categories are used to keep incomes and expenses better organised. Each transaction must be connected to an account and a category, or two accounts for transfers between accounts. To create accounts and categories use <guimenu>Accounts</guimenu> menu or the context menu in the list.
92
 
        </para>
93
 
        <sect2 id="budget">
94
 
                <title>Budget</title>
95
 
                <para>
96
 
                        &eqonomize; allows you to specify a budget for each month and category. This way you can continuously compare actual and planned expenses. You can also check what your current budget will mean for your future wealth.
97
 
                </para>         
98
 
                <para>
99
 
                        A budget is initially asked for when creating a category. Then you can update it from the budget tab at the bottom of the accounts view, for the category selected in the list. If the budget has not been set for a month, the budget for the previous month is used.
100
 
                        <mediaobject><imageobject><imagedata format="PNG" fileref="edit-budget.png"/></imageobject></mediaobject>
101
 
                </para>
102
 
                <para>
103
 
                        You can choose to set budgets for only some categories. In the accounts list, budget and remaining budget (budget - expenses/incomes) is displayed in the second column. If not all categories have a budget, the total remaining budget only summarises the categories with budget and thus does not include actual expenses/incomes from other categories.
104
 
                </para>
105
 
        </sect2>
106
 
        <sect2 id="account_view">
107
 
                <title>The Accounts View</title>                
108
 
                <para>
109
 
                        The account view displays a list of all accounts and categories, sorted alphabetically under each main type – accounts, incomes, and expenses. The rows for the main types displays the sum of all accounts/categories below.
110
 
                </para>
111
 
                <mediaobject><imageobject><imagedata format="PNG" fileref="accounts-view.png"/></imageobject></mediaobject>
112
 
                <para>
113
 
                        The list has four columns. The first simply displays the name of the account or category. The second does for categories display the budget for the selected period and what is left of the budget. Unless the <guibutton>Show partial budget</guibutton> option is checked, the budget (and remaining budget) is displayed for whole months, thus you can in the default mode see whats left to spend of the current monthly budget. The third column displays the change in value, while the last column displays the total value.
114
 
                </para>
115
 
                <para>
116
 
                        In the bottom of the accounts view, there is a box for selection period. The period controls within which dates statistics will be shown in the list. If the button for the from (start) date is unchecked, all transactions up til and including the to (end) date will be included. The third, <guilabel>Change</guilabel>, column displays the value of all transactions that occurred between the two dates – the change in total value from start to end date. The last column (<guilabel>Total</guilabel>) displays the total value of all transaction up til and including the end date, plus the initial balance for accounts. If from date is unset, change and total will be equal for all categories. For accounts the total represents the actual money present at the end date, and change the profit during the period.
117
 
                </para>
118
 
                <para>
119
 
                        By default, the period is set to run from the beginning of the current month to (including) current date. Thus, the current state of accounts and transactions so far during the month are shown.
120
 
                </para>
121
 
                <para>
122
 
                        Values for future dates are based on budgets and scheduled transactions (whichever is greatest). An account can be designated as budget account (default for current accounts), meaning that budgeted change will be added to the statistics displayed for this account. Otherwise this will only be added to the summarising account item (thus it will not necessarily equal the sum of account statistics).
123
 
                </para>
124
 
        </sect2>
125
 
</sect1>
126
 
 
127
 
<sect1 id="transactions">
128
 
        <title>Transactions</title>
129
 
        <para>
130
 
                After accounts and categories have been added, you can start recording transactions each time money have been deposited or withdrawn from one of you accounts. If you have kept book before, either on paper, or in another program, you can either import a file (see <xref linkend="import_export"/>) or enter each transaction manually by hand. Just remember to enter the correct opening balance for each account.
131
 
        </para>
132
 
        <para>
133
 
                Transactions can be entered in two ways, either with the new expense/income/transfer dialogs (where you have the option to create a recurring transaction), or from the transaction views. The latter option is usually preferred.
134
 
        </para>
135
 
        <sect2 id="transactions_expenses">
136
 
                <title>Expenses</title>
137
 
                <mediaobject><imageobject><imagedata format="PNG" fileref="expenses-view.png"/></imageobject></mediaobject>
138
 
                <para>
139
 
                        The first time you record an expense you need to follow these steps:
140
 
                        <orderedlist>
141
 
                                <listitem><para>Switch to the expenses view, using the left-hand icons. The input focus is now in the description entry.</para></listitem>
142
 
                                <listitem><para>Type in a description for the expense. Your free to use the description property as you want, but I suggest you keep short and consistent without any inflections, as a subcategory for optimum efficiency and good statistics. For example, if you buy a delicious red royal gala apple and have an expense category for fruit, the description will be <quote>Apple</quote>, and if you want to record additional information put <quote>Delicious red royal gala</quote> as comment (others might find it more appropriate to use <quote>Groceries</quote> as category and <quote>Fruit</quote> as description). Press <keycap>Enter</keycap> or <keycap>Tab</keycap> and focus will move to the cost entry.</para></listitem>
143
 
                                <listitem><para>Enter what you paid. Note that the value should not be negative (except for refunds) and you do not need to type in currency. Press <keycap>Enter</keycap> or <keycap>Tab</keycap>.</para></listitem>
144
 
                                <listitem><para>Select the date when the transaction occurred. To change the date, either write a valid date, select one from the pop-up calendar, or increment/decrement the displayed date with up/down keys. If you now press <keycap>Enter</keycap>, the new expense record will be created, but we do not do that now since the current account and category probably are not correct.</para></listitem>
145
 
                                <listitem><para>Select the correct account (where the money for the expense is taken from) and expense category from the drop-down lists on the right.</para></listitem>
146
 
                                <listitem><para>Optionally enter a comment (memo) for the expense.</para></listitem>
147
 
                                <listitem><para>Click <guibutton>Add</guibutton> or press <keycap>Enter</keycap>.</para></listitem>
148
 
                        </orderedlist>
149
 
                        <note><para><keycap>Enter</keycap> adds a transaction if pressed with input focus in the date or comment entry. Otherwise it moves input focus to the next entry.</para></note>
150
 
                        Repeat the process to record another expense. When you enter the next (and all subsequent expenses) expense you can however usually do it more efficiently. Date, account and category will not be reset each time, so often you need at least not change account. More importantly &eqonomize; remembers the last expense entered for each unique description. When you enter a description, all values, except date, will be filled in with the properties of the last expense with the same description. Even more so, as you type the description a list will pop up with all previous descriptions with matching opening letters. This means that you often will follow this much shorter process:
151
 
                        <orderedlist>
152
 
                                <listitem><para>Type the first letter of a description and select the correct one from the list.</para></listitem>
153
 
                                <listitem><para>Check if the cost is the same this time and press enter.</para></listitem>
154
 
                                <listitem><para>Check the date and press enter.</para></listitem>
155
 
                        </orderedlist>
156
 
                </para>
157
 
        </sect2>
158
 
        <sect2 id="transactions_incomes">
159
 
                <title>Incomes</title>
160
 
                <para>
161
 
                        The same process as for recording expenses is repeated for incomes. Click the incomes icon on the left and enter an income instead of a cost (still positive, but instead means amount deposited, added, to the account).
162
 
                </para>
163
 
        </sect2>
164
 
        <sect2 id="transactions_transfer">
165
 
                <title>Transfers</title>
166
 
                <para>
167
 
                        The record a transfer from one account to another (for example an ATM withdrawal from a bank account to cash) follow the same process as for expenses and incomes. Click the transfer icon on the left. Enter the amount transferred (positive) and select the from account (withdrawn from) and the to account (deposited to).
168
 
                </para>
169
 
        </sect2>
170
 
        <sect2 id="refunds_and_repayments">
171
 
                <title>Refunds &amp; Repayments</title>
172
 
                <para>
173
 
                        You should record a refund instead of an income when you receive money as a refund for a previous expense, to get the statistics right. This can for example be if you return a product and get your money back, or if you buy a present that you and your friend will give to a mutual friend, and you receive your friends share of the cost later.
174
 
                </para>         
175
 
                <para>
176
 
                        The record a new refund use <menuchoice><guimenu>Transactions</guimenu><guimenuitem>New Refund/Repayment</guimenuitem></menuchoice> or the context menu with the refunded expense selected in the expense list. You will have to enter the amount of money refunded (initially set to full refund) and the date of the refund. In addition you should specify the product quantity returned by you. In the first case this is clearly 1, but in the second case this is less clear. It can either be 0.5 if you count it as a half product, or 0 if considered a whole gift (none returned). The use is more obvious if the quantity property is activated for all expenses and incomes. The refund is recorded as an expense with negative cost and quantity.
177
 
                        <mediaobject><imageobject><imagedata format="PNG" fileref="refund.png"/></imageobject></mediaobject>
178
 
                </para>
179
 
                <para>
180
 
                        Repayments are used as refunds, but for incomes that you have been forced to repay.
181
 
                </para>
182
 
        </sect2>
183
 
        <sect2 id="split_transactions">
184
 
                <title>Split Transactions</title>
185
 
                <para>
186
 
                        Split transactions are used when a transfer to/from an account is instantly used for multiple transactions. This is not when money is withdrawn from a bank account through an ATM and you go shopping (that is first a transfer from a bank account to cash, then multiple regular expenses). A split transaction can for example be appropriate when you pay with your credit card in a store and tell them to withdraw some extra money, which you get as cash in your hand. You might also use splits when multiple products is bought with the same payment.
187
 
                </para>
188
 
                <para>
189
 
                        It is up to you how and when you want to use split transactions, as multiple ordinary transactions can be used with the same end result, even though one way might be a bit more correct than the other.
190
 
                </para>         
191
 
                <para>
192
 
                        You can create a split from scratch with <menuchoice><guimenu>Transactions</guimenu><guimenuitem>New Split Transaction...</guimenuitem></menuchoice> or from the context menu. It is however often more efficient to use the join action. This way you can enter transactions the usual way and later join them in a split transactions. Select the transactions to join and activate <guimenuitem>Join Transactions...</guimenuitem> from the <guimenu>Transactions</guimenu> menu or the context menu, and enter a description. All transactions in a split transaction have a common date and account.
193
 
                        <mediaobject><imageobject><imagedata format="PNG" fileref="split-transaction.png"/></imageobject></mediaobject>
194
 
                </para>
195
 
                <para>
196
 
                        To reverse the action and transform transactions in a split transaction to ordinary transactions, select a transaction and use <guimenuitem>Split Up</guimenuitem>.
197
 
                </para>
198
 
                <para>
199
 
                        In transaction list (ledger) for the account associated with the split, the split will be shown as only one transaction, but everywhere else the parts of the split will appear as ordinary transactions.
200
 
                </para>
201
 
        </sect2>
202
 
        <sect2 id="scheduled_transactions">
203
 
                <title>Scheduled Transactions</title>
204
 
                <para>
205
 
                        Transactions that have not occurred yet (with future dates) are called scheduled transactions and have certain special properties. Scheduled transactions can recurring, which means that transactions occurring regularly with certain intervals (usually on a certain day of month) do not need to be entered manually each time. This is often useful for bills and paychecks-
206
 
                </para>         
207
 
                <para>
208
 
                        Single occurrence scheduled transactions are create just like ordinary transactions, except with a future date. Recurring transactions can only be created from the dialogs, with recurrences specified in the second tab.
209
 
                        <mediaobject><imageobject><imagedata format="PNG" fileref="recurrence.png"/></imageobject></mediaobject>
210
 
                </para>         
211
 
                <para>
212
 
                        The next occurrence of each scheduled transaction is displayed in the schedule view. You can edit or delete either the single occurrence or all future recurrences. If a single occurrence is edited, it will be created as a separate transaction, and any changes made to all recurrences will not affect this occurrence. If the date is changed to the current or a past date, the scheduled transaction becomes an ordinary transaction.
213
 
                        <mediaobject><imageobject><imagedata format="PNG" fileref="schedule-view.png"/></imageobject></mediaobject>
214
 
                </para>         
215
 
                <para>
216
 
                        When a scheduled transaction is due, when the current date has gone past the date of the occurrence (or same date after 6 pm), &eqonomize; will ask you to confirm that the transaction really has occurred. You are then given the option to accept the transaction as it is, make some changes (for example the cost of your telephone bill might variate slightly), or postpone it. If the scheduled transaction is not postponed, it will become an ordinary transaction.
217
 
                        <mediaobject><imageobject><imagedata format="PNG" fileref="confirm-schedule.png"/></imageobject></mediaobject>
218
 
                </para>
219
 
        </sect2>
220
 
</sect1>
221
 
 
222
 
<sect1 id="securities">
223
 
        <title>Securities</title>
224
 
        <para>
225
 
                Securities represents money invested in stock, bonds and mutual funds. Securities and associated statistics are displayed in the securities view (accessed using the icons on the left).
226
 
        </para> 
227
 
        <para>
228
 
                The create a new security in &eqonomize; use <menuchoice><guimenu>Securities</guimenu><guimenuitem>New Security...</guimenuitem></menuchoice> or the <guibutton>New Security...</guibutton> button. First select account. Securities are associated with an account of securities type, which cannot be associated with ordinary transactions. Enter name of the security and select type. Specify initial shares if you do not want to back-track all transactions (it is always preferred to use transactions instead, for better statistics). Specify then also date and quotation.
229
 
                <mediaobject><imageobject><imagedata format="PNG" fileref="new-security.png"/></imageobject></mediaobject>
230
 
        </para>
231
 
        <sect2 id="security_transactions">
232
 
                <title>Security Transactions</title>
233
 
                <para>
234
 
                        The following transactions are supported for securities:
235
 
                        <variablelist>
236
 
                                <varlistentry><term>Shares bought</term><listitem><para>When more shares of a security have been bought. Specify new shares, price per share (quotation given) and total cost, including fees/commission.<mediaobject><imageobject><imagedata format="PNG" fileref="security-buy.png"/></imageobject></mediaobject></para></listitem></varlistentry>
237
 
                                <varlistentry><term>Shares sold</term><listitem><para>When some shares of a security have been sold. Specify new shares, price per share and total cost, including fees/commission.</para></listitem></varlistentry>
238
 
                                <varlistentry><term>Shares traded</term><listitem><para>When shares of one security are sold and shares of another security are bought for the same amount of money, without transfer of sell income to an account in between.</para></listitem></varlistentry>
239
 
                                <varlistentry><term>Dividend</term><listitem><para>When money is received for each share of a security. Specify income and income category.</para></listitem></varlistentry>
240
 
                                <varlistentry><term>Reinvested dividend</term><listitem><para>When dividend is received as additional shares.</para></listitem></varlistentry>
241
 
                        </variablelist>
242
 
                </para>
243
 
                <para>
244
 
                        All security transactions are listed listed as transfers (in the transfers view), except dividends, and shares bought if associated with an income category, which are displayed as incomes. You can list all transactions for a single security using <menuchoice><guimenu>Securities</guimenu><guimenuitem>Transactions...</guimenuitem></menuchoice> (or the context menu).
245
 
                </para>
246
 
        </sect2>
247
 
        <sect2 id="securities_view">
248
 
                <title>The Securities View</title>
249
 
                <mediaobject><imageobject><imagedata format="PNG" fileref="securities-view.png"/></imageobject></mediaobject>
250
 
                <para>
251
 
                        Statistics displayed for each security:
252
 
                        <variablelist>
253
 
                                <varlistentry><term>Value</term><listitem><para>Value at period end date date (quotation * shares).</para></listitem></varlistentry>
254
 
                                <varlistentry><term>Quotation</term><listitem><para>Price per share at period end date.</para></listitem></varlistentry>
255
 
                                <varlistentry><term>Shares</term><listitem><para>Shares at period end date.</para></listitem></varlistentry>
256
 
                                <varlistentry><term>Cost</term><listitem><para>Total price paid for all buys minus sells, at end date.</para></listitem></varlistentry>
257
 
                                <varlistentry><term>Profit</term><listitem><para>Profit during the period (value + dividends - cost).</para></listitem></varlistentry>
258
 
                                <varlistentry><term>Yearly Rate</term><listitem><para>Percent increase of value per share (for a share bought at the beginning of the period), during the period on a yearly basis. Includes dividends.</para></listitem></varlistentry>
259
 
                        </variablelist>
260
 
                        In the total statistics displayed below the security list, quotation and yearly rate are weighted based on the value of each security.
261
 
                </para>
262
 
                <para>
263
 
                        Predictions are simplistic and base on previous development, with respect to dividends and quotations, only. Future quotations are calculated using quotations during the nearest past time. The quotation one month from current date is assumed to have increased at the same rate as during the past month (or the date before with a specified quotation). Dividends are always predicted using full past years (they are assumed to occur on a yearly basis).
264
 
                </para>
265
 
        </sect2>
266
 
</sect1>
267
 
 
268
 
<sect1 id="saving">
269
 
        <title>Saving</title>
270
 
        <para>
271
 
                When you have made some changes you need to save your work. Save the file using <menuchoice><guimenu>File</guimenu><guimenuitem>Save</guimenuitem></menuchoice> (<keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo>) or the corresponding toolbar button. The first time your work is saved &eqonomize; will ask for a location and name for the file. &eqonomize; will then automatically open that file each time the program is started.
272
 
        </para> 
273
 
        <para>
274
 
                If when exiting &eqonomize; there are some changes that have been made after the last save, you will be asked if the file should be saved before closing. If you in the dialog toggle <guilabel>Do not ask again</guilabel> and click <guibutton>Yes</guibutton> the file will automatically be saved each time &eqonomize; is closed.
275
 
                <mediaobject><imageobject><imagedata format="PNG" fileref="ask-save.png"/></imageobject></mediaobject>
276
 
        </para>
277
 
        <para>
278
 
                Before the file is saved, a backup copy is made with the name prefixed by <quote>~</quote>. Also, at most once per minute, the current data is saved (in the default KDE autosave folder, usually ~/autosave), to prevent data loss in case &eqonomize; exits unexpectedly (if for example you by accident hit the reset button on the computer).
279
 
        </para>
280
 
</sect1>
281
 
 
282
 
<sect1 id="import_export">
283
 
        <title>Import &amp; Export of Data</title>
284
 
        <sect2 id="qif_import">
285
 
                <title>QIF Import</title>               
286
 
                <para>
287
 
                        Select <menuchoice><guimenu>File</guimenu><guisubmenu>Import</guisubmenu><guimenuitem>Import QIF File...</guimenuitem></menuchoice> and follow the instructions. QIF is a file format that might differ much depending on the software that saved the file. How much details you will need to provide about the file depends on ambiguity of the date format, how localised the file is, and how well accounts are defined. Securities, investment transactions, memorised transactions, budgets, and classes are not imported.
288
 
                        <mediaobject><imageobject><imagedata format="PNG" fileref="qif-date-format.png"/></imageobject></mediaobject>
289
 
                </para>         
290
 
        </sect2>
291
 
        <sect2 id="csv_import">
292
 
                <title>CSV Import</title>
293
 
                <para>
294
 
                        This function imports data files with clear text values in columns separated by a character (comma, space, tab, etc.), with a new transaction on each row. Select <menuchoice><guimenu>File</guimenu><guisubmenu>Import</guisubmenu><guimenuitem>Import CSV File...</guimenuitem></menuchoice> and enter details about the structure of the file you want to import. Transaction parameters can either be imported from a column in the file or a set to a specified value.
295
 
                        <mediaobject><imageobject><imagedata format="PNG" fileref="csv-columns.png"/></imageobject></mediaobject>
296
 
                </para>
297
 
        </sect2>
298
 
</sect1>
299
 
</chapter>
300
 
 
301
 
<chapter id="accounting">
302
 
        <title>Accounting with &eqonomize;</title>
303
 
        
304
 
        <sect1 id="accounting-overview">
305
 
                <title>Overview</title>
306
 
                
307
 
                <para>
308
 
                        The basics principle behind accounting in &eqonomize; is the idea of money flowing through transactions between accounts as reservoirs. A transaction represents a gain (you receive money), loss (you buy something), or transformation (you withdray from or deposit in a bank account) of money.
309
 
                </para>
310
 
                <para>
311
 
                        A transaction always means that money is moved from one account to another. An expense (something is bought) can for example mean that you pay with cash from your cash account. The money is then put in an expense account. This account represents the products and services you pay for. It represents the money that you do not have as a result of expenses, and is therefor useful for record keeping.
312
 
                </para>
313
 
                <para>
314
 
                        Incomes is usually put in a bank account and withdrawn from an income account. This means that income accounts will have a negative value, but to avoid confusion, the value of income accounts are shown as positive values.
315
 
                </para>
316
 
                <para>
317
 
                        Different income and expense accounts are used for categorisation, and are therefor more naturally referred to as categories. Other accounts, which represents the money you actually have and often are real world bank accounts, are simply referred to as accounts.
318
 
                </para>
319
 
                
320
 
        </sect1>
321
 
        
322
 
        <sect1 id="accounting-accounts">
323
 
                <title>Accounts and Categories</title>
324
 
                
325
 
                <para>
326
 
                        
327
 
                </para>
328
 
                
329
 
        </sect1>
330
 
        
331
 
        <sect1 id="accounting-transactions">
332
 
                <title>Transactions</title>
333
 
                
334
 
                <para>
335
 
                        &eqonomize; has three different basic transactions types – expenses, incomes, and transfers. Securities uses some special transactions which are described in <xref linkend="accounting-securities"/>.
336
 
                </para>
337
 
                <para>
338
 
                        Expenses represents a loss of money, a transaction where you give away money, mostly in return for something else. This can be a payment for products and services, or a gift (or you lend someone money).
339
 
                </para>
340
 
                <para>
341
 
                        Incomes represents a gain of money; when you are given money. This is when your at the other end of an expense, when you receive payment for products and services you provide (often as salary for your regular job), or when someone gives you money as a gift or loan.
342
 
                </para>
343
 
                <para>
344
 
                        The third transaction type, the transfer, represents neither a loss nor gain, but a transfer of money from one account to another. This can for example be when you withdraw money from your bank account as cash, or you transfer money to a savings account.
345
 
                </para>
346
 
                <para>
347
 
                        Each transaction has a number of mandatory or optional properties. All the basic transactions have four mandatory properties – value, date, and from and to accounts/categories. Value represents the amount of money that is affected by the transaction, date when the transaction occurred, from account where the money was taken from and to account where money was put. These are the generic property names, which shows that all transaction types basically are the same.
348
 
                </para>
349
 
                <para>
350
 
                        For expenses the value is a cost, a positive value representing a loss of money and the to account/category is called category and the from account/category is the account that the expense is payed from. The category is always an expense category and the from account/category an account.
351
 
                </para>
352
 
                <para>
353
 
                        For incomes the value is an income, a positive value representing a gain of money and the from account/category is called category and the the to account/category is the account that the income is deposited in. The category is always an income category and the to/from account an account.
354
 
                </para>
355
 
                <para>
356
 
                        For transfers the value is called amount, and the to and from accounts/categories are both accounts.
357
 
                </para>
358
 
                <table id="qalculate-TBL-mandatory-properties" frame="topbot" colsep="1">
359
 
                        <title>Mandatory Properties</title>
360
 
                        <tgroup cols="2" colsep="1" rowsep="0">
361
 
                                <colspec colname="COLSPEC0"/>
362
 
                                <colspec colname="COLSPEC1"/>
363
 
                                <colspec colname="COLSPEC2"/>
364
 
                                <colspec colname="COLSPEC3"/>
365
 
                                <thead>
366
 
                                        <row valign="top">
367
 
                                                <entry colname="COLSPEC0"><para>Generic</para></entry>
368
 
                                                <entry colname="COLSPEC1"><para>Expense</para></entry>
369
 
                                                <entry colname="COLSPEC2"><para>Income</para></entry>
370
 
                                                <entry colname="COLSPEC2"><para>Transfer</para></entry>
371
 
                                        </row>
372
 
                                </thead>
373
 
                                <tbody>
374
 
                                        <row valign="top">
375
 
                                                <entry><para>Value</para></entry>
376
 
                                                <entry><para>Cost</para></entry>
377
 
                                                <entry><para>Income</para></entry>
378
 
                                                <entry><para>Amount</para></entry>
379
 
                                        </row>
380
 
                                        <row valign="top">
381
 
                                                <entry><para>Date</para></entry>
382
 
                                                <entry><para>Date</para></entry>
383
 
                                                <entry><para>Date</para></entry>
384
 
                                                <entry><para>Date</para></entry>
385
 
                                        </row>
386
 
                                        <row valign="top">
387
 
                                                <entry><para>From Account/Category</para></entry>
388
 
                                                <entry><para>Account (account)</para></entry>
389
 
                                                <entry><para>Category (income category)</para></entry>
390
 
                                                <entry><para>From (account)</para></entry>
391
 
                                        </row>
392
 
                                        <row valign="top">
393
 
                                                <entry><para>To Account/Category</para></entry>
394
 
                                                <entry><para>Category (expense category)</para></entry>
395
 
                                                <entry><para>Account (account)</para></entry>
396
 
                                                <entry><para>To (account)</para></entry>
397
 
                                        </row>
398
 
                                </tbody>
399
 
                        </tgroup>
400
 
                </table>
401
 
                <para>
402
 
                        All transactions do in addition have two optional properties. The description property provides information about the nature of the transaction. For expenses and incomes this can be considered a flexible subcategory. The comment property is used for any additional information, not used for categorisation, about the transaction. If you for example buy a pair of shoes, you might create an expense in a clothing category, with the description <quote>Shoes</quote> and comments <quote>Shiny red Pradas</quote>.
403
 
                </para>
404
 
                <para>
405
 
                        Expenses and incomes do also have two properties which are not by default activated in the program. The quantity property denotes how many entities was involved in the transaction. This can be a whole number, as in two CD's, or a fraction, as in 0.56 kg apples (units are not included). This property is by default set to 1 and does not affect the value (the value per entity equals the value divided by the quantity). Expenses also have a payee property for the person or entity, for example the store where goods where bought, which receives the money, and incomes have payer property for the one who gives you the money, for example your employer.
406
 
                </para>
407
 
                
408
 
        </sect1>
409
 
        
410
 
        <sect1 id="accounting-schedule">
411
 
                <title>Scheduled Transactions</title>
412
 
                
413
 
                <para>
414
 
                        A scheduled transaction is a transaction that is planned to occur, thus it has not occurred yet. It is basically just a transaction, of any type, that has a date set in the future. When a scheduled transaction has occurred, it becomes a regular transaction. Scheduled transactions makes it possible to keep track of and be reminded of future transactions. &eqonomize; will request for a confirmation when the transaction is expected to have occurred.
415
 
                </para>
416
 
                <para>
417
 
                        A scheduled transaction can be recurring, thus it will regularly occur on a certain date or with a certain interval. This is useful mostly for bills and salaries, which then need not be entered manually each time and you can check &eqonomize; for upcoming payments. When a scheduled recurring transaction has occurred, a regular transaction is created, the occurrence date is removed from the recurrence, and the scheduled transaction date is moved forward to the next occurrence. A scheduled transaction with no occurrences left is removed.
418
 
                </para>
419
 
                
420
 
        </sect1>
421
 
        
422
 
        <sect1 id="accounting-securities">
423
 
                <title>Securities</title>
424
 
                
425
 
                <para>
426
 
                        
427
 
                </para>
428
 
                
429
 
        </sect1>
430
 
        
431
 
</chapter>
432
 
 
433
 
<chapter id="commands">
434
 
<title>Command Reference</title>
435
 
 
436
 
<sect1 id="eqonomize-mainwindow">
437
 
<title>The main &eqonomize; window</title>
438
 
 
439
 
<sect2>
440
 
<title>The File Menu</title>
441
 
<para>
442
 
<variablelist>
443
 
<varlistentry>
444
 
<term><menuchoice>
445
 
<shortcut>
446
 
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
447
 
</shortcut>
448
 
<guimenu>File</guimenu>
449
 
<guimenuitem>New</guimenuitem>
450
 
</menuchoice></term>
451
 
<listitem><para><action>Creates a new document</action></para></listitem>
452
 
</varlistentry>
453
 
<varlistentry>
454
 
<term><menuchoice>
455
 
<shortcut>
456
 
<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
457
 
</shortcut>
458
 
<guimenu>File</guimenu>
459
 
<guimenuitem>Save</guimenuitem>
460
 
</menuchoice></term>
461
 
<listitem><para><action>Saves the document</action></para></listitem>
462
 
</varlistentry>
463
 
<varlistentry>
464
 
<term><menuchoice>
465
 
<shortcut>
466
 
<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
467
 
</shortcut>
468
 
<guimenu>File</guimenu>
469
 
<guimenuitem>Quit</guimenuitem>
470
 
</menuchoice></term>
471
 
<listitem><para><action>Quits</action> &eqonomize;</para></listitem>
472
 
</varlistentry>
473
 
</variablelist>
474
 
</para>
475
 
 
476
 
</sect2>
477
 
 
478
 
<sect2>
479
 
<title>The <guimenu>Help</guimenu> Menu</title>
480
 
 
481
 
&help.menu.documentation;
482
 
 
483
 
</sect2>
484
 
 
485
 
</sect1>
486
 
</chapter>
487
 
 
488
 
<chapter id="faq">
489
 
<title>Questions and Answers</title>
490
 
 
491
 
<qandaset id="faqlist">
492
 
<qandaentry>
493
 
<question>
494
 
<para>How do I change the currency used?</para>
495
 
</question>
496
 
<answer>
497
 
        <para>Change the money settings in the KDE Control Center under <menuchoice><guimenu>Regional &amp; Accessibility</guimenu><guisubmenu>Country/Region &amp; Language</guisubmenu></menuchoice>. Note that the this only affects the currency symbol displayed. The actual data does not use any specific currency.</para>
498
 
</answer>
499
 
</qandaentry>
500
 
</qandaset>
501
 
</chapter>
502
 
 
503
 
<chapter id="credits">
504
 
 
505
 
<!-- Include credits for the programmers, documentation writers, and
506
 
contributors here. The license for your software should then be included below
507
 
the credits with a reference to the appropriate license file included in the KDE
508
 
distribution. -->
509
 
 
510
 
<title>Credits and License</title>
511
 
 
512
 
<para>
513
 
&eqonomize;
514
 
</para>
515
 
<para>
516
 
Program copyright 2006 Hanna K. <email>hanna_k@fmgirl.com</email>
517
 
</para>
518
 
<para>
519
 
Contributors:
520
 
<itemizedlist>
521
 
<listitem><para>Hanna K. <email>hanna_k@fmgirl.com</email></para>
522
 
</listitem>
523
 
</itemizedlist>
524
 
</para>
525
 
 
526
 
<para>
527
 
Documentation copyright 2006 Hanna K. <email>hanna_k@fmgirl.com</email>
528
 
</para>
529
 
 
530
 
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
531
 
 
532
 
&underFDL;               <!-- FDL: do not remove -->
533
 
 
534
 
<!-- Determine which license your application is licensed under, 
535
 
     and delete all the remaining licenses below:
536
 
 
537
 
     (NOTE:  All documentation are licensed under the FDL, 
538
 
     regardless of what license the application uses) -->
539
 
 
540
 
&underGPL;               <!-- GPL License -->
541
 
 
542
 
</chapter>
543
 
 
544
 
&documentation.index;
545
 
</book>
546
 
 
547
 
<!--
548
 
Local Variables:
549
 
mode: sgml
550
 
sgml-minimize-attributes:nil
551
 
sgml-general-insert-case:lower
552
 
sgml-indent-step:0
553
 
sgml-indent-data:nil
554
 
End:
555
 
 
556
 
vim:tabstop=2:shiftwidth=2:expandtab 
557
 
-->
558