- 
- 
- Note that the two income accounts offset one another so - that the current income resulting from the +
Note that the two income accounts offset one another so + that the current income resulting from the transaction is only $55. The remaining $5000 had previously - been recognized as Accrued Gain Income.
+ been recognized as Accrued Gain Income.Instead of the $16055 you thought the painting was - worth are only offered $15000. But you still decide to - sell, because you value $15000 more than you value the +
Instead of the $16055 you thought the painting was worth + are only offered $15000. But you still decide to sell, + because you value $15000 more than you value the painting.
-The numbers change a little bit, but not too +
The numbers change a little bit, but not too dramatically.
Note that the two income accounts offset one another so - that the current income resulting from the - transaction turns out to be a loss of $1000. +
Note that the two income accounts offset one another so + that the current income resulting from the + transaction turns out to be a loss of $1000. That's fine, as you had previously recognized $5000 in income.
The extra value is, again, recorded as a gain,
+ The extra value is, again, recorded as a gain,
i.e. an income. In practice, it truly is important to keep the Accrued
- Gain Income separate from the Realized Gain
+ In practice, it truly is important to keep the Accrued
+ Gain Income separate from the Realized Gain
Income, as the former is likely to be ignored by your tax
authorities, who will only care to charge you on the
Realized Gain. It is quite easy to count yourself rich based on
+ It is quite easy to count yourself rich based on
questionable estimates that do not reflect "money in the
bank." Thus, when dealing with appreciation of assets, Thus, when dealing with appreciation of assets, Do not indulge in wishful thinking. Do not indulge in wishful thinking. Until you have actually sold your asset and got the
+ Until you have actually sold your asset and got the
money, any numbers on paper (or magnetic patterns on your
hard disk) are merely that. If you could realistically convince a banker to lend
- you money, using the assets as collateral, that is a pretty
+ If you could realistically convince a banker to lend you
+ money, using the assets as collateral, that is a pretty
reasonable evidence that the assets have value, as lenders
are professionally suspicious of dubious overestimations of
value. Be aware: all too many companies that appear
+ Be aware: all too many companies that appear
"profitable" on paper go out of business as a result of
- running out of cash, precisely because "valuable
+ running out of cash, precisely because "valuable
assets" were not the same thing as cash. Taxation policies vary considerably between countries, so
- it is virtually impossible to say anything that will be
+ Taxation policies vary considerably between countries, so it
+ is virtually impossible to say anything that will be
universally useful. However, it is common for income generated by
+ However, it is common for income generated by
capital gains to not be subject to taxation until the date that
the asset is actually sold, and sometimes not even then. North American home owners usually find that when
+ North American home owners usually find that when
they sell personal residences, capital gains that occur are
exempt from taxation. It appears that other countries treat
sale of homes differently, taxing people on such gains. German
authorities, for example, tax those gains only if you owned the
property for less than ten years. I have one story
- from my professional tax preparation days where a family sold a
+ I have one story from
+ my professional tax preparation days where a family sold a
farm, and expected a considerable tax bill that turned
out to be virtually nil due to having owned the property before
1971 (wherein lies a critical "Valuation Day" date in Canada)
- and due to it being a dairy farm, with some
- really peculiar resulting deductions. In short, this presentation is fairly simple, but taxation
+ In short, this presentation is fairly simple, but taxation
often gets terribly complicated... Since depreciation of assets is very often driven by tax
+ Since depreciation of assets is very often driven by tax
policies, the discussion of depreciation will focus in that
direction, on some of the more common depreciation calculation
schemes. While there has been some discussion about how to
- accomplish automated calculation and creation of transactions
- to handle things like depreciation, there is not yet any
- working code, so for now, you will have to do calculations by
- hand. While there has been some discussion about how to accomplish
+ automated calculation and creation of transactions to handle
+ things like depreciation, there is not yet any working code, so
+ for now, you will have to do calculations by hand. Linear depreciation diminishes the value of an asset by a
+ Linear depreciation diminishes the value of an asset by a
fixed amount each period until the net value is zero. This is
the simplest calculation, as you estimate a useful
lifetime, and simply divide the cost equally across that
@@ -541,16 +540,15 @@
Each period the asset is depreciated by a fixed percentage
of its value in the previous period. In this scheme the rest
value of an asset decreases exponentially leaving a value at
- the end that is larger than zero ( i.e. - a resale
+ the end that is larger than zero ( i.e. - a resale
value). Beware: Tax authorities may require (or allow) a
- larger percentage in the first period. On the other hand,
- in Canada, this is reversed, as they permit only a
- half share of "Capital Cost Allowance" in the first
- year. Beware: Tax authorities may require (or allow) a larger
+ percentage in the first period. On the other hand, in
+ Canada, this is reversed, as they permit only a half
+ share of "Capital Cost Allowance" in the first year. The result of this approach is that asset value decreases
+ The result of this approach is that asset value decreases
more rapidly at the beginning than at the end which is
probably more realistic for most assets than a linear
scheme. This is certainly true for automobiles. Example: First you divide the asset value
- by the sum of the years of use, e.g. for our example
+ by the sum of the years of use, e.g. for our example
from above with an asset worth $1500 that is used over a period
of five years you get 1500/(1+2+3+4+5)=100. Depreciation and
asset value are then calculated as follows: Since depreciation and tax issues are closely related, you
- may not always be free in choosing your preferred method. Fixing
- wrong calculations will cost a whole lot more time and trouble
- than getting the calculations right the first time, so if you
- plan to depreciate assets, it is wise to make sure of the
- schemes you will be permitted or required to use. Return to Main Documentation
+ Return to Main Documentation
Page. FIXME: Document this report!
- Return to Main Documentation
- Page. FIXME: Document this report! Return to Main Documentation
+ Page. This report summarizes your assets, liabilities, and equity. There are currently no options for this report, but the option
- to specify a date for which the balance sheet is to be calculated
- will be added soon. Return to Main Documentation
- Page. This report summarizes your assets, liabilities, and
+ equity. There are currently no options for this report, but the
+ option to specify a date for which the balance sheet is to be
+ calculated will be added soon. Return to Main Documentation
+ Page. A Double Entry bookkeeping
+ A Double Entry bookkeeping
system stores both values, and requires that all
- transactions balance, as described in the Double Entry Identity. When we introduce the notion of having multiple currencies,
+ When we introduce the notion of having multiple currencies,
or stocks that may vary in price, the identities get a little
more complicated, and we introduce the following formulae: The engine links together all three of these values
- (1.0, 150, 0.00667) permanently and makes it impossible
- to change one without changing another, so that the grand total
- is always zero, thereby guaranteeing satisfaction of the double entry accounting
+ (1.0, 150, 0.00667) permanently and makes it impossible to
+ change one without changing another, so that the grand total is
+ always zero, thereby guaranteeing satisfaction of the double entry accounting
identity. More currencies than you thought possible... More currencies than you thought possible... Return to Main Documentation
+ Return to Main Documentation
Page. Return to Main Documentation
+ Return to Main Documentation
Page. If you are a beginner, a novice, you need double entry accounting
-to help you avoid beginner mistakes. It will keep you from creating
-an unauditable mess. It will make your life easier, and it will make
-this software easier to understand and to use.
-And if you are an experienced accountant, then you would only turn ill
-at the thought of life without it.
+ If you are a novice to accounting, you need double
+ entry accounting to help you keep your accounts straight. It
+ will keep you from creating an unverifiable mess. It will make
+ your life easier, and it will make this software easier to
+ understand and to use. And if you are an experienced accountant, you would likely
+ feel ill at the thought of life without it. Double entry bookkeeping is an accounting methodology
+ Double entry bookkeeping is an accounting methodology
introduced in the 13th century to to make sure that each
- accounts and indeed each transaction is properly
+ accounts and indeed each transaction is properly
balanced. When these are all required to balance, the likelihood of
+ When these are all required to balance, the likelihood of
data-entry errors is greatly reduced. For large, complex sets
of accounts with many transactions, it is distressingly easy to
make errors that may go undetected for a long time, and be
appallingly difficult to track down, even when double-entry
bookkeeping is used. A double-entry transaction is a transaction that contains
+ A double-entry transaction is a transaction that contains
entries for two (or more) accounts that balance against one
another. One account is debited by an amount exactly
equal to what the other is credited. By ensuring that
each transaction balances, a balanced set of accounts is
guaranteed. This doesn't prevent you from having errors, but
- certainly eliminates the large class of I forgot to enter
+ certainly eliminates the large class of I forgot to enter
that part of the transaction errors. Double-entry may be introduced in a more intuitive way via
+ Double-entry may be introduced in a more intuitive way via
the notion of a transfer from one bank account to another,
where an amount is taken out of one bank account and deposited
in the other. This is effectively the "rule" of double entry
accounting; if you add something in to one account, you
have to have another component to that transaction to
- balance this. Not-quite-an-aside: If you look at your bank
+ Not-quite-an-aside: If you look at your bank
statements, they are typically written up from the
- bank's perspective, which is exactly opposite to
+ bank's perspective, which is exactly opposite to
yours. For instance, when you put money in, establishing a
- deposit, this establishes a DEBT on their part. The perhaps less obvious extension is the notion that
- double entry can be used to represent income and expenses as
- well as bank transfers. See the
+ The perhaps less obvious extension is the notion that double
+ entry can be used to represent income and expenses as well as
+ bank transfers. See the
Income/Expense page for a more detailed discussion of
that. To change the transfer account, simply select a new account
+ To change the transfer account, simply select a new account
from the pull-down menu. When you record the transaction, it
will automatically be selected from the old account, and
inserted into the new account. GnuCash can be configured to be strict about double entry,
+ GnuCash may be configured to be strict about double entry,
or you may configure it to be "loose." In "loose" mode, you can create unbalanced
+ In "loose" mode, you can create unbalanced
transactions, that is, transactions where the "splits"
don't balance to zero. That discards the validation that comes
from using the more strict double entry scheme, which is
@@ -138,27 +146,36 @@ at the thought of life without it.
But if you decide to "outsmart the system," and have a
+ But if you decide to "outsmart the system," and have a
number of unbalanced transactions, you'll probably want to
clean this up at some point. To clean up these unbalanced
- transactions, you Scrub the account clean by choosing
- Scrub from the window menu. This will examine each
- transaction; if the transaction doesn't balance, a split entry
- will be created and placed into an account named
- Unbalanced. You may then review these splits and move them
- to their proper accounts. The process will examine each transaction; if the
+ transaction doesn't balance, a split entry will be created and
+ placed into an account named Unbalanced. You may then
+ review these splits and move them to their proper accounts. Warning: Functionality Changing... At present, control over whether GnuCash is "strict" or
+ "loose" is established at compile time, and defaults to
+ strict. In the future, there will be no option of "looseness." Return to Main Documentation
+ Return to Main Documentation
Page. On January 1, 1999, eleven European Union countries formed
an economic and monetary union (EMU) and started using a single
currency - the euro. These countries locked the exchange rates
of their national currencies to the euro and are sharing the
new currency. However, euro notes and coins will not be available until
+
+ However, euro notes and coins will not be available until
January 1, 2001. Until then, the old national currency notes
and coins (French francs, Deutschmarks etc) will continue to
- circulate. But in law they are part of the euro. Their value
- in euro is completely fixed. All kinds of cashless monetary
+ circulate. But in law they are part of the euro. Their value in
+ euro is completely fixed. All kinds of cashless monetary
transactions like cheques or wire transfers are possible in
euro You can find more information about the euro at:
- http://europa.eu.int/euro
- . You can find more information about the euro at: http://europa.eu.int/euro . The following table shows the EMU member countries and
- the respective exchange rates of the euro to the old national
- currencies. More countries are expected to join the EMU later. The following table shows the EMU member countries and the
+ respective exchange rates of the euro to the old national
+ currencies. More countries are expected to join the EMU
+ later. You can enable euro support in GnuCash in the international
category of the preferences
- dialog box. If your system locale specifies one of the
- EMU member currencies, euro support
- is enabled by default. FIXME: Actual documentation with screenshots and so on Return to Main Documentation
+ Return to Main Documentation
Page. The words "Income" and "Expense" are beguilingly simple;
- everyone thinks they know what they mean; this
- usually is that When I spend something, this is an
+ The words "Income" and "Expense" are beguilingly simple;
+ everyone thinks they know what they mean; this
+ usually is that When I spend something, this is an
expense, and when I get money, this is an income. This oversimplifies things somewhat; it is often a
+ This oversimplifies things somewhat; it is often a
good-enough approximation when doing personal accounting,
but when running a business, incomes and expenses often have be
recognized as having occurred when some "critical event" takes
place that may not perfectly correspond to "when cash comes in
or goes out." For instance, companies usually have to recognize income
- when the sale occurs. That may mean that I have to
- recognize a $100,000 sale at the moment I and the customer
+ For instance, companies usually have to recognize income
+ when the sale occurs. That may mean that I have to
+ recognize a $100,000 sale at the moment I and the customer
shake hands on the deal. Since the money hasn't come in, the sale has to be
- estimated in other way; the way this is done is to
- accrue a sale at that time, and in making the transaction
- balance, rather than adding something in to cash, I'd add the
- $100,000 sale to Accounts Receivable. Since the money hasn't come in, the sale has to be estimated
+ in other way; the way this is done is to accrue a sale
+ at that time, and in making the transaction balance, rather
+ than adding something in to cash, I'd add the $100,000 sale to
+ Accounts Receivable. In a double entry system, two kinds of accounts must be
+ In a double entry system, two kinds of accounts must be
created: some of type "Income" and others of type "Expense."
(There tend to be a lot more different kinds of expenses than
there are of incomes.) Income such as salary, wages, bank interest and stock
+ Income such as salary, wages, bank interest and stock
dividends are then recorded as transfers from an income account
to a bank (or, in general, some asset) account. Similarly,
expenses are recorded as transfers from a credit card account
(or, in general, a liability account). Another way of describing the requirement for "double
- entry" is that when you receive an income, two things
- happen: Another way of describing the requirement for "double entry"
+ is that when you receive an income, two things happen: When, for instance, salary is deposited in a bank account,
+ When, for instance, salary is deposited in a bank account,
the bank account is credited, and the income account is
debited, thus: There may be a whole lot more than two entries in the
+ There may be a whole lot more than two entries in the
transaction, but the total sum of the Debits, $1,600.00, still
equals the total sum of the credits, $1,600.00. If, as with GnuCash, everything is forced onto one
- column, so that debits are represented by positive
- values, and credits are represented by negative values,
+ If, as with GnuCash, everything is forced onto one
+ column, so that debits are represented by positive
+ values, and credits are represented by negative values,
the income/expense accounts do a slightly non-intuitive thing
- and you see incomes as negative values. That
+ and you see incomes as negative values. That
appears contrary to intuition, but is nonetheless
necessary in order for the
- double-entry bookkeeping identity to hold true.
@@ -364,8 +364,8 @@
-
-
Taxation of Capital Gains
- Depreciation of assets
@@ -459,22 +459,21 @@
of use.
- Depreciation schemes
Linear depreciation
- A word of caution
Balance Tracking Report
-
-
+
+ Balance Sheet
- Balance Sheet
+
+ Currency Handling and Double Entry Bookkeeping
+ Currency Handling and Double Entry Bookkeeping
-
Date xfer from memo cost
@@ -44,7 +46,7 @@
Date xfer from memo purchase rate
@@ -55,16 +57,16 @@
ISO Currency Codes
+ ISO Currency Codes
-
@@ -1202,7 +1204,7 @@
-
-
- Why Use Double Entry Accounting?
-What is Double Entry Accounting?
- Scrubbing Clean
-
-
- GnuCash and the EURO
+ GnuCash and the EURO
- Introduction
+ Introduction
EMU Member Countries and Exchange Rates
+ EMU Member Countries and Exchange Rates
+
-
-
-
-
Country
+
ISO Code
- Full Description
- Exchange Rate
+
+ Full Description
+
+ Exchange Rate
@@ -53,94 +58,128 @@
-
Austria
- ATS
- Austrian Schilling
- 1 euro = 13.7603 S
+ Austria
+
+ ATS
+
+ Austrian Schilling
+
+ 1 euro = 13.7603 S
-
Belgium
- BEF
- Belgian Franc
- 1 euro = 40.3399 bfrs
+ Belgium
+
+ BEF
+
+ Belgian Franc
+
+ 1 euro = 40.3399 bfrs
-
Finland
- FIM
- Finnish Mark
- 1 euro = 5.94573 Fmk
+ Finland
+
+ FIM
+
+ Finnish Mark
+
+ 1 euro = 5.94573 Fmk
-
France
- FRF
- French Franc
- 1 euro = 6.55957 FF
+ France
+
+ FRF
+
+ French Franc
+
+ 1 euro = 6.55957 FF
-
Germany
- DEM
- German Mark
- 1 euro = 1.95538 DM
+ Germany
+
+ DEM
+
+ German Mark
+
+ 1 euro = 1.95538 DM
-
Ireland
- IEP
- Irish Pound
- 1 euro = 0.787564 Ir. £
+ Ireland
+
+ IEP
+
+ Irish Pound
+
+ 1 euro = 0.787564 Ir. £
-
Italy
- ITL
- Italian Lira
- 1 euro = 1936.27 Lit
+ Italy
+
+ ITL
+
+ Italian Lira
+
+ 1 euro = 1936.27 Lit
-
Luxembourg
- LUF
- Luxembourgian Franc
- 1 euro = 40.3399 lfrs
+ Luxembourg
+
+ LUF
+
+ Luxembourgian Franc
+
+ 1 euro = 40.3399 lfrs
-
Netherlands
- NLG
- Dutch Guilder
- 1 euro = 2.20371 hfl
+ Netherlands
+
+ NLG
+
+ Dutch Guilder
+
+ 1 euro = 2.20371 hfl
-
Portugal
- PTE
- Portuguese Escudo
- 1 euro = 200.482 Esc
+ Portugal
+
+ PTE
+
+ Portuguese Escudo
+
+ 1 euro = 200.482 Esc
-
Spain
- ESP
- Spanish Peseta
- 1 euro = 166.386 Ptas
+ Spain
+
+ ESP
+
+ Spanish Peseta
+
+ 1 euro = 166.386 Ptas
EURO support in GnuCash
+ EURO support in GnuCash
What are Incomes and Expenses?
-
-
-
Another way in which income and expense accounts are - special is that their account totals do not directly appear on - a balance sheet. A balance sheet shows "Net Worth": the sum of +
Another way in which income and expense accounts are special + is that their account totals do not directly appear on a + balance sheet. A balance sheet shows "Net Worth": the sum of all assets minus all liabilities.
-Income and expenses are neither assets nor liabilities, and +
Income and expenses are neither assets nor liabilities, and so do not appear on the balance sheet. What appears on the - balance sheet is their effects on equity.
+ balance sheet is their effects on equity. -There is a separate report, a "Profit and Loss" (P&L) +
There is a separate report, a "Profit and Loss" (P&L) report, to analyze income and expenses. The total profit (or loss) is calculated as total income less total expenses. In a nicely symmetrical fashion, since assets and liabilities are - neither income or expenses, they correspondingly do + neither income or expenses, they correspondingly do not appear on a P&L statement.
-Even though these accounts may be somewhat "special", you - do not need to do anything particularly special to use income - and expense accounts. GnuCash handles the values automatically, - so that if you record properly the effects of the transactions - on your bank account or credit card, the income/expense side of +
Even though these accounts may be somewhat "special", you do + not need to do anything particularly special to use income and + expense accounts. GnuCash handles the values automatically, so + that if you record properly the effects of the transactions on + your bank account or credit card, the income/expense side of the transaction should also be handled correctly.
-The time when things get "peculiar," and when you need to +
The time when things get "peculiar," and when you need to more deeply understand this, is when amounts are transferred - between income/expense accounts. (The causes for such + between income/expense accounts. (The causes for such transfers tend to be somewhat peculiar, so it's pretty fair for this to be a pretty odd situation.)
Using Income/Expense Accounts
-To use an income/expense account, simply create one from - the "New Account" dialogue window, and then be sure to transfer +
To use an income/expense account, simply create one from the + "New Account" dialogue window, and then be sure to transfer income/expenses to it as you record paychecks, interest, etc.
-You will doubtless wish to create quite a number of income - and expense accounts; it may be worth looking at the Sample Chart of Accounts - for ideas.
+You will doubtless wish to create quite a number of income + and expense accounts; it may be worth looking at the Sample Chart of Accounts for + ideas.
-This partitioning of incomes and expenses is likely to - prove particularly useful for North Americans when income - tax time rolls around.
+This partitioning of incomes and expenses is likely to prove + particularly useful for North Americans when income tax + time rolls around.
-Use of Terminology In Other Software
+Use of Terminology In Other Software
-If you have used other personal finance software, be aware - that Quicken calls - them "Categories."
+If you have used other personal finance software, be aware + that Quicken calls them + "Categories."
-
Return to Main Documentation
+ Return to Main Documentation
Page.Overview
The Find Transactions dialog allows you to search for -transactions which match criteria that you specify, including -account(s) affected by the transaction, the value of the transaction, -the date, the memo, the description, etc. You can bring up the Find -Transactions dialog by clicking on the "Find" button in the main -GnuCash window or any register display window. The results of your -search will be shown in a register display similar to the ones used to -display your accounts, with the window title "Search Results". +transactions which match criteria that you specify, including: +
-
+
- Account(s) affected by the transaction, +
- Value of the transaction, +
- Date +
- Memo field +
- Transaction description
+
-
+etc.
+
+
- The upper
part of the dialog is a Notebook with tabs that allow you to specify
-the conditions of your search. See Setting up a
-search for details on each search type. The lower part of the
+the conditions of your search.
See Setting up a +search for details on each search type. + +
- The lower part of the dialog is a selector which allows you to specify how the results of the search are to be combined with any previous search. +
- By default, the match used is a +case-insensitive substring match.
- If you select the "Case sensitive" +toggle button, the search is a case-sensitive substring match.
- If the "Regular expression" button is selected, the match interprets the string you enter as a POSIX extended regular expression; case -sensitivity is still determined by the "Case sensitive" button. +sensitivity is still determined by the "Case sensitive" button.
- Account Fields: sets which fields are displayed in - the account list of the main window. -
- Account Types: sets which account types are displayed - in the main window. + +
- Account Fields: sets which fields are displayed in + the account list of the main window. + +
- Account Types: sets which account types are + displayed in the main window. +
- General: anything that doesn't fit anywhere - else. -
- International: Options relating to date and time - display formats. -
- Register: Options relating to the default appearance - of account registers. + else.
You may bring up the Find Transactions dialog by clicking +on the "Find" button in the main GnuCash window or any register +display window. + +
The results of your search will be shown in a register display +similar to the ones used to display your accounts, with the window +title "Search Results".
Clicking the "Find" button again within a Search Results register window allows you to add additional terms to the query whose -results are displayed in that window. By combining multiple searches, -you can create very sophisticated queries to show you exactly the +results are displayed in that window.
By combining multiple searches, +you may construct rather sophisticated queries to display exactly the subset of your transactions that you want to see. Table of Contents
How to use the Find Transactions dialog
-The Find Transactions dialog has two main parts. The upper +
The Find Transactions dialog has two main parts. + +
-
+
If you get the Find Transactions dialog by clicking the Find button in the main GnuCash window or any normal account display @@ -107,9 +123,9 @@ accounts is to be displayed.
If you select "All" accounts from the picker at the top of the tab, the only transactions that will be show are those which affect -all the selected accounts. For example, if you select "My Checking -Account" and "My VISA Account" and then choose "All", only transfers -from Checking to Visa will be shown. +all the selected accounts.
For example, if you select My +Checking Account and My VISA Account and then choose +All, only transfers from Checking to Visa will be shown.
If you select "Any" from the picker, transactions affecting any selected amount will be shown. For example, if you select "My @@ -121,15 +137,15 @@ together in the Search Results window.
In the Date tab, you can specify a date range for the transactions you wish to find. The year, month, and day fields are in -the order you specify in Preferences:International:Date Format. +the order you specify in Preferences:International:Date Format.
If you want to locate any transaction before a certain date, -specify your date in the second date entry and put a very early date -in the first date entry. The default date is January 1, 1900, which -should be early enough for most purposes. Similarly, if you want to -find any transaction after a certain date, put the date in the first -date entry and put a date after your last transaction in the second -entry. +specify your date in the second date entry and put a distant date in +the past in the first date entry. The default date is January 1, +1900, which should be distant enough for most peoples' purposes.
+Similarly, if you want to find any transaction after a certain date, +put the date in the first date entry and put a date after your last +transaction in the second entry.
Amount searches
@@ -146,12 +162,12 @@ interested in debits, credits, or both.In the Description, Number, Memo, and Action tabs, you can specify a string which is matched against the respective fields of -splits and transactions. By default, the match used is a -case-insensitive substring match. If you select the "Case sensitive" -toggle button, the search is a case-sensitive substring match. If the +splits and transactions.
Preferences -Preferences
-You can customize the behavior of - GnuCash by changing the settings in this dialog box.All settings - are automatically saved so changes are preserved for future - sessions.
+Preferences
+ +You can customize the behavior of GnuCash by changing the + settings in this dialog box.All settings are automatically + saved so changes are preserved for future sessions.
To change settings, simply click to select the appropriate - page, then make appropriate changes, and click the "Apply" - button to see - your changes take effect. Clicking "OK" applies changes, then - closes the properties dialog box. - them. The "Close" button simply closes the dialog box without - applying the latest changes.
+ page, then make appropriate changes, and click the "Apply" + button to see your changes take effect. Clicking "OK" applies + changes, then closes the properties dialog box. them. The + "Close" button simply closes the dialog box without applying + the latest changes.The settings are grouped into the following categories:
--
+
+
+ - The upper
part of the dialog is a Notebook with tabs that allow you to specify
-the conditions of your search. See Setting up a
-search for details on each search type. The lower part of the
+the conditions of your search.
- International: Options relating to date and time + display formats. + +
- Register: Options relating to the default + appearance of account registers.
- -
Return to Main Documentation
+ Return to Main Documentation
Page. You can customize the behavior of
- GnuCash by changing the settings in this dialog box.All settings
- are automatically saved so changes are preserved for future
- sessions. You can customize the behavior of GnuCash by changing the
+ settings in this dialog box.All settings are automatically
+ saved so changes are preserved for future sessions. To change settings, simply click to select the appropriate
- page, then make appropriate changes, and click the "Apply"
- button to see
- your changes take effect. Clicking "OK" applies changes, then
- closes the properties dialog box.
- them. The "Close" button simply closes the dialog box without
- applying the latest changes.Preferences
- Preferences
+
+
The settings are grouped into the following categories:
-- Account Fields: sets which fields are displayed in - the account list of the main window. -
- Account Types: sets which account types are displayed - in the main window. + +
- Account Fields: sets which fields are displayed in + the account list of the main window. + +
- Account Types: sets which account types are + displayed in the main window. +
- General: anything that doesn't fit anywhere - else. -
- International: Options relating to date and time - display formats. -
- Register: Options relating to the default appearance - of account registers. + else. + +
- International: Options relating to date and time + display formats. + +
- Register: Options relating to the default + appearance of account registers.
-
- Overall Assets: 100
+ Overall Assets: 100
-
- Overall Cash: 110
+ Overall Cash: 110
-
-
- Cash in Wallet: 111 +
- Cash in Wallet: 111 -
- Cash in Sock in Closet: 112 +
- Cash in Sock in Closet: 112 -
- Cash in Mattress: 113 +
- Cash in Mattress: 113 -
- Petty Cash Box: 114 +
- Petty Cash Box: 114
-
- Overall Banking Assets 120
+ Overall Banking Assets 120
-
-
- Checking Account 121 +
- Checking Account 121 -
- Savings Account 122 +
- Savings Account 122
When you create a new +
When you create a new account, GnuCash offers a guess at what an appropriate account code might be; you are free to change this. GnuCash does not prevent duplicate numbering, although we would @@ -89,7 +90,7 @@
A Sample Chart of Accounts
-A "typical" chart of accounts is shown below. Each +
A "typical" chart of accounts is shown below. Each account is of a given account type. This example is a combination of some typical business and personal accounts.
@@ -369,7 +370,7 @@ -
- Overall Cash: 110
+ Overall Cash: 110
- Date Input -
- Depreciation and Capital
+
- Depreciation and Capital Gains
- Foreign Currency @@ -61,22 +62,26 @@
- Using Income/Expense Accounts
-- Customizing Gnucash's Appearance
-- Changing Account Properties
+ +- Customizing Gnucash's + Appearance
+ +- Changing Account + Properties
- GnuCash Project Goals +
- GnuCash Project Goals
- Printing and Web Serving @@ -84,7 +89,7 @@
-
Reports
-
The reporting subsystem is presently undergoing active +
The reporting subsystem is presently undergoing active development; documentation should eventually include:
-
diff --git a/doc/html/C/xacc-mainwin.html b/doc/html/C/xacc-mainwin.html
index 682ef8b06f..63c48c1441 100644
--- a/doc/html/C/xacc-mainwin.html
+++ b/doc/html/C/xacc-mainwin.html
@@ -2,7 +2,8 @@
-
+
- From an open register window, select Print ... To - WWW from the File menu. + WWW from the File menu.
Main Window @@ -11,20 +12,20 @@Main GnuCash Window
-This is the main account window. You control your set of +
This is the main account window. You control your set of accounts from here.
-Below is a picture of the main window, with only the main - accounts shown. Note how Business Expenses has been selected by - highlighting. The box with a cross in it, - immediately to its left, shows that it has one - or more detail accounts that are not shown at present. - To show them, click on this box.
+Below is a picture of the main window, with only the main + accounts shown. Note how Business Expenses has been + selected by highlighting. The box with a cross in it, + immediately to its left, shows that it has one or more detail + accounts that are not shown at present. To show them, click on + this box.
-
+
-
Here is the main window, with the detail accounts +
Here is the main window, with the detail accounts showing.
@@ -32,7 +33,7 @@
-The Open Subaccounts menu item is interesting only +
The Open Subaccounts menu item is interesting only if you choose an account with sub-accounts (detail accounts). Accounts with sub-accounts will always have a box on thier left. By choosing the Open Subaccounts menu item, a @@ -44,7 +45,7 @@ smaller space. Because of its increased complexity, it use is recommended only for accounting experts.
-Return to Main Documentation +
Return to Main Documentation Page.
diff --git a/doc/html/C/xacc-pnl.html b/doc/html/C/xacc-pnl.html index 1f41177748..956b93787b 100644 --- a/doc/html/C/xacc-pnl.html +++ b/doc/html/C/xacc-pnl.html @@ -1,20 +1,25 @@ + - +Profit And Loss Statement - -Profit and Loss Statement
-This report summarizes your sources of income and expenditure.
- -There are currently no options for this report, but the option - to specify an accounting period will be added soon.
- -Return to Main Documentation - Page.
+ +Profit and Loss Statement
+ +This report summarizes your sources of income and + expenditure.
+ +There are currently no options for this report, but the + option to specify an accounting period will be added soon.
+ +Return to Main Documentation + Page.
+ diff --git a/doc/html/C/xacc-print-check.html b/doc/html/C/xacc-print-check.html index 7c148ece69..c18d3d3e35 100644 --- a/doc/html/C/xacc-print-check.html +++ b/doc/html/C/xacc-print-check.html @@ -2,7 +2,8 @@ - +Printing Checks @@ -11,87 +12,91 @@Printing Checks
-You may print a GnuCash transaction as a check by selecting +
You may print a GnuCash transaction as a check by selecting "Print Check" from the Transaction menu in a register display - window. + window.
-In the Print Check dialog, select the style of check form that - you wish to use, the position of the check on the page, and the - format for printing the date on the check. Clicking OK - will take you to the GnuCash Printing - dialog, which will allow you to preview the check, select a - printer and paper size, and start the print job. +
In the Print Check dialog, select the style of check form + that you wish to use, the position of the check on the page, + and the format for printing the date on the check. Clicking + OK will take you to the + GnuCash Printing dialog, which will allow you to preview + the check, select a printer and paper size, and start the print + job.
Check format
-In order to print a check, it is necessary to know where the - pre-printed lines and boxes are on the check form. There are two - widely-used standard check formats: Quicken/QuickBooks (tm) - compatible, and Microsoft Money (tm) compatible. +
In order to print a check, it is necessary to know where the + pre-printed lines and boxes are on the check form. There are + two widely-used standard check formats: Quicken/QuickBooks (tm) + compatible, and Microsoft Money (tm) compatible.
-By default, the check format is Quicken/QuickBooks, - which prints to any Quicken-compatible check forms. +
By default, the check format is Quicken/QuickBooks, + which prints to any Quicken-compatible check forms.
Custom Check Format
-If you wish to print to a type of check form that is not in - the Check Format option menu, select Custom in - the format menu and enter the positions of the various check - fields in the entry boxes below. +
If you wish to print to a type of check form that is not in + the Check Format option menu, select Custom + in the format menu and enter the positions of the various check + fields in the entry boxes below.
-Positions in the Custom Check Format entry area are specified - with x = 0 at the left edge of the check with x increasing to the - right, and y = 0 at the bottom edge of the check with y increasing - as you travel up. Numbers may be entered as integer or floating - point values. The length units specified in the Units - option menu are used to interpret all values entered in the custom - check format area. +
Positions in the Custom Check Format entry area are + specified with x = 0 at the left edge of the check with x + increasing to the right, and y = 0 at the bottom edge of the + check with y increasing as you travel up. Numbers may be + entered as integer or floating point values. The length units + specified in the Units option menu are used to + interpret all values entered in the custom check format + area.
-If you arrive at a working set of Custom Check Format +
If you arrive at a working set of Custom Check Format parameters for a commercially-available printable check form, - please submit them to gnucash-devel@gnucash.org so we can - include them as standard in a future release. + please submit them to gnucash-devel@gnucash.org so we + can include them as standard in a future release.
Check position
-Printable check forms are available in several styles. In - general, each printable sheet is divided into three sections, and - each section can be either a check or a stub. The Check Position - option menu allows you to select which section of the page - contains the check you wish to print to. Top, - Middle, and Bottom should be defined correctly - for check forms using the paper size that you select in the - printing dialog. +
Printable check forms are available in several styles. In + general, each printable sheet is divided into three sections, + and each section can be either a check or a stub. The Check + Position option menu allows you to select which section of the + page contains the check you wish to print to. Top, + Middle, and Bottom should be defined + correctly for check forms using the paper size that you select + in the printing dialog.
Custom check position
-If the preset check positions do not work correctly for your +
If the preset check positions do not work correctly for your check forms, you may choose Custom from the Check Position option menu and enter a position for the check in the - Check Position entry. Enter the distance along the left - edge of the paper from the lower left-hand corner of the page to - the lower left-hand corner of the check. The units of this - measurement are those selected in the "Units" option menu. + Check Position entry. Enter the distance along the + left edge of the paper from the lower left-hand corner of the + page to the lower left-hand corner of the check. The units of + this measurement are those selected in the "Units" option + menu.
Date format
- -Select your preferred date format from the picker. The picker - shows a sample date of "December 31, 2000" for all formats, but - your date will be substituted when printing. -
The "MM/DD/YY" and "DD/MM/YY" formats are available, but they - are strongly discouraged since they cannot always be - distinguished from each other. Please use a format with a full - or abbreviated month name instead of a number. - +
Select your preferred date format from the picker. The + picker shows examples using the date of December 31, + 2000 for all formats, but your date will be substituted + when printing.
+ +The MM/DD/YY and DD/MM/YY formats are + available, but they are strongly discouraged since they cannot + always be distinguished from each other. Please use a format + with a full or abbreviated month name instead of a number.
+Custom date format
- -If you wish to use another date format besides those available - in the picker, select Custom and enter a - date-formatting string in the Date Format entry in the - custom settings area. If custom date format is selected, this - string is passed to strftime(3) as a format specifier. +
If you wish to use another date format besides those + available in the picker, select Custom and enter a + date-formatting string in the Date Format entry in the + custom settings area. If custom date format is selected, this + string is passed to strftime(3) as a format + specifier.
diff --git a/doc/html/C/xacc-print.html b/doc/html/C/xacc-print.html index 4e85d84e49..67d891d01d 100644 --- a/doc/html/C/xacc-print.html +++ b/doc/html/C/xacc-print.html @@ -2,7 +2,8 @@ - +Printing and Web Serving @@ -11,33 +12,33 @@Printing
-At present, the only type of printing directly supported by - GnuCash is check printing. - Other types of printing are expected to be supported soon. +
At present, the only type of printing directly supported by + GnuCash is check printing. + Other types of printing are expected to be supported soon.
-You may create a printout of the register - window contents by opening a register window and selecting - Print... To File from the File menu. - Reports can also be - exported as HTML. +
You may create a printout of the register window contents by + opening a register window and selecting Print... To + File from the File menu. Reports can also be exported as HTML.
-GnuCash as Web Server
+GnuCash as Web Server
-Following the latest fashionable trends of Internet +
Following the latest fashionable trends of Internet Hype, GnuCash can also act as a cheesy web server!
- - Then aim your browser at http://localhost:1080/ - or http://yourmachinename.com:1080/and you will see +
- Then aim your browser at http://localhost:1080/
+ or http://yourmachinename.com:1080/and you will see
your register window.
- - But, remember, we said cheesy; in order to view
- the page a second time, you have to pick the menu item
+
- But, remember, we said cheesy; in order to view + the page a second time, you have to pick the menu item again to "reload" things and allow prepare it for another data dump.
@@ -45,7 +46,7 @@ - But, remember, we said cheesy; in order to view + the page a second time, you have to pick the menu item again to "reload" things and allow prepare it for another data dump.
- QIF files omit small things that may be fairly accurately inferred by
+examining the data.
+
+
For instance, are numbers in decimal-radix [1,000.00 == +1000] form or European comma-radix form [1.000,00 == 1000]? +
Or are +dates m/d/y or y/m/d? + +
More problematic are major things where there is little way of +guessing. + + For instance, determining the currency the file is denominated in. + +
Or what account the file describes. + +
GnuCash's QIF importer does a remarkably good job of guessing what +it can, but you do have to keep an eye on it. Fortunately, +the system is designed so that you can correct problems before + you changes are dropped into your GnuCash accounts. Nothing is +done to your GnuCash accounts until you click the final "OK" button.
In the next section, I'll give an overview of the QIF file and -its "features". This may seem unnecessarily technical, but if you -will at least glance through it you will be much better able to -understand what's going on if you are having to jump through hoops to -make things work right, and how you might be able to jump right in and -edit the QIF file to fix really tough problems. +its "features". This may seem unnecessarily technical, but if you at +least glance through it you will be much better able to understand +what's going on if you are having to jump through hoops to make make a +problematic file work right, and how you might be able to jump right +in and edit the QIF file to fix really tough problems.
There are two major "paths" for using the GnuCash QIF importer. -One is the "I am a Quicken user just migrating to GnuCash" path; the -other is the "I am downloading some updates from my bank as a QIF -file" path. This document mainly focuses on the former case, since -new users are likely to need the most help and you can't get started -using GnuCash until you can get your old records in. +
-
+
+
- One is the "I am a Quicken user just migrating to GnuCash" path. + +
- The other is the "I am downloading some updates from my bank as a +QIF file" path. + +
This document mainly focuses on the former case, since new users +are likely to need the most help and you really can't get started +using GnuCash until you can get your old records in. Fortunately, +once you learn to do the former, the latter should be a piece of cake.
Table of Contents @@ -87,18 +109,19 @@ using GnuCash until you can get your old records in.
QIF files are plain text files formatted as "tag-value" pairs. At the beginning of each line there is a single character "tag" followed immediately by the "value", which extends to the end of the -line. Don't be afraid to pop up a QIF file in "less" or the text -editor of your choice if you are having problems getting some Quicken -data imported correctly; chances are a simple search-and-replace will -fix just about any problem you might have with a QIF file. And a -regexp search-and-replace will get the rest. +line. +
Don't be afraid to pop up a QIF file using less +or the text editor of your choice if you are having problems getting +some Quicken data imported correctly; chances are a simple +search-and-replace can fix just about any problem you might have with +a QIF file. And a regexp search-and-replace will get the rest.
Collections of tag-value pairs form records of various types. There are records to store the names and descriptions of your accounts and of expense and income categories that you have defined in Quicken. There are records to define Quicken "classes" (sort of like sub-accounts, sort of like categories, but not exactly like either). -And there are records to describe transactions. +And there are records to describe transactions.
Here's a typical Quicken transaction record:
@@ -170,11 +193,12 @@ of all the $ fields in a transaction record should equal the T field.Note that nowhere in the transaction record, nor anywhere else in the file, does Quicken store the name of the account that the -file describes. Don't ask me, I don't know why either. Microsoft -Money (which also can save QIF files) started doing a "trick" to get -the information in the file. If the very first Bank transaction in -the file has a payee of "Opening Balance", the L line contains the -name of the account that the file describes: +file describes. Don't ask me why not, I don't know either. Microsoft +Money (which also can save QIF files) uses a "trick" to get the +information in the file. If the very first Bank transaction in the +file has a payee of "Opening Balance", the L line contains the name of +the account that the file describes: +
!Type:Bank D12/03/95 @@ -184,36 +208,38 @@ name of the account that the file describes: L[New Bank] ^-Opening Balance records are handled specially, since they don't -mean what they appear to mean (if you interpret the record literally, -as a transfer of $4706.57 from [New Bank] to [New Bank], your new -balance is a whopping $0.00). In the -Accounts Tab section there's a discussion + +
Opening Balance records are handled specially, since they don't +mean what the data appear to indicate (if you interpret the record +literally, as a transfer of $4706.57 from [New Bank] to [New Bank], +your new balance is a whopping $0.00). In the Accounts Tab section there's a discussion of what we do with them.
Multi-account Quicken exports
-Quicken and some other programs who use QIF as an export format +
Quicken and some other programs who use QIF as an export format know how to put the history of multiple accounts into a single QIF -file. They do this by prepending an "!Account" record before the -set of transactions to/from that account. +file. They do this by prepending an "!Account" record before the set +of transactions to/from that account. -
The QIF Importer should be able to handle these files fine. -You may notice that the "Default QIF Account" seems somewhat -arbitrary; for multiple-account exports, the guessed account is the -first one with an Opening Balance record. However, since Quicken -explicitly lists the account for every transaction in multi-account -exports, you aren't likely to get any transactions in the default -account other than those that are supposed to be there. +
The QIF Importer should be able to handle these files fine. You +may notice that the "Default QIF Account" seems somewhat arbitrary; +for multiple-account exports, the guessed account is the first one +with an Opening Balance record. However, since Quicken explicitly +lists the account for every transaction in multi-account exports, you +aren't likely to get any transactions in the default account other +than those that are supposed to be there.
Table of Contents
How to use the QIF Import dialog
-The "Quick Start" guide: To load your files, click the "Select -..." button in the Files tab to find the file, then click the "Load -File" button at the bottom of the Files tab to actually load it. -Repeat this until all your files are loaded (read the explanation +
The "Quick Start" guide: To load your files, click the "Select ..." +button in the Files tab to find the file, then click the "Load File" +button at the bottom of the Files tab to actually load it. + +
Repeat this until all your files are loaded (read the explanation below to see why you should load all your files at the same time). Check the Accounts and Categories dialogs and make corrections if necessary. Then click the big OK button. @@ -230,7 +256,7 @@ will show up in multiple accounts. This means that if you aren't smart about catching duplicate transactions you will end up with wrong balances in GnuCash. Definitely a bad thing. -
In order to get the best possible replication of your Quicken +
In order to get the best possible replication of your Quicken account tree, export everything you can from Quicken and then import it all in one session, either as a single QIF file representing all your accounts together or as a single file for each account. The @@ -240,7 +266,7 @@ currency, Quicken account name, and so on are right for each one. The importer can do a really good job of catching cross-references (which and marking them. -
The importer is written mostly in Guile, and it can be a little +
The importer is written mostly in Guile, and it can be a little slow on large QIF files. Load File takes 5-6 seconds for a QIF file with 1000 or so transactions on my machine. @@ -250,7 +276,7 @@ href="#dialog-categories">Categories tab
-
Start Quicken.
-
It works on Wine, +
It works on Wine, Caldera's Wabi, and doubtless on VMWare, so this may not forcibly require that you run Windows.
@@ -63,10 +64,10 @@
-
Select the account that you wish to export.
-
Quicken can only export one account to each data file, +
Quicken can only export one account to each data file, which means that if you have many accounts, this may prove to be a somewhat tedious process. (On the other hand, it - should be a whole lot less tedious than entering + should be a whole lot less tedious than entering the data from scratch.)
@@ -74,24 +75,24 @@
Choose the menu File and select the
Export... menu entry.
-
-
+
- -
Return to Main Documentation
+ Return to Main Documentation
Page. Everyone is permitted to copy and distribute verbatim
+ Everyone is permitted to copy and distribute verbatim
copies of this license document, but changing it is not
allowed. The licenses for most software are designed to take away
+ The licenses for most software are designed to take away
your freedom to share and change it. By contrast, the GNU
General Public License is intended to guarantee your freedom to
share and change free software--to make sure the software is
@@ -35,53 +36,53 @@
General Public License instead.) You can apply it to your
programs, too. When we speak of free software, we are referring to
- freedom, not price. Our General Public Licenses are designed to
- make sure that you have the freedom to distribute copies of
- free software (and charge for this service if you wish), that
- you receive source code or can get it if you want it, that you
- can change the software or use pieces of it in new free
- programs; and that you know you can do these things. When we speak of free software, we are referring to freedom,
+ not price. Our General Public Licenses are designed to make
+ sure that you have the freedom to distribute copies of free
+ software (and charge for this service if you wish), that you
+ receive source code or can get it if you want it, that you can
+ change the software or use pieces of it in new free programs;
+ and that you know you can do these things. To protect your rights, we need to make restrictions that
+ To protect your rights, we need to make restrictions that
forbid anyone to deny you these rights or to ask you to
surrender the rights. These restrictions translate to certain
responsibilities for you if you distribute copies of the
software, or if you modify it. For example, if you distribute copies of such a program,
+ For example, if you distribute copies of such a program,
whether gratis or for a fee, you must give the recipients all
the rights that you have. You must make sure that they, too,
receive or can get the source code. And you must show them
these terms so they know their rights. We protect your rights with two steps: (1) copyright the
+ We protect your rights with two steps: (1) copyright the
software, and (2) offer you this license which gives you legal
permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to
- make certain that everyone understands that there is no
- warranty for this free software. If the software is modified by
- someone else and passed on, we want its recipients to know that
- what they have is not the original, so that any problems
- introduced by others will not reflect on the original authors'
+ Also, for each author's protection and ours, we want to make
+ certain that everyone understands that there is no warranty for
+ this free software. If the software is modified by someone else
+ and passed on, we want its recipients to know that what they
+ have is not the original, so that any problems introduced by
+ others will not reflect on the original authors'
reputations. Finally, any free program is threatened constantly by
+ Finally, any free program is threatened constantly by
software patents. We wish to avoid the danger that
redistributors of a free program will individually obtain
patent licenses, in effect making the program proprietary. To
prevent this, we have made it clear that any patent must be
licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution
+ The precise terms and conditions for copying, distribution
and modification follow. 0. This License applies to any program or other work which
+ 0. This License applies to any program or other work which
contains a notice placed by the copyright holder saying it may
be distributed under the terms of this General Public License.
The "Program", below, refers to any such program or work, and a
@@ -92,15 +93,15 @@
(Hereinafter, translation is included without limitation in the
term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and
- modification are not covered by this License; they are outside
- its scope. The act of running the Program is not restricted,
- and the output from the Program is covered only if its contents
+ Activities other than copying, distribution and modification
+ are not covered by this License; they are outside its scope.
+ The act of running the Program is not restricted, and the
+ output from the Program is covered only if its contents
constitute a work based on the Program (independent of having
been made by running the Program). Whether that is true depends
on what the Program does. 1. You may copy and distribute verbatim copies of the
+ 1. You may copy and distribute verbatim copies of the
Program's source code as you receive it, in any medium,
provided that you conspicuously and appropriately publish on
each copy an appropriate copyright notice and disclaimer of
@@ -109,11 +110,11 @@
recipients of the Program a copy of this License along with the
Program. You may charge a fee for the physical act of transferring a
+ You may charge a fee for the physical act of transferring a
copy, and you may at your option offer warranty protection in
exchange for a fee. 2. You may modify your copy or copies of the Program or any
+ 2. You may modify your copy or copies of the Program or any
portion of it, thus forming a work based on the Program, and
copy and distribute such modifications or work under the terms
of Section 1 above, provided that you also meet all of these
@@ -124,13 +125,13 @@
notices stating that you changed the files and the date of
any change.
- b) You must cause any work that you distribute or
- publish, that in whole or in part contains or is derived from
- the Program or any part thereof, to be licensed as a whole at
- no charge to all third parties under the terms of this
+ b) You must cause any work that you distribute or publish,
+ that in whole or in part contains or is derived from the
+ Program or any part thereof, to be licensed as a whole at no
+ charge to all third parties under the terms of this
License. c) If the modified program normally reads commands
+ c) If the modified program normally reads commands
interactively when run, you must cause it, when started
running for such interactive use in the most ordinary way, to
print or display an announcement including an appropriate
@@ -155,17 +156,17 @@
whole, and thus to each and every part regardless of who wrote
it.
- Thus, it is not the intent of this section to claim rights
+ Thus, it is not the intent of this section to claim rights
or contest your rights to work written entirely by you; rather,
the intent is to exercise the right to control the distribution
of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on
+ In addition, mere aggregation of another work not based on
the Program with the Program (or with a work based on the
Program) on a volume of a storage or distribution medium does
not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based
+ 3. You may copy and distribute the Program (or a work based
on it, under Section 2) in object code or executable form under
the terms of Sections 1 and 2 above provided that you also do
one of the following: b) Accompany it with a written offer, valid for at least
+ b) Accompany it with a written offer, valid for at least
three years, to give any third party, for a charge no more
than your cost of physically performing source distribution,
a complete machine-readable copy of the corresponding source
@@ -184,7 +185,7 @@
above on a medium customarily used for software interchange;
or, c) Accompany it with the information you received as to
+ c) Accompany it with the information you received as to
the offer to distribute corresponding source code. (This
alternative is allowed only for noncommercial distribution
and only if you received the program in object code or
@@ -192,7 +193,7 @@
b above.) The source code for a work means the preferred form of the
+ The source code for a work means the preferred form of the
work for making modifications to it. For an executable work,
complete source code means all the source code for all modules
it contains, plus any associated interface definition files,
@@ -204,7 +205,7 @@
system on which the executable runs, unless that component
itself accompanies the executable. If distribution of executable or object code is made by
+ If distribution of executable or object code is made by
offering access to copy from a designated place, then offering
equivalent access to copy the source code from the same place
counts as distribution of the source code, even though third
@@ -220,7 +221,7 @@
licenses terminated so long as such parties remain in full
compliance.
- 5. You are not required to accept this License, since you
+ 5. You are not required to accept this License, since you
have not signed it. However, nothing else grants you permission
to modify or distribute the Program or its derivative works.
These actions are prohibited by law if you do not accept this
@@ -230,16 +231,16 @@
conditions for copying, distributing or modifying the Program
or works based on it. 6. Each time you redistribute the Program (or any work
- based on the Program), the recipient automatically receives a
- license from the original licensor to copy, distribute or
- modify the Program subject to these terms and conditions. You
- may not impose any further restrictions on the recipients'
- exercise of the rights granted herein. You are not responsible
- for enforcing compliance by third parties to this License. 6. Each time you redistribute the Program (or any work based
+ on the Program), the recipient automatically receives a license
+ from the original licensor to copy, distribute or modify the
+ Program subject to these terms and conditions. You may not
+ impose any further restrictions on the recipients' exercise of
+ the rights granted herein. You are not responsible for
+ enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation
- of patent infringement or for any other reason (not limited to
+ 7. If, as a consequence of a court judgment or allegation of
+ patent infringement or for any other reason (not limited to
patent issues), conditions are imposed on you (whether by court
order, agreement or otherwise) that contradict the conditions
of this License, they do not excuse you from the conditions of
@@ -253,12 +254,12 @@
License would be to refrain entirely from distribution of the
Program. If any portion of this section is held invalid or
+ If any portion of this section is held invalid or
unenforceable under any particular circumstance, the balance of
the section is intended to apply and the section as a whole is
intended to apply in other circumstances. It is not the purpose of this section to induce you to
+ It is not the purpose of this section to induce you to
infringe any patents or other property right claims or to
contest validity of any such claims; this section has the sole
purpose of protecting the integrity of the free software
@@ -273,7 +274,7 @@
This section is intended to make thoroughly clear what is
believed to be a consequence of the rest of this License.
- 8. If the distribution and/or use of the Program is
+ 8. If the distribution and/or use of the Program is
restricted in certain countries either by patents or by
copyrighted interfaces, the original copyright holder who
places the Program under this License may add an explicit
@@ -282,13 +283,13 @@
not thus excluded. In such case, this License incorporates the
limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or
+ 9. The Free Software Foundation may publish revised and/or
new versions of the General Public License from time to time.
Such new versions will be similar in spirit to the present
version, but may differ in detail to address new problems or
concerns. Each version is given a distinguishing version number. If
+ Each version is given a distinguishing version number. If
the Program specifies a version number of this License which
applies to it and "any later version", you have the option of
following the terms and conditions either of that version or of
@@ -297,7 +298,7 @@
you may choose any version ever published by the Free Software
Foundation. 10. If you wish to incorporate parts of the Program into
+ 10. If you wish to incorporate parts of the Program into
other free programs whose distribution conditions are
different, write to the author to ask for permission. For
software which is copyrighted by the Free Software Foundation,
@@ -309,8 +310,8 @@
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE
- IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+ 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS
+ NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE
COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS
IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
@@ -320,7 +321,7 @@
WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE
COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED
+ 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED
TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO
MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE,
BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
@@ -334,7 +335,7 @@
Return to Main Documentation
+ Return to Main Documentation
Page. Typically accounts are arranged as a tree, in hierarchical
+ Typically accounts are arranged as a tree, in hierarchical
form. The main branches represent entire categories or groups,
+ The main branches represent entire categories or groups,
while the leaves of the tree denote individual bank accounts or
expense categories. When a summary report is requested, typically only the main
+ When a summary report is requested, typically only the main
branches are shown in the report, rather than the individual
accounts. For example, a chart of accounts might look like the
following: Note that accounts not only have names; they have
- codes, in order to provide order. When a report
- is generated, the sort order is determined
- by the numbering. Note that accounts not only have names; they have
+ codes, in order to provide order. When a report is
+ generated, the sort order is determined by
+ the numbering. A sensible hierarchy generally will have the "leaf"
- accounts end in non-zero digits, whilst parent nodes have
- increasing numbers of zeros. For instance, "cash" accounts
- might logically be arranged thus: A sensible hierarchy generally will have the "leaf" accounts
+ end in non-zero digits, whilst parent nodes have increasing
+ numbers of zeros. For instance, "cash" accounts might logically
+ be arranged thus: Return to Main Documentation
+ Return to Main Documentation
Page. The following documentation is about the
- implementation of GnuCash as opposed to being user
- documentation on how to use it. The following documentation is about the
+ implementation of GnuCash as opposed to being user
+ documentation on how to use it. Some of it represents preliminary documentation for
+ Some of it represents preliminary documentation for
subsystems that are not yet sufficiently functional for use by
end users. Return to Main Documentation
+ Return to Main Documentation
Page. The problem is that GnuCash is a real double-entry accounting
system and Quicken has a pretty simplistic view about what an account
-is, what a transaction is, and what to save in data files. In short,
-QIF files just don't contain enough information to completely and
-accurately reconstruct your Quicken account hierarchy in the GnuCash
-double entry system without some guessing by the import code and some
-hand-holding by you. QIF files omit small things that can be easily
-guessed (for instance, are numbers in decimal-radix [1,000.00 == 1000]
-form or European comma-radix form [1.000,00 == 1000]? Are dates m/d/y
-or y/m/d?) and big things that can't be easily guessed, like, for
-example, what currency the file is denominated in, or what account the
-file describes.
+is, what a transaction is, and, most critically, is severely flawed in its datamodel, that is, what it saves in
+data files.
- For the most part, GnuCash's QIF importer does a good job of
-figuring this stuff out, but you do have to keep an eye on it. The
-system is designed so that you can correct problems BEFORE you make
-changes to your GnuCash accounts; nothing is done to your GnuCash
-accounts until you click the final "OK" button.
+ Briefly, QIF files just don't contain enough information to
+completely and accurately reconstruct your Quicken account hierarchy
+in the GnuCash double entry system without some educated guessing by
+the import code as well as some guidance, provided by you.
+ Brokerage accounts are really confusing to me. Basically, my
+ Brokerage accounts are really confusing to me. Basically, my
thinking is that the brokerage account itself should probably be a
Bank account. The only weirdness is in stuff like dividends paid from
securities to the brokerage account. If you're using a Dividend
diff --git a/doc/html/C/xacc-quicken.html b/doc/html/C/xacc-quicken.html
index 2c3cac9c34..f767d2246c 100644
--- a/doc/html/C/xacc-quicken.html
+++ b/doc/html/C/xacc-quicken.html
@@ -2,7 +2,8 @@
Not all accounting systems use the same words to describe
+ Not all accounting systems use the same words to describe
the same concepts. The following are some notes that may be
helpful to users accustomed to Intuit's products. What Quicken calls Categories are really just What Quicken calls Categories are really just Income/Expense accounts. Thus, if
you are used to specifying a category in Quicken, just create
an income/expense account of the same name in GnuCash, and use
@@ -29,33 +30,33 @@
Import Files (QIF). (Note: Only Quicken Version 3.0 QIF has
been formally tested so far.)
- Note that the QIF format is representative of a somewhat
+ Note that the QIF format is representative of a somewhat
peculiar data model that is not as expressive as one might
wish; it requires dumping out a separate data file for each
account, rather than permitting you to have one file that
- represents all of the accounts you might have had in
+ represents all of the accounts you might have had in
Quicken. Furthermore, while there are plans to do so in the future,
+ Furthermore, while there are plans to do so in the future,
there is not, at this point, a way of mapping the account or
- category names used in Quicken to a different set of
+ category names used in Quicken to a different set of
account names that you might be using in GnuCash. As a result, please read this section carefully. You may be
+ As a result, please read this section carefully. You may be
somewhat disappointed with the results of a QIF import; this
will at least give you some more accurate expectations as to
what will happen. To create a set of Quicken QIF files, perform the
+ To create a set of Quicken QIF files, perform the
following procedure: This will provide a dialog that requests a filename,
+ This will provide a dialog that requests a filename,
effective dates, as well as a series of checkboxes,
including Transactions, Accounts List,
- Category List, and so forth. For best results, you should make sure that those three
+ For best results, you should make sure that those three
are checked. If you do not check the Accounts
- List box, then the name of your account will likely be
- lost, and that will cause problems when you try to import
- the data into GnuCash later. If you do not check the Accounts List
+ box, then the name of your account will likely be lost, and
+ that will cause problems when you try to import the data
+ into GnuCash later.Preamble
-
GNU GENERAL PUBLIC LICENSE TERMS AND
CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
- NO WARRANTY
- END OF TERMS AND CONDITIONS
- Chart of Accounts
-
- User Documentation Overview
+ User Documentation Overview
For help on a specific topic:
@@ -27,7 +28,7 @@
- Extended Help/System Documentation
+ Extended Help/System Documentation
-
-
-
+
+
, and check that the
importer is going to put your Quicken transactions in the right place.
You can click to pop up a dialog and change the GnuCash destination
account name/type for any QIF account. Don't be afraid to change
-these destination accounts; they are only guesses by the importer
+these destination accounts; they are merely guesses by the importer
based on the name and type of the QIF account. Mappings of Quicken
account to GnuCash account are written to a preferences file when you
click "OK", so if you import other Quicken files describing these same
@@ -453,7 +479,7 @@ point if someone tells me how it's supposed to work.
Brokerage accounts
- Quicken (TM) User's Guide
- Quicken Categories
- Creating QIF Files
+ Creating QIF Files
-
Loading QIF files into GnuCash
+Loading QIF files into GnuCash
- To import a Quicken QIF file, choose the menu @@ -105,22 +106,22 @@
Things To Note About QIF Import
+Things To Note About QIF Import
-
- Duplicate Entry Scanning
+ Duplicate Entry Scanning
-
Note that during merge, a scan is made for duplicate +
Note that during merge, a scan is made for duplicate transactions, and duplicates are removed. A duplicate transaction is one where the date, description (payee), memo, quantity, share price, and debited/credited accounts - or categories match exactly. Thus, the merge + or categories match exactly. Thus, the merge should be safe unless you have multiple transactions on the same date, to the same account, for the same amount, with the same description and memo.
-This unfortunately can occur, the typical +
This unfortunately can occur, the typical scenario involving where you make multiple withdrawals of identical amounts from ATM machines on the same day.
@@ -140,32 +141,32 @@
-
- QIF Mark II An ongoing project is to build an
+ QIF Mark II An ongoing project is to build an
alternative import utility in Guile that will be more
flexible, and which, by virtue of being stored as a set of
Scheme scripts, may be modified without needing to
recompile the whole application.
-
At this point, it successfully parses QIF +
At this point, it successfully parses QIF files; what remains is the (rather complex task) of determine appropriate correspondences between the Quicken - Categories and the GnuCash equivalents. That is one + Categories and the GnuCash equivalents. That is one of the most significant weaknesses with the present QIF import scheme.
-
- More about QIF
+ More about QIF
-
Further details about the QIF Interchange Format may be - found Further details about the QIF Interchange Format may be + found here.
-
Return to Main Documentation
+ Return to Main Documentation
Page. The Reconciliation window is used to reconcile cleared
+ The Reconciliation window is used to reconcile cleared
transactions from a bank statement. Enter a dollar amount from
- your last bank statement in the box, and then click
- OK . The window will then show all unreconciled
- transactions since your last bank statement. The reconcile
- window looks like this:Reconciliation Window
-
The Reconciliation window is used to reconcile the user's +
The Reconciliation window is used to reconcile the user's records at the end of the month. This involves validating the transactions in GnuCash against the transactions indicated on your bank statement.
-For example, when you write a check for something, you +
For example, when you write a check for something, you should enter the transaction into GnuCash.
-At the end of the month, you receive your bank statement, - perhaps including canceled checks. At that point, - you should "reconcile" the account, that is, agree your - personal records to the documentation provided by the bank.
+At the end of the month, you receive your bank statement, + perhaps including canceled checks. At that point, you + should "reconcile" the account, that is, agree your personal + records to the documentation provided by the bank.
- Open the reconcile window, and GnuCash will prompt you to @@ -48,13 +49,13 @@
-
Now, examine each item on the bank statement.
-
If a check has cleared, as indicated by your bank +
If a check has cleared, as indicated by your bank statement, you should click the field between the description and payment fields, and it will then change from n to c, indicating the transaction has ccleared.
-You then repeat this for each item that appears on the +
You then repeat this for each item that appears on the bank statement, verifying that the amounts match with the amounts in GnuCash, and marking off transactions in GnuCash as they are reconciled.
@@ -83,16 +84,16 @@ unwise should pop up, but this doesn't seem to happen anymore. -Also, the "cleared" total at the bottom seems to display +
Also, the "cleared" total at the bottom seems to display $0.00 regardless of what transactions are cleared or reconciled.
-The "cleared" total should display the total of only the +
The "cleared" total should display the total of only the transactions that have been cleared (c) or reconciled (y).
-Return to Main Documentation +
Return to Main Documentation Page.
diff --git a/doc/html/C/xacc-regwin.html b/doc/html/C/xacc-regwin.html index e99695afbe..a25a0f5299 100644 --- a/doc/html/C/xacc-regwin.html +++ b/doc/html/C/xacc-regwin.html @@ -2,7 +2,8 @@ - +Register Window @@ -10,95 +11,122 @@Register Window
-
- This is the "Register" or the "Ledger" window. Transactions are entered here.
-To enter a new transaction, just type into the last blank transaction. - Use the mouse or the Register Keyboard Shortcutsto move between fields, and hit the Enter key or click record to - record the transaction:
-
- Notice how a the transaction has been recorded and a new, blank - transaction has been created.
-You can edit existing transactions in a similar manner. GnuCash - will prompt you to confirm any changes you make.
+
+
+ This is the "Register" or the "Ledger" window. Transactions + are entered here.
+ +To enter a new transaction, just type into the last blank + transaction. Use the mouse or the Register Keyboard Shortcutsto move + between fields, and hit the Enter key or click record to record + the transaction:
+
+
+ Notice how a the transaction has been recorded and a new, + blank transaction has been created.
+ +You can edit existing transactions in a similar manner. + GnuCash will prompt you to confirm any changes you make.
Manipulating transactions
-You can manipulate transactions with the toolbar or the "Transaction" - menu: -
- Delete: you can delete a transaction or an individual - split. -
- Cancel: this reverts any changes you have made to the - transaction you are currently entering/changing + +
- Delete: you can delete a transaction or an + individual split. + +
- Cancel: this reverts any changes you have made to + the transaction you are currently entering/changing +
- New: this moves the cursor to the last line of the - register where new transactions are entered -
- Jump: When placed over an existing transaction, it takes - you to the corresponding register entry in the other register entry - that this - transaction appears in -
- Transfer:This is an alternative way to enter a transaction. - You can do a transfer between any two accounts without opening - up other registers. -
- Close:Closes this register
You can manipulate transactions with the toolbar or the + "Transaction" menu:
+ +-
+
+
+ - Jump: When placed over an existing transaction, it + takes you to the corresponding register entry in the other + register entry that this transaction appears in + +
- Transfer:This is an alternative way to enter a + transaction. You can do a transfer between any two accounts + without opening up other registers. + +
- Close:Closes this register +
Viewing Transactions
- +The register can show transactions in a variety of different - ways, controlled by entries on the "Register" menu.
+ ways, controlled by entries on the "Register" menu. +The register can display transactions in several different - styles:
-- single-line mode: transactions are displayed on a single line. -
- double-line mode: transactions are displayed over two lines, - with more information about each transaction shown. -
- multi-line mode: transactions are displayed over multiple - lines, allowing the display of multiple entries. This allows you - to enter multi-split transactions (for instance, when you pay multiple bills with one check). -
- auto-single and auto-double modes are like single and - double-line modes, except that the currently-edited transaction - is displayed in multi-line form. This is a very convenient way - of entering multi-account transactions.
To change the display style, to go the "Register" menu and select - "style".
+-
+
- single-line mode: transactions are displayed on a + single line. + +
- double-line mode: transactions are displayed over + two lines, with more information about each transaction + shown. + +
- multi-line mode: transactions are displayed over + multiple lines, allowing the display of multiple entries. + This allows you to enter multi-split transactions (for + instance, when you pay multiple bills with one check). + +
- auto-single and auto-double modes are like single + and double-line modes, except that the currently-edited + transaction is displayed in multi-line form. This is a very + convenient way of entering multi-account transactions. +
To change the display style, to go the "Register" menu and + select "style".
+ +Existing transactions are normally displayed in date order, + but this can also be changed with "Sort Order". You can also + select a date rate from which transactions will be displayed + with "Date Range".
-Existing transactions are normally displayed in date order, but - this can also be changed with "Sort Order". - You can also select a date rate from which transactions will be - displayed with "Date Range".
Reconciliation
-Transactions are typically checked against bank statements - a - process known as "reconciliation". GnuCash keeps track of - the reconciliation status of each transaction.
-The reconciliation status of a transaction is shown by the - reconciliation (R) field. 'c' indicates that a transaction - has been reconciled, 'n' indicates that it has not. You can - change the reconciliation status by clicking on a the 'r' field - of the transaction.
-At the bottom of the account window, there are two running + +
Transactions are typically checked against bank statements - + a process known as "reconciliation". GnuCash keeps track of the + reconciliation status of each transaction.
+ +The reconciliation status of a transaction is shown by the + reconciliation (R) field. 'c' indicates that a transaction has + been reconciled, 'n' indicates that it has not. You can change + the reconciliation status by clicking on a the 'r' field of the + transaction.
+ +At the bottom of the account window, there are two running balances, the "cleared and reconciled" balance, and the "total" balance... the "cleared and reconciled" balance should correspond to how much money the bank thinks you have in your account, and the "total" balance includes outstanding transactions.
-Reconciliation can be done in the Reconciliation can be done in the Reconcile Window
- -Stock Portfolios
-You can do stock transactions either from a single-stock +
You can do stock transactions either from a single-stock window, or from a portfolio-view window, shown below.
- 
+
The portfolio ledger can seem a bit daunting at first +
The portfolio ledger can seem a bit daunting at first sight.
-If you have trouble understanding it, then you may wish to +
If you have trouble understanding it, then you may wish to create an account for each stock you wish to track.
-Some important points to remember about the portfolio +
Some important points to remember about the portfolio window:
-
@@ -106,14 +134,14 @@
It shows all stocks in your portfolio, not just
one.
-
-
Note that it uses a two line display.
-
Debited accounts and debited amounts are on the upper +
Debited accounts and debited amounts are on the upper line, and credited amounts and accounts are on the lower line.
@@ -141,7 +169,7 @@
window may be provided.
The share amounts shown are for each particular +
The share amounts shown are for each particular stock.
Return to Main Documentation
+ Return to Main Documentation
Page. A variety of financial reports can be selected on the "Extensions"
- menu":
- A variety of financial reports can be selected on the
+ "Extensions" menu": The report is displayed in a resizable, scrollable window. To
- control the report, you can use the toolbar buttons at the
- top of the window:
- See the help for the individual reports for details of options
- available. The reporting interface is presently undocumented, but you can
- get a good idea of how it works by examining the file
- src/scm/report/hello-world.scm in the GnuCash source distribution.
- You will also need to access data from the "engine" to get
- information for your report. This is performed by a set of Scheme
- wrapper functions that are documented in the file src/g-wrap/gnc.html.
- You may wish to examine some of the other reports in src/scm/report
- for an indication of how they are used.
- At present, reports are produced by internally creating HTML and
- rendering this with a HTML widget. (Future versions of GnuCash
- will hopefully support a more flexible system).
- If you need more information, or have developed a new report that
- may be of use to others, please contact the GnuCash development
- mailing list at gnucash-devel@gnucash.org.
+ The report is displayed in a resizable, scrollable window.
+ To control the report, you can use the toolbar buttons at the
+ top of the window: See the help for the individual reports for details of
+ options available. The reporting interface is presently undocumented, but you
+ can get a good idea of how it works by examining the file
+ src/scm/report/hello-world.scm in the GnuCash source
+ distribution. You will also need to access data from the "engine" to get
+ information for your report. This is performed by a set of
+ Scheme wrapper functions that are documented in the file
+ src/g-wrap/gnc.html. You may wish to examine some of the other
+ reports in src/scm/report for an indication of how they are
+ used. At present, reports are produced by internally creating HTML
+ and rendering this with a HTML widget. (Future versions of
+ GnuCash will hopefully support a more flexible system). If you need more information, or have developed a new report
+ that may be of use to others, please contact the GnuCash
+ development mailing list at
+ gnucash-devel@gnucash.org. Return to Main Documentation
+
+ Return to Main Documentation
Page.Reports
-
+
+
The Report Window
- Once you select a report, a report window will appear:
- 
- 
Constructing custom reports
+ Once you select a report, a report window will appear:
- It is possible to write your own reports to meet your own needs, if
- you can program a little.
- You will need to know Scheme (a LISP-like programming language),
- and it is an excellent idea to have a copy of the Gnucash source code
- available.
-
+
+
+ Constructing custom reports
+ It is possible to write your own reports to meet your own
+ needs, if you can program a little. You will need to know
+ Scheme (a LISP-like programming language), and it is an
+ excellent idea to have a copy of the Gnucash source code
+ available.
+
+
-
-
-
+
| Name | +Pseudo-symbol |
|---|---|
| Stock | +CREFstok |
| Money Market | +CREFmony |
| Equity Index | +CREFequi |
| Inflation-Linked Bond | +CREFinfb |
| Bond Market | +CREFbond |
| TIAA Real Estate | +TIAAreal |
| Social Choice | +CREFsoci |
| Teachers PA Stock Index | +TIAAsndx |
| Global Equities | +CREFglob |
| Teachers PA Select Stock | +TIAAsele |
| Growth | +CREFgrow |
A sample image is shown below:
- 
To update the prices stored in a gnucash account file, run the command line command gnc-price, specifying the @@ -279,10 +307,11 @@
After running gnc-prices for a few days, your
accounts will begin to resemble the following:
- 
Return to Main Documentation Page.
+ diff --git a/doc/html/C/xacc-trans_report.html b/doc/html/C/xacc-trans_report.html index 7bf0033934..c4f218b98f 100644 --- a/doc/html/C/xacc-trans_report.html +++ b/doc/html/C/xacc-trans_report.html @@ -1,33 +1,46 @@ + - - + + +Transaction Report
- -Transaction reports list details for transactions in a specified - account over a specified period, in a convenient format for - viewing and exporting.
+ +Transaction reports list details for transactions in a + specified account over a specified period, in a convenient + format for viewing and exporting.
+Options specifiable for this report include:
-- Account: the account to do the report on. -
- Date To and Date From: the date range for the report - to cover. + +
- Account: the account to do the report on. + +
- Date To and Date From: the date range for the + report to cover. +
- Primary Sort Key: the field to sort on first. -
- Primary Sort Order: the order in which to sort. "Ascending" - specifies smallest/largest, alphabetical ordering, earliest->latest, - or smallest amounts first. Descending produces the opposite effects. -
- Secondary Sort Key: the field to sort on if the primary - sort keys are equal -
- Secondary Sort Order: the ordering on which to sort the - secondary key. + +
- Primary Sort Order: the order in which to sort. + "Ascending" specifies smallest/largest, alphabetical + ordering, earliest->latest, or smallest amounts first. + Descending produces the opposite effects. + +
- Secondary Sort Key: the field to sort on if the + primary sort keys are equal + +
- Secondary Sort Order: the ordering on which to + sort the secondary key.
-
+
-
Return to Main Documentation
+
+ Return to Main Documentation
Page. GnuCash versions 1.1.25 and later store all dates as
- seconds and nanoseconds, where the seconds are stored in a
- 64-bit signed integer. This should suffice to store dates into
- both the distant past as well as the distant future, so long as
- they fall not too many orders of magnitude outside
+ GnuCash versions 1.1.25 and later store all dates as seconds
+ and nanoseconds, where the seconds are stored in a 64-bit
+ signed integer. This should suffice to store dates into both
+ the distant past as well as the distant future, so long as they
+ fall not too many orders of magnitude outside
cosmologists' estimations of the age of the universe. The file format for version 1.1.25 and later stores dates
- in the above-described fashion. The file format for version 1.1.25 and later stores dates in
+ the above-described fashion. Some internal routines use the time_t type to
+ Some internal routines use the time_t type to
express seconds. Note that on most OSes, this is a 32-bit
quantity, and is thus limited to the Unix epoch, roughly
December 1901 thru Jan 2038. It is reasonable to expect that
- time_t will migrate to the use of 64 bit values by
+ time_t will migrate to the use of 64 bit values by
that time. Backup and log files are time-stamped using the standard
+ Backup and log files are time-stamped using the standard
Unix ctime() routine, which takes a time_t
argument. Thus, the backup and log mechanism may experience
trouble in 2038, assuming your present Unix continues to be in
service at that time without any remediation. Note that GnuCash also correctly recognizes February 29th,
+ Note that GnuCash also correctly recognizes February 29th,
2000 as a "leap day," another of the "critical Y2K dates." This is all highly suggestive that GnuCash should cope
+ This is all highly suggestive that GnuCash should cope
reasonably well with the transition to the new millennium,
whether that take place in 2000 or in 2001... Y2K issues are described in more detail at Linux and Year
+ Y2K issues are described in more detail at Linux and Year
2000. Return to Main Documentation
+ Return to Main Documentation
Page.GnuCash Y2K Readiness
-
-