mirror of
https://github.com/Gnucash/gnucash.git
synced 2025-02-25 18:55:30 -06:00
Add Christopher Browne's DocBook-ified GnuCash manual to the repository.
It is not yet fully integrated into the build system. git-svn-id: svn+ssh://svn.gnucash.org/repo/gnucash/trunk@2654 57a11ea4-9604-0410-9ed3-97b8803252fd
This commit is contained in:
Dave Peticolas
parent
128c6b361c
commit
f0b6be6d8e
@ -1,7 +1,7 @@
|
||||
|
||||
docdir = ${GNC_DOC_INSTALL_DIR}
|
||||
|
||||
SUBDIRS = examples html
|
||||
SUBDIRS = examples html sgml
|
||||
|
||||
doc_DATA = \
|
||||
README.francais \
|
||||
|
||||
@ -117,7 +117,7 @@ l = @l@
|
||||
|
||||
docdir = ${GNC_DOC_INSTALL_DIR}
|
||||
|
||||
SUBDIRS = examples html
|
||||
SUBDIRS = examples html sgml
|
||||
|
||||
doc_DATA = README.francais README.german guile-hackers.txt
|
||||
|
||||
|
||||
1
doc/sgml/.cvsignore
Normal file
1
doc/sgml/.cvsignore
Normal file
@ -0,0 +1 @@
|
||||
Makefile
|
||||
2
doc/sgml/C/.cvsignore
Normal file
2
doc/sgml/C/.cvsignore
Normal file
@ -0,0 +1,2 @@
|
||||
Makefile
|
||||
gnucash
|
||||
111
doc/sgml/C/Makefile.am
Normal file
111
doc/sgml/C/Makefile.am
Normal file
@ -0,0 +1,111 @@
|
||||
gnucash_helpdir = $(datadir)/gnome/help/gnucash/C
|
||||
|
||||
GNUCASH_DSL = mysheet.dsl
|
||||
|
||||
GNUCASH_SGML_FILES = \
|
||||
bofa-mym.sgml \
|
||||
xacc-about.sgml \
|
||||
xacc-accountedit.sgml \
|
||||
xacc-acctypes.sgml \
|
||||
xacc-adjbalwin.sgml \
|
||||
xacc-apar.sgml \
|
||||
xacc-balancereport.sgml \
|
||||
xacc-balancesheet.sgml \
|
||||
xacc-chartofaccts.sgml \
|
||||
xacc-currencyhandling.sgml \
|
||||
xacc-dateinput.sgml \
|
||||
xacc-depreciation.sgml \
|
||||
xacc-doubleentry.sgml \
|
||||
xacc-euro.sgml \
|
||||
xacc-gpl.sgml \
|
||||
xacc-incomeexpense.sgml \
|
||||
xacc-locatingtxns.sgml \
|
||||
xacc-mainwin.sgml \
|
||||
xacc-newacctwin.sgml \
|
||||
xacc-pnl.sgml \
|
||||
xacc-portfolio-report.sgml \
|
||||
xacc-preferences.sgml \
|
||||
xacc-preferences2.sgml \
|
||||
xacc-print-check.sgml \
|
||||
xacc-print.sgml \
|
||||
xacc-project.sgml \
|
||||
xacc-qif-import.sgml \
|
||||
xacc-quicken.sgml \
|
||||
xacc-recnwin.sgml \
|
||||
xacc-regwin-kbd.sgml \
|
||||
xacc-regwin.sgml \
|
||||
xacc-reports.sgml \
|
||||
xacc-ticker.sgml \
|
||||
xacc-trans-report.sgml \
|
||||
xacc-userdocs.sgml \
|
||||
xacc-y2k.sgml
|
||||
|
||||
GNUCASH_HTML_FILES = \
|
||||
docbook.css
|
||||
bofa-mym.html
|
||||
gnucash.html
|
||||
xacc-about.html
|
||||
xacc-accountedit.html
|
||||
xacc-acctypes.html
|
||||
xacc-adjbalwin.html
|
||||
xacc-apar.html
|
||||
xacc-ar.html
|
||||
xacc-arch.html
|
||||
xacc-archaeology.html
|
||||
xacc-ardef.html
|
||||
xacc-balancereport.html
|
||||
xacc-balancesheet.html
|
||||
xacc-capitalgains.html
|
||||
xacc-chartofaccts.html
|
||||
xacc-currencyhandling.html
|
||||
xacc-customreports.html
|
||||
xacc-dateinput.html
|
||||
xacc-depr.html
|
||||
xacc-depreciation.html
|
||||
xacc-docbookuse.html
|
||||
xacc-dochack.html
|
||||
xacc-doubledef.html
|
||||
xacc-doubleentry.html
|
||||
xacc-doubleuse.html
|
||||
xacc-dupetxns.html
|
||||
xacc-euro.html
|
||||
xacc-exthelp.html
|
||||
xacc-feats.html
|
||||
xacc-gpl.html
|
||||
xacc-incexpuse.html
|
||||
xacc-incomeexpense.html
|
||||
xacc-isocurr.html
|
||||
xacc-locatingtxns.html
|
||||
xacc-mainwin.html
|
||||
xacc-mantxn.html
|
||||
xacc-newacctwin.html
|
||||
xacc-pnl.html
|
||||
xacc-portfolio-report.html
|
||||
xacc-preferences.html
|
||||
xacc-preferences2.html
|
||||
xacc-prepaidexpenses.html
|
||||
xacc-print-check.html
|
||||
xacc-print.html
|
||||
xacc-project.html
|
||||
xacc-qif-import.html
|
||||
xacc-qif.html
|
||||
xacc-quicken.html
|
||||
xacc-quickencats.html
|
||||
xacc-recnwin.html
|
||||
xacc-reconciliation.html
|
||||
xacc-references.html
|
||||
xacc-regwin-kbd.html
|
||||
xacc-regwin.html
|
||||
xacc-reports.html
|
||||
xacc-reportwindow.html
|
||||
xacc-reqs.html
|
||||
xacc-samplechart.html
|
||||
xacc-scrubbing.html
|
||||
xacc-size.html
|
||||
xacc-stkptlo.html
|
||||
xacc-termsother.html
|
||||
xacc-ticker.html
|
||||
xacc-trans-report.html
|
||||
xacc-userdocs.html
|
||||
xacc-viewtxn.html
|
||||
xacc-y2k.html
|
||||
301
doc/sgml/C/Makefile.in
Normal file
301
doc/sgml/C/Makefile.in
Normal file
@ -0,0 +1,301 @@
|
||||
# Makefile.in generated automatically by automake 1.4 from Makefile.am
|
||||
|
||||
# Copyright (C) 1994, 1995-8, 1999 Free Software Foundation, Inc.
|
||||
# This Makefile.in is free software; the Free Software Foundation
|
||||
# gives unlimited permission to copy and/or distribute it,
|
||||
# with or without modifications, as long as this notice is preserved.
|
||||
|
||||
# This program is distributed in the hope that it will be useful,
|
||||
# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
|
||||
# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
|
||||
# PARTICULAR PURPOSE.
|
||||
|
||||
|
||||
SHELL = @SHELL@
|
||||
|
||||
srcdir = @srcdir@
|
||||
top_srcdir = @top_srcdir@
|
||||
VPATH = @srcdir@
|
||||
prefix = @prefix@
|
||||
exec_prefix = @exec_prefix@
|
||||
|
||||
bindir = @bindir@
|
||||
sbindir = @sbindir@
|
||||
libexecdir = @libexecdir@
|
||||
datadir = @datadir@
|
||||
sysconfdir = @sysconfdir@
|
||||
sharedstatedir = @sharedstatedir@
|
||||
localstatedir = @localstatedir@
|
||||
libdir = @libdir@
|
||||
infodir = @infodir@
|
||||
mandir = @mandir@
|
||||
includedir = @includedir@
|
||||
oldincludedir = /usr/include
|
||||
|
||||
DESTDIR =
|
||||
|
||||
pkgdatadir = $(datadir)/@PACKAGE@
|
||||
pkglibdir = $(libdir)/@PACKAGE@
|
||||
pkgincludedir = $(includedir)/@PACKAGE@
|
||||
|
||||
top_builddir = ../../..
|
||||
|
||||
ACLOCAL = @ACLOCAL@
|
||||
AUTOCONF = @AUTOCONF@
|
||||
AUTOMAKE = @AUTOMAKE@
|
||||
AUTOHEADER = @AUTOHEADER@
|
||||
|
||||
INSTALL = @INSTALL@
|
||||
INSTALL_PROGRAM = @INSTALL_PROGRAM@ $(AM_INSTALL_PROGRAM_FLAGS)
|
||||
INSTALL_DATA = @INSTALL_DATA@
|
||||
INSTALL_SCRIPT = @INSTALL_SCRIPT@
|
||||
transform = @program_transform_name@
|
||||
|
||||
NORMAL_INSTALL = :
|
||||
PRE_INSTALL = :
|
||||
POST_INSTALL = :
|
||||
NORMAL_UNINSTALL = :
|
||||
PRE_UNINSTALL = :
|
||||
POST_UNINSTALL = :
|
||||
host_alias = @host_alias@
|
||||
host_triplet = @host@
|
||||
AS = @AS@
|
||||
CATALOGS = @CATALOGS@
|
||||
CATOBJEXT = @CATOBJEXT@
|
||||
CC = @CC@
|
||||
DATADIRNAME = @DATADIRNAME@
|
||||
DLLTOOL = @DLLTOOL@
|
||||
GENCAT = @GENCAT@
|
||||
GLIB_CFLAGS = @GLIB_CFLAGS@
|
||||
GLIB_CONFIG_BIN = @GLIB_CONFIG_BIN@
|
||||
GLIB_LIBS = @GLIB_LIBS@
|
||||
GMOFILES = @GMOFILES@
|
||||
GMSGFMT = @GMSGFMT@
|
||||
GNC_CONFIGDIR = @GNC_CONFIGDIR@
|
||||
GNC_DOC_INSTALL_DIR = @GNC_DOC_INSTALL_DIR@
|
||||
GNC_LIBDIR = @GNC_LIBDIR@
|
||||
GNC_SCM_INSTALL_DIR = @GNC_SCM_INSTALL_DIR@
|
||||
GNC_SHAREDIR = @GNC_SHAREDIR@
|
||||
GNOME_CFLAGS = @GNOME_CFLAGS@
|
||||
GNOME_CONFIG_BIN = @GNOME_CONFIG_BIN@
|
||||
GNOME_LIBS = @GNOME_LIBS@
|
||||
GNOME_STATIC_TARGET = @GNOME_STATIC_TARGET@
|
||||
GNOME_TARGET = @GNOME_TARGET@
|
||||
GT_NO = @GT_NO@
|
||||
GT_YES = @GT_YES@
|
||||
GUILE = @GUILE@
|
||||
GUILE_COMPILE_ARGS = @GUILE_COMPILE_ARGS@
|
||||
GUILE_CONFIG = @GUILE_CONFIG@
|
||||
GUILE_LINK_ARGS = @GUILE_LINK_ARGS@
|
||||
G_WRAP = @G_WRAP@
|
||||
G_WRAP_COMPILE_ARGS = @G_WRAP_COMPILE_ARGS@
|
||||
G_WRAP_CONFIG = @G_WRAP_CONFIG@
|
||||
G_WRAP_LINK_ARGS = @G_WRAP_LINK_ARGS@
|
||||
INCLUDE_LOCALE_H = @INCLUDE_LOCALE_H@
|
||||
INSTOBJEXT = @INSTOBJEXT@
|
||||
INTLDEPS = @INTLDEPS@
|
||||
INTLLIBS = @INTLLIBS@
|
||||
INTLOBJS = @INTLOBJS@
|
||||
LIBTOOL = @LIBTOOL@
|
||||
LN_S = @LN_S@
|
||||
LOCALE_DIR = @LOCALE_DIR@
|
||||
MAKEINFO = @MAKEINFO@
|
||||
MKINSTALLDIRS = @MKINSTALLDIRS@
|
||||
MSGFMT = @MSGFMT@
|
||||
OBJDUMP = @OBJDUMP@
|
||||
PACKAGE = @PACKAGE@
|
||||
PERL = @PERL@
|
||||
PERLINCL = @PERLINCL@
|
||||
POFILES = @POFILES@
|
||||
POSUB = @POSUB@
|
||||
RANLIB = @RANLIB@
|
||||
SWIG = @SWIG@
|
||||
USE_INCLUDED_LIBINTL = @USE_INCLUDED_LIBINTL@
|
||||
USE_NLS = @USE_NLS@
|
||||
VERSION = @VERSION@
|
||||
l = @l@
|
||||
|
||||
gnucash_helpdir = $(datadir)/gnome/help/gnucash/C
|
||||
|
||||
GNUCASH_DSL = mysheet.dsl
|
||||
|
||||
GNUCASH_SGML_FILES = bofa-mym.sgml xacc-about.sgml xacc-accountedit.sgml xacc-acctypes.sgml xacc-adjbalwin.sgml xacc-apar.sgml xacc-balancereport.sgml xacc-balancesheet.sgml xacc-chartofaccts.sgml xacc-currencyhandling.sgml xacc-dateinput.sgml xacc-depreciation.sgml xacc-doubleentry.sgml xacc-euro.sgml xacc-gpl.sgml xacc-incomeexpense.sgml xacc-locatingtxns.sgml xacc-mainwin.sgml xacc-newacctwin.sgml xacc-pnl.sgml xacc-portfolio-report.sgml xacc-preferences.sgml xacc-preferences2.sgml xacc-print-check.sgml xacc-print.sgml xacc-project.sgml xacc-qif-import.sgml xacc-quicken.sgml xacc-recnwin.sgml xacc-regwin-kbd.sgml xacc-regwin.sgml xacc-reports.sgml xacc-ticker.sgml xacc-trans-report.sgml xacc-userdocs.sgml xacc-y2k.sgml
|
||||
|
||||
|
||||
GNUCASH_HTML_FILES = docbook.css
|
||||
|
||||
mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs
|
||||
CONFIG_HEADER = ../../../config.h
|
||||
CONFIG_CLEAN_FILES =
|
||||
DIST_COMMON = Makefile.am Makefile.in
|
||||
|
||||
|
||||
DISTFILES = $(DIST_COMMON) $(SOURCES) $(HEADERS) $(TEXINFOS) $(EXTRA_DIST)
|
||||
|
||||
TAR = gtar
|
||||
GZIP_ENV = --best
|
||||
all: all-redirect
|
||||
.SUFFIXES:
|
||||
$(srcdir)/Makefile.in: Makefile.am $(top_srcdir)/configure.in $(ACLOCAL_M4)
|
||||
cd $(top_srcdir) && $(AUTOMAKE) --gnu doc/sgml/C/Makefile
|
||||
|
||||
Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status $(BUILT_SOURCES)
|
||||
cd $(top_builddir) \
|
||||
&& CONFIG_FILES=$(subdir)/$@ CONFIG_HEADERS= $(SHELL) ./config.status
|
||||
|
||||
tags: TAGS
|
||||
TAGS:
|
||||
|
||||
|
||||
distdir = $(top_builddir)/$(PACKAGE)-$(VERSION)/$(subdir)
|
||||
|
||||
subdir = doc/sgml/C
|
||||
|
||||
distdir: $(DISTFILES)
|
||||
here=`cd $(top_builddir) && pwd`; \
|
||||
top_distdir=`cd $(top_distdir) && pwd`; \
|
||||
distdir=`cd $(distdir) && pwd`; \
|
||||
cd $(top_srcdir) \
|
||||
&& $(AUTOMAKE) --include-deps --build-dir=$$here --srcdir-name=$(top_srcdir) --output-dir=$$top_distdir --gnu doc/sgml/C/Makefile
|
||||
@for file in $(DISTFILES); do \
|
||||
d=$(srcdir); \
|
||||
if test -d $$d/$$file; then \
|
||||
cp -pr $$d/$$file $(distdir)/$$file; \
|
||||
else \
|
||||
test -f $(distdir)/$$file \
|
||||
|| ln $$d/$$file $(distdir)/$$file 2> /dev/null \
|
||||
|| cp -p $$d/$$file $(distdir)/$$file || :; \
|
||||
fi; \
|
||||
done
|
||||
info-am:
|
||||
info: info-am
|
||||
dvi-am:
|
||||
dvi: dvi-am
|
||||
check-am: all-am
|
||||
check: check-am
|
||||
installcheck-am:
|
||||
installcheck: installcheck-am
|
||||
install-exec-am:
|
||||
install-exec: install-exec-am
|
||||
|
||||
install-data-am:
|
||||
install-data: install-data-am
|
||||
|
||||
install-am: all-am
|
||||
@$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
|
||||
install: install-am
|
||||
uninstall-am:
|
||||
uninstall: uninstall-am
|
||||
all-am: Makefile
|
||||
all-redirect: all-am
|
||||
install-strip:
|
||||
$(MAKE) $(AM_MAKEFLAGS) AM_INSTALL_PROGRAM_FLAGS=-s install
|
||||
installdirs:
|
||||
|
||||
|
||||
mostlyclean-generic:
|
||||
|
||||
clean-generic:
|
||||
|
||||
distclean-generic:
|
||||
-rm -f Makefile $(CONFIG_CLEAN_FILES)
|
||||
-rm -f config.cache config.log stamp-h stamp-h[0-9]*
|
||||
|
||||
maintainer-clean-generic:
|
||||
mostlyclean-am: mostlyclean-generic
|
||||
|
||||
mostlyclean: mostlyclean-am
|
||||
|
||||
clean-am: clean-generic mostlyclean-am
|
||||
|
||||
clean: clean-am
|
||||
|
||||
distclean-am: distclean-generic clean-am
|
||||
-rm -f libtool
|
||||
|
||||
distclean: distclean-am
|
||||
|
||||
maintainer-clean-am: maintainer-clean-generic distclean-am
|
||||
@echo "This command is intended for maintainers to use;"
|
||||
@echo "it deletes files that may require special tools to rebuild."
|
||||
|
||||
maintainer-clean: maintainer-clean-am
|
||||
|
||||
.PHONY: tags distdir info-am info dvi-am dvi check check-am \
|
||||
installcheck-am installcheck install-exec-am install-exec \
|
||||
install-data-am install-data install-am install uninstall-am uninstall \
|
||||
all-redirect all-am all installdirs mostlyclean-generic \
|
||||
distclean-generic clean-generic maintainer-clean-generic clean \
|
||||
mostlyclean distclean maintainer-clean
|
||||
|
||||
bofa-mym.html
|
||||
gnucash.html
|
||||
xacc-about.html
|
||||
xacc-accountedit.html
|
||||
xacc-acctypes.html
|
||||
xacc-adjbalwin.html
|
||||
xacc-apar.html
|
||||
xacc-ar.html
|
||||
xacc-arch.html
|
||||
xacc-archaeology.html
|
||||
xacc-ardef.html
|
||||
xacc-balancereport.html
|
||||
xacc-balancesheet.html
|
||||
xacc-capitalgains.html
|
||||
xacc-chartofaccts.html
|
||||
xacc-currencyhandling.html
|
||||
xacc-customreports.html
|
||||
xacc-dateinput.html
|
||||
xacc-depr.html
|
||||
xacc-depreciation.html
|
||||
xacc-docbookuse.html
|
||||
xacc-dochack.html
|
||||
xacc-doubledef.html
|
||||
xacc-doubleentry.html
|
||||
xacc-doubleuse.html
|
||||
xacc-dupetxns.html
|
||||
xacc-euro.html
|
||||
xacc-exthelp.html
|
||||
xacc-feats.html
|
||||
xacc-gpl.html
|
||||
xacc-incexpuse.html
|
||||
xacc-incomeexpense.html
|
||||
xacc-isocurr.html
|
||||
xacc-locatingtxns.html
|
||||
xacc-mainwin.html
|
||||
xacc-mantxn.html
|
||||
xacc-newacctwin.html
|
||||
xacc-pnl.html
|
||||
xacc-portfolio-report.html
|
||||
xacc-preferences.html
|
||||
xacc-preferences2.html
|
||||
xacc-prepaidexpenses.html
|
||||
xacc-print-check.html
|
||||
xacc-print.html
|
||||
xacc-project.html
|
||||
xacc-qif-import.html
|
||||
xacc-qif.html
|
||||
xacc-quicken.html
|
||||
xacc-quickencats.html
|
||||
xacc-recnwin.html
|
||||
xacc-reconciliation.html
|
||||
xacc-references.html
|
||||
xacc-regwin-kbd.html
|
||||
xacc-regwin.html
|
||||
xacc-reports.html
|
||||
xacc-reportwindow.html
|
||||
xacc-reqs.html
|
||||
xacc-samplechart.html
|
||||
xacc-scrubbing.html
|
||||
xacc-size.html
|
||||
xacc-stkptlo.html
|
||||
xacc-termsother.html
|
||||
xacc-ticker.html
|
||||
xacc-trans-report.html
|
||||
xacc-userdocs.html
|
||||
xacc-viewtxn.html
|
||||
xacc-y2k.html
|
||||
|
||||
# Tell versions [3.59,3.63) of GNU make to not export all variables.
|
||||
# Otherwise a system limit (for SysV at least) may be exceeded.
|
||||
.NOEXPORT:
|
||||
36
doc/sgml/C/bofa-mym.sgml
Normal file
36
doc/sgml/C/bofa-mym.sgml
Normal file
@ -0,0 +1,36 @@
|
||||
<ARTICLE ID="BOFA-MYM">
|
||||
<ARTHEADER>
|
||||
<TITLE>Importing MYM Files</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Managing Your Money to GnuCash Conversion </TITLE>
|
||||
<PARA> Ken Yamaguchi has kindly made available a Perl script that
|
||||
allows <APPLICATION>Managing Your Money 2.x</APPLICATION> data to be converted into QIF
|
||||
format, which can then be imported into <APPLICATION>GnuCash</APPLICATION>. It has been
|
||||
tested with 1.3.99 and works well. The script is available
|
||||
from:
|
||||
|
||||
|
||||
|
||||
</PARA>
|
||||
<PARA><ULINK URL="http://www-cad.eecs.berkeley.edu/~gooch/mymdump.html"> http://www-cad.eecs.berkeley.edu/~gooch/mymdump.html</ULINK>
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-DUPETXNS">
|
||||
<TITLE> Duplicate Transactions</TITLE>
|
||||
<PARA> Ken has also written a script that removes duplicate
|
||||
transactions at the QIF level. GnuCash is very strict about
|
||||
duplicates, and this script is useful for successfully
|
||||
importing a succession of QIF files provided by a bank for
|
||||
overlapping time periods, for instance. This script is
|
||||
available from:
|
||||
|
||||
</PARA>
|
||||
<PARA><ULINK URL="http://www-cad.eecs.berkeley.edu/~gooch/qifuniq.html"> "http://www-cad.eecs.berkeley.edu/~gooch/qifuniq.html</ULINK>
|
||||
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
81
doc/sgml/C/gnucash.sgml
Normal file
81
doc/sgml/C/gnucash.sgml
Normal file
@ -0,0 +1,81 @@
|
||||
<!DOCTYPE BOOK PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
|
||||
<!entity xaccabout system "xacc-about.sgml">
|
||||
<!entity xaccproject system "xacc-project.sgml">
|
||||
<!entity xaccaccountedit system "xacc-accountedit.sgml">
|
||||
<!entity xaccacctypes system "xacc-acctypes.sgml">
|
||||
<!entity xaccnewacctwin system "xacc-newacctwin.sgml">
|
||||
<!entity xaccadjbalwin system "xacc-adjbalwin.sgml">
|
||||
<!entity xaccapar system "xacc-apar.sgml">
|
||||
<!entity xaccdepreciation system "xacc-depreciation.sgml">
|
||||
<!entity xaccbalancereport system "xacc-balancereport.sgml">
|
||||
<!entity xaccbalancesheet system "xacc-balancesheet.sgml">
|
||||
<!entity xacccurrencyhandling system "xacc-currencyhandling.sgml">
|
||||
<!entity xaccdoubleentry system "xacc-doubleentry.sgml">
|
||||
<!entity xacceuro system "xacc-euro.sgml">
|
||||
<!entity xaccdateinput system "xacc-dateinput.sgml">
|
||||
<!entity xaccincomeexpense system "xacc-incomeexpense.sgml">
|
||||
<!entity xacclocatingtxns system "xacc-locatingtxns.sgml">
|
||||
<!entity xaccpreferences system "xacc-preferences.sgml">
|
||||
<!entity xaccpreferences2 system "xacc-preferences2.sgml">
|
||||
<!entity xaccchartofaccts system "xacc-chartofaccts.sgml">
|
||||
<!entity xaccuserdocs system "xacc-userdocs.sgml">
|
||||
<!entity xaccmainwin system "xacc-mainwin.sgml">
|
||||
<!entity xaccpnl system "xacc-pnl.sgml">
|
||||
<!entity xaccportfolioreport system "xacc-portfolio-report.sgml">
|
||||
<!entity xaccprintcheck system "xacc-print-check.sgml">
|
||||
<!entity xaccprint system "xacc-print.sgml">
|
||||
<!entity xaccqifimport system "xacc-qif-import.sgml">
|
||||
<!entity xaccquicken system "xacc-quicken.sgml">
|
||||
<!entity xaccrecnwin system "xacc-recnwin.sgml">
|
||||
<!entity xaccregwin system "xacc-regwin.sgml">
|
||||
<!entity xaccregwinkbd system "xacc-regwin-kbd.sgml">
|
||||
<!entity xaccreports system "xacc-reports.sgml">
|
||||
<!entity xaccticker system "xacc-ticker.sgml">
|
||||
<!entity xacctransreport system "xacc-trans-report.sgml">
|
||||
<!entity xaccdochack system "xacc-dochack.sgml">
|
||||
<!entity xaccy2k system "xacc-y2k.sgml">
|
||||
<!entity xaccgpl system "xacc-gpl.sgml">
|
||||
<!entity bofamym system "bofa-mym.sgml">
|
||||
]>
|
||||
<BOOK ID="GNUCASH">
|
||||
<TITLE>GnuCash Documentation Set</TITLE>
|
||||
|
||||
&xaccabout;
|
||||
&xaccproject;
|
||||
&xaccaccountedit;
|
||||
&xaccacctypes;
|
||||
&xaccnewacctwin;
|
||||
&xaccadjbalwin;
|
||||
&xaccapar;
|
||||
&xaccdepreciation;
|
||||
&xaccbalancereport;
|
||||
&xaccbalancesheet;
|
||||
&xacccurrencyhandling;
|
||||
&xaccdoubleentry;
|
||||
&xacceuro;
|
||||
&xaccdateinput;
|
||||
&xaccincomeexpense;
|
||||
&xacclocatingtxns;
|
||||
&xaccpreferences;
|
||||
&xaccpreferences2;
|
||||
&xaccchartofaccts;
|
||||
&xaccuserdocs;
|
||||
&xaccmainwin;
|
||||
&xaccpnl;
|
||||
&xaccportfolioreport;
|
||||
&xaccprintcheck;
|
||||
&xaccprint;
|
||||
&xaccqifimport;
|
||||
&xaccquicken;
|
||||
&xaccrecnwin;
|
||||
&xaccregwin;
|
||||
&xaccregwinkbd;
|
||||
&xaccreports;
|
||||
&xaccticker;
|
||||
&xacctransreport;
|
||||
&xaccdochack;
|
||||
&xaccy2k;
|
||||
&xaccgpl;
|
||||
&bofamym;
|
||||
|
||||
</book>
|
||||
1026
doc/sgml/C/xacc-about.sgml
Normal file
1026
doc/sgml/C/xacc-about.sgml
Normal file
File diff suppressed because it is too large
Load Diff
34
doc/sgml/C/xacc-accountedit.sgml
Normal file
34
doc/sgml/C/xacc-accountedit.sgml
Normal file
@ -0,0 +1,34 @@
|
||||
|
||||
<ARTICLE ID="XACC-ACCOUNTEDIT">
|
||||
<ARTHEADER>
|
||||
<TITLE>Editing Account Parameters</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Editing Account Parameters</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>The "Edit Account" dialog box lets you change the properties
|
||||
of an account. You can access this via the "edit" button of the
|
||||
main window toolbar, the "Accounts" menu, or via the keyboard
|
||||
shortcuts. For a description of the uses of the various
|
||||
properties, see the information about <LINK LINKEND="XACC-NEWACCTWIN">new accounts</LINK>.
|
||||
|
||||
</PARA>
|
||||
<PARA><EMPHASIS>Account information</EMPHASIS> can be changed by typing in the
|
||||
appropriate field. The account type cannot be changed.
|
||||
|
||||
</PARA>
|
||||
<PARA>A new <EMPHASIS>Parent Account</EMPHASIS> can be selected. Only those
|
||||
accounts that can legally become the parent of the present
|
||||
account are shown.
|
||||
|
||||
</PARA>
|
||||
<PARA>The source for <EMPHASIS>Stock Quotes</EMPHASIS> can be selected. See <LINK LINKEND="XACC-TICKER">the ticker</LINK> for more
|
||||
information.
|
||||
|
||||
</PARA>
|
||||
<PARA><EMPHASIS>Notes</EMPHASIS> about the account can be edited.
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
236
doc/sgml/C/xacc-acctypes.sgml
Normal file
236
doc/sgml/C/xacc-acctypes.sgml
Normal file
@ -0,0 +1,236 @@
|
||||
|
||||
<ARTICLE ID="XACC-ACCTYPES">
|
||||
<ARTHEADER>
|
||||
<TITLE></TITLE>
|
||||
<TITLE>Account Types</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Account Types</TITLE>
|
||||
<PARA></PARA>
|
||||
<PARA> GnuCash supports a number of different account types. You should
|
||||
always choose the type that is appropriate for what you want to
|
||||
record. If you're not sure, the explanations below should help you
|
||||
decide.
|
||||
|
||||
<GLOSSLIST>
|
||||
<GLOSSENTRY>
|
||||
<GLOSSTERM><EMPHASIS>Cash</EMPHASIS></GLOSSTERM>
|
||||
<GLOSSDEF>
|
||||
<PARA>The <EMPHASIS>cash</EMPHASIS> account type is used to denote the cash
|
||||
that you store in your wallet, shoebox, piggybank, or
|
||||
mattress.</PARA>
|
||||
</GLOSSDEF>
|
||||
</GLOSSENTRY>
|
||||
<GLOSSENTRY>
|
||||
<GLOSSTERM><EMPHASIS>Bank</EMPHASIS></GLOSSTERM>
|
||||
<GLOSSDEF>
|
||||
<PARA>The <EMPHASIS>Bank</EMPHASIS> account type denotes a savings or
|
||||
checking account held at a bank or other financial
|
||||
institution.</PARA>
|
||||
</GLOSSDEF>
|
||||
<GLOSSDEF>
|
||||
<PARA> Such accounts sometimes bear interest.
|
||||
|
||||
</PARA>
|
||||
</GLOSSDEF>
|
||||
</GLOSSENTRY>
|
||||
<GLOSSENTRY>
|
||||
<GLOSSTERM><EMPHASIS>Credit</EMPHASIS></GLOSSTERM>
|
||||
<GLOSSDEF>
|
||||
<PARA>The <EMPHASIS> Credit</EMPHASIS> card account is used to denote credit
|
||||
card accounts, whether involving floating lines of credit as
|
||||
with VISA, MasterCard, or Discover, as well as others like
|
||||
American Express that do <EMPHASIS> not</EMPHASIS> permit you to maintain
|
||||
continuing balances.</PARA>
|
||||
</GLOSSDEF>
|
||||
<GLOSSDEF>
|
||||
<PARA>The introduction of <ULINK URL="http://www.visa.com/pd/debit/checkcard.html"> Check
|
||||
Cards</ULINK> where payments are withdrawn directly from a
|
||||
checking account makes the selection less clear; it is
|
||||
probably more appropriate to treat a "Check Card" as a <EMPHASIS> Bank</EMPHASIS> account, as it does withdraw amounts directly from
|
||||
such an account, not really involving any granting of
|
||||
credit.</PARA>
|
||||
</GLOSSDEF>
|
||||
<GLOSSDEF>
|
||||
<PARA> Note the ambiguity of AMEX and Check Cards. This shows that
|
||||
deciding where to put accounts is not an exact science.
|
||||
|
||||
</PARA>
|
||||
</GLOSSDEF>
|
||||
</GLOSSENTRY>
|
||||
<GLOSSENTRY>
|
||||
<GLOSSTERM><EMPHASIS>Asset, Liability</EMPHASIS></GLOSSTERM>
|
||||
<GLOSSDEF>
|
||||
<PARA><EMPHASIS>Asset</EMPHASIS> and <EMPHASIS>Liability</EMPHASIS> accounts are used for
|
||||
tracking things that are of value, but that are not so
|
||||
directly translated into <EMPHASIS> cash</EMPHASIS> .</PARA>
|
||||
</GLOSSDEF>
|
||||
<GLOSSDEF>
|
||||
<PARA>For instance, you might collect the costs of purchasing a
|
||||
house into an asset account entitled <EMPHASIS> My House,</EMPHASIS> or the
|
||||
cost of a car into <EMPHASIS> My Car,</EMPHASIS> or collect together the
|
||||
value of your <EMPHASIS> Computer Equipment.</EMPHASIS></PARA>
|
||||
</GLOSSDEF>
|
||||
<GLOSSDEF>
|
||||
<PARA>And the home mortgage or car loan would be represented by
|
||||
liability accounts, <EMPHASIS> Home Mortgage</EMPHASIS> and <EMPHASIS> Car
|
||||
Loan</EMPHASIS>, to be drawn down as payments are made on these
|
||||
loans.</PARA>
|
||||
</GLOSSDEF>
|
||||
<GLOSSDEF>
|
||||
<PARA>If you hold assets for business purposes, their decline
|
||||
in value over time might be treated as a deduction for tax
|
||||
purposes, that deduction being called <LINK LINKEND="XACC-DEPRECIATION">Depreciation.</LINK></PARA>
|
||||
</GLOSSDEF>
|
||||
<GLOSSDEF>
|
||||
<PARA>On the other hand, if you own assets that <EMPHASIS> appreciate</EMPHASIS> in value over time, such as real estate,
|
||||
collectibles like paintings, and investments like shares in
|
||||
companies, you may see them appreciate in value, and have to
|
||||
recognize, for tax purposes, what are called <LINK LINKEND="APPR"> Capital Gains.</LINK></PARA>
|
||||
</GLOSSDEF>
|
||||
</GLOSSENTRY>
|
||||
<GLOSSENTRY>
|
||||
<GLOSSTERM><ANCHOR ID="STOCKACCT"><EMPHASIS>Stock, Mutual Fund</EMPHASIS></GLOSSTERM>
|
||||
<GLOSSDEF>
|
||||
<PARA>Securities that you invest in are a form of asset that
|
||||
are normally acquired with the express purpose of receiving
|
||||
income either in the form of dividends, interest, or <LINK LINKEND="APPR"> Capital Gains.</LINK> There are a
|
||||
multitude of securities markets around the world, and
|
||||
securities that are widely enough traded can have pretty
|
||||
concrete values that may be analyzed on a day-to-day
|
||||
basis.</PARA>
|
||||
</GLOSSDEF>
|
||||
<GLOSSDEF>
|
||||
<PARA> Stock and Mutual Fund accounts are typically tracked in
|
||||
registers having three main columns:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Price
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Number of shares
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Cost
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
</PARA>
|
||||
</GLOSSDEF>
|
||||
<GLOSSDEF>
|
||||
<PARA> In order to get <EMPHASIS> useful</EMPHASIS> information out of the
|
||||
register, it is necessary to have multiple "views" on the
|
||||
data so that you may assess such things as:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Total Values by security
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Gains/Losses by security
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Return On Investment rates by security
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
</PARA>
|
||||
</GLOSSDEF>
|
||||
<GLOSSDEF>
|
||||
<PARA>More details may be found in the <LINK LINKEND="XACC-TICKER">Stock Ticker</LINK> section.</PARA>
|
||||
</GLOSSDEF>
|
||||
</GLOSSENTRY>
|
||||
<GLOSSENTRY>
|
||||
<GLOSSTERM><EMPHASIS><LINK LINKEND="XACC-EXPENSE"> Income,
|
||||
Expense</LINK></EMPHASIS></GLOSSTERM>
|
||||
<GLOSSDEF>
|
||||
<PARA><EMPHASIS> Income</EMPHASIS> and <EMPHASIS>Expense</EMPHASIS> account types are used to
|
||||
record income and expenses.</PARA>
|
||||
</GLOSSDEF>
|
||||
<GLOSSDEF>
|
||||
<PARA> For example, if you deposit a paycheck in your bank account, you
|
||||
should mark it as a transfer from an 'income' account type. </PARA>
|
||||
</GLOSSDEF>
|
||||
<GLOSSDEF>
|
||||
<PARA> Marking income in this way helps balance the books: the change in your
|
||||
net worth in the course of a few ekks, a few months, or a year, should
|
||||
exactly equal your income (minus expenses) for the same period. </PARA>
|
||||
</GLOSSDEF>
|
||||
<GLOSSDEF>
|
||||
<PARA> The value stored in the bank account contributes to your 'net worth';
|
||||
whereas the income contributes to your 'profits'.
|
||||
|
||||
</PARA>
|
||||
</GLOSSDEF>
|
||||
</GLOSSENTRY>
|
||||
<GLOSSENTRY>
|
||||
<GLOSSTERM><EMPHASIS>Equity</EMPHASIS></GLOSSTERM>
|
||||
<GLOSSDEF>
|
||||
<PARA><EMPHASIS>Equity</EMPHASIS> accounts are used to
|
||||
store the opening balances when you first start using GnuCash
|
||||
(or start a new accounting period).
|
||||
|
||||
|
||||
</PARA>
|
||||
</GLOSSDEF>
|
||||
<GLOSSDEF>
|
||||
<PARA>Assuming that you've had a bank
|
||||
account far longer than you've been using GnuCash, and assuming you
|
||||
don't want to type in old transactions, you will want to type in a
|
||||
non-zero <EMPHASIS> opening balance </EMPHASIS> into your bank account. This opening balance
|
||||
should be marked as a transfer from an account of type 'equity'.
|
||||
|
||||
</PARA>
|
||||
</GLOSSDEF>
|
||||
<GLOSSDEF>
|
||||
<PARA> Alternately, if you close and reopen all your books at the end of every
|
||||
quarter/year, the 'equity' will be your net-worth at the begining of the
|
||||
period: it equal all assets minus all liabilities.
|
||||
|
||||
</PARA>
|
||||
</GLOSSDEF>
|
||||
<GLOSSDEF>
|
||||
<PARA> As time goes by,
|
||||
you will have both income and expenses.
|
||||
|
||||
</PARA>
|
||||
</GLOSSDEF>
|
||||
<GLOSSDEF>
|
||||
<PARA> At the end of the year, your net
|
||||
worth will be the equity at the begining of the year, plus all income
|
||||
minus all expense. This value will become, of course, the equity for
|
||||
the next accounting period.
|
||||
|
||||
</PARA>
|
||||
</GLOSSDEF>
|
||||
</GLOSSENTRY>
|
||||
<GLOSSENTRY>
|
||||
<GLOSSTERM><LINK LINKEND="CURRENCY"> <EMPHASIS>Currency</EMPHASIS></LINK></GLOSSTERM>
|
||||
<GLOSSDEF>
|
||||
<PARA><EMPHASIS> Currency Accounts</EMPHASIS> are used for trading
|
||||
currencies.</PARA>
|
||||
</GLOSSDEF>
|
||||
<GLOSSDEF>
|
||||
<PARA>In most ways, they behave like stocks, except that the
|
||||
only way that "income" may be gotten from them is from
|
||||
fluctuations in the relative values of currencies. Note that
|
||||
transfers cannot be made directly between two accounts
|
||||
denominated in different currencies. Such transfers may only
|
||||
be made into currency trading accounts.</PARA>
|
||||
</GLOSSDEF>
|
||||
</GLOSSENTRY>
|
||||
</GLOSSLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
19
doc/sgml/C/xacc-adjbalwin.sgml
Normal file
19
doc/sgml/C/xacc-adjbalwin.sgml
Normal file
@ -0,0 +1,19 @@
|
||||
|
||||
<ARTICLE ID="XACC-ADJBALWIN">
|
||||
<ARTHEADER>
|
||||
<TITLE></TITLE>
|
||||
<TITLE>Adjust Balance Window</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Adjust Balance Window</TITLE>
|
||||
<PARA> Adjust Balance window. Use this to adjust the balance. Enter a
|
||||
dollar amount, and a register entry will be created that sets
|
||||
the balance to the new balance.
|
||||
|
||||
</PARA>
|
||||
<PARA><EMPHASIS>Add more documentation here.</EMPHASIS>
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
243
doc/sgml/C/xacc-apar.sgml
Normal file
243
doc/sgml/C/xacc-apar.sgml
Normal file
@ -0,0 +1,243 @@
|
||||
|
||||
<ARTICLE ID="XACC-APAR">
|
||||
<ARTHEADER>
|
||||
<TITLE>Accounts Payable/Accounts Receivable</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1 ID="XACC-AP-AR">
|
||||
<TITLE> Accounts Payable and Accounts Receivable</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>A/R (Accounts Receivable) and A/P (Accounts Payable) are
|
||||
advanced concepts that are used by businesses to record sales
|
||||
for which they are not paid right away, or to record bills that
|
||||
they have received, but might not pay until a little while
|
||||
later.
|
||||
|
||||
</PARA>
|
||||
<PARA>These types of accounts are used primarily when you've got a
|
||||
lot of bills and receipts flowing in and out, and don't want to
|
||||
lose track of them just because you don't pay/get paid right
|
||||
away.
|
||||
|
||||
</PARA>
|
||||
<PARA>For almost all home users, A/R and A/P are too complicated
|
||||
and confusing to be worth the effort.
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-ARDEF">
|
||||
<TITLE> Accounts Receivable</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>First, let us examine A/R. After all, we really shouldn't
|
||||
really <EMPHASIS>need</EMPHASIS> to relate to A/P because we always pay
|
||||
<EMPHASIS>our</EMPHASIS> bills on time, don't we ? :-)
|
||||
|
||||
</PARA>
|
||||
<PARA>As a first approximation, let us assume we don't require
|
||||
customers to pay <EMPHASIS>instantly,</EMPHASIS> in cash, but rather issue
|
||||
them an invoice, and give them 30 days to pay the bills. (After
|
||||
30 days, we can start charging interest and sending out
|
||||
harassing letters :-)).
|
||||
|
||||
</PARA>
|
||||
<PARA>When we make a sale, the two accounts affected are <EMPHASIS> Sales</EMPHASIS> (an income account) and <EMPHASIS>Accounts Receivable.</EMPHASIS>
|
||||
Accounts Receivable is an asset, but it's not "liquid," as you
|
||||
can't readily sell it, and it's certainly not cash.
|
||||
|
||||
</PARA>
|
||||
<PARA>Then when they come by to pay their bill, dropping off a
|
||||
large sack of twenty-dollar bills (or, more likely, a
|
||||
check/cheque), we transfer the amount from A/R to Cash.
|
||||
|
||||
</PARA>
|
||||
<PARA>The reason we do this in two steps is that we have decided
|
||||
we need to do our accounting on an accrual basis and not on a
|
||||
cash basis, because most of our transactions are not solely
|
||||
based on cash changing hands, but rather based on <EMPHASIS> establishing obligations.</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
<PARA>In more sophisticated operations, there may be a much more
|
||||
complex sequence of documents generated and tracked:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>A customer sends in a <EMPHASIS>Purchase Order</EMPHASIS>, thus
|
||||
authorizing a purchase.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>We set up a <EMPHASIS>Work Order</EMPHASIS> to schedule production of
|
||||
whatever the customer is buying
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>We issue a <EMPHASIS>Shipping Notice</EMPHASIS>, to ship to goods to
|
||||
the customer
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Once shipped, we issue an <EMPHASIS>Invoice</EMPHASIS>, representing
|
||||
the <EMPHASIS>request to pay</EMPHASIS>
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
<PARA>The fact of there being four documents leads to there being
|
||||
considerable wads of paper, and having these and other such
|
||||
processes explains why large organizations tend to have hefty
|
||||
bureaucracies.
|
||||
|
||||
</PARA>
|
||||
<PARA>We report sales in our sales figures as soon as we make
|
||||
them. Unfortunately, we may wind up selling some product to
|
||||
no-good shady operators that we didn't know were shady, and
|
||||
thus may get stuck with some "bad debts."
|
||||
|
||||
</PARA>
|
||||
<PARA>In order to determine which parts of Accounts Receivable
|
||||
appear to be most at risk, it is typical to arrange AR based on
|
||||
the "ages" of the debts, commonly segmenting it into several
|
||||
aging periods, of payments outstanding 0-30 days, those that
|
||||
outstanding 31-60 days, 61-90 days, and then those that are
|
||||
<EMPHASIS>way overdue.</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
<PARA>At some point, it may become clear that a customer is never
|
||||
going to pay what they owe, and we have to write it off as a
|
||||
<EMPHASIS>Bad Debt.</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
<PARA>At that point, it is typical to record an entry thus:
|
||||
|
||||
<TABLE>
|
||||
<TITLE>Bad Debt Expense Example</TITLE>
|
||||
<TGROUP COLS="3">
|
||||
<THEAD>
|
||||
<ROW>
|
||||
<ENTRY>Account</ENTRY>
|
||||
<ENTRY>DR</ENTRY>
|
||||
<ENTRY>CR</ENTRY>
|
||||
</ROW>
|
||||
</THEAD>
|
||||
<TBODY>
|
||||
<ROW>
|
||||
<ENTRY>Bad Debt Expense</ENTRY>
|
||||
<ENTRY>$10,000</ENTRY>
|
||||
<ENTRY> </ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY> </ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Accounts Receivable</ENTRY>
|
||||
<ENTRY> </ENTRY>
|
||||
<ENTRY>$10,000</ENTRY>
|
||||
</ROW>
|
||||
</TBODY>
|
||||
</TGROUP>
|
||||
</TABLE>
|
||||
|
||||
</PARA>
|
||||
<PARA>We could have reduced <EMPHASIS>Sales Income</EMPHASIS> instead, but
|
||||
companies tend to prefer to specifically track the amount that
|
||||
they're losing to bad customers.
|
||||
|
||||
</PARA>
|
||||
<PARA><EMPHASIS>Warning: <EMPHASIS>Advanced Accounting Concept.</EMPHASIS> Bad Debt is
|
||||
an example of a "contra-account." That doesn't refer to <EMPHASIS> amounts paid to Nicaraguan rebels,</EMPHASIS> but rather the notion
|
||||
that the account is an income account that is expected to hold
|
||||
a balance opposite to what is normally expected, to be
|
||||
counteract the balance in another income account. <LINK LINKEND="XACC-DEPRECIATION">Accumulated Depreciation,</LINK> used to
|
||||
diminish the value of an asset over time, is another example of
|
||||
a contra-account.</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-AR">
|
||||
<TITLE> Accounts Payable</TITLE>
|
||||
<PARA>The scenario for Accounts Receivable, reversed, reflects how
|
||||
Accounts Payables work; just switch customer with supplier, and
|
||||
watch the roles reverse.
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>If we buy materials "on account," accrual accounting
|
||||
requires that we record that we incur the expense
|
||||
immediately, and rather than reducing cash, we put the
|
||||
"credit" into the <EMPHASIS>Accounts Payable</EMPHASIS> account.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Three weeks later, the invoice comes in, and we issue a
|
||||
payment, and so <EMPHASIS>Debit AP, Credit Cash.</EMPHASIS>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-PREPAIDEXPENSES">
|
||||
<TITLE> Prepaid Expenses</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>Analogous techniques are also used for expenses that are
|
||||
pre-paid.
|
||||
|
||||
</PARA>
|
||||
<PARA>If you have to pay out down six months of rent in advance,
|
||||
that is treated as an "accrued asset."
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> At the time of payment, you <EMPHASIS>Debit</EMPHASIS> <EMPHASIS>Prepaid
|
||||
Rent</EMPHASIS> for the amount paid that is a <EMPHASIS>Credit</EMPHASIS> to
|
||||
<EMPHASIS>Cash.</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
<PARA>While this puts an unfortunate dent in the Cash account,
|
||||
it <EMPHASIS>does</EMPHASIS> show on the books as an asset, and there
|
||||
are no more payments to make for the next six months.
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Each month, the balance in <EMPHASIS>Prepaid Rent</EMPHASIS> would be
|
||||
down via <EMPHASIS>Debit</EMPHASIS> <EMPHASIS>Rent Expense</EMPHASIS>, <EMPHASIS>Credit</EMPHASIS>
|
||||
<EMPHASIS>Prepaid Rent</EMPHASIS>.
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
<PARA>Similarly, companies collect payroll taxes on behalf of
|
||||
employees, and keep them in a special bank account.
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>That</EMPHASIS> money is not the company's, so there is a
|
||||
<EMPHASIS>Debit</EMPHASIS> to the <EMPHASIS>Cash</EMPHASIS> account on one side, and a
|
||||
<EMPHASIS>Credit</EMPHASIS> to an Accrued Liability, namely, <EMPHASIS>Payroll
|
||||
Taxes Payable</EMPHASIS>, on the other side.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>When the quarterly check to the Government so that they
|
||||
can make <EMPHASIS>their</EMPHASIS> payroll, <EMPHASIS>Payroll Taxes Payable</EMPHASIS>
|
||||
drops as does the balance in the <EMPHASIS>Checking Account</EMPHASIS>.
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
66
doc/sgml/C/xacc-balancereport.sgml
Normal file
66
doc/sgml/C/xacc-balancereport.sgml
Normal file
@ -0,0 +1,66 @@
|
||||
|
||||
<ARTICLE ID="XACC-BALANCEREPORT">
|
||||
<ARTHEADER>
|
||||
<TITLE>Balance Tracking Report</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Balance Tracking Report</TITLE>
|
||||
<PARA> <INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="report-av-baln.gif> <p>This report allows you to track the balance of an account over time. If you have gnuplot installed, it can even produce graphical output:</p> <img src=">
|
||||
</IMAGEOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
|
||||
|
||||
</PARA>
|
||||
<PARA>Parameters for this report include:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>The start and end dates of the accounting period.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>The length of each "step", or interval in the account
|
||||
period.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>The accounts for which the report is to be produced. If
|
||||
more than one account is selected, the sum of all balances of
|
||||
accounts selected is used <EMPHASIS>NB: Could somebody make sure
|
||||
this is right?</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Which aspect of the report is to be graphed. There are
|
||||
three graphs available:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Average Balance during interval
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Net Gain/Loss over interval
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Gains and losses over interval
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
25
doc/sgml/C/xacc-balancesheet.sgml
Normal file
25
doc/sgml/C/xacc-balancesheet.sgml
Normal file
@ -0,0 +1,25 @@
|
||||
|
||||
<ARTICLE ID="XACC-BALANCESHEET">
|
||||
<ARTHEADER>
|
||||
<TITLE>Balance Sheet</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Balance Sheet</TITLE>
|
||||
<PARA> <INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="report-baln.gif">
|
||||
</IMAGEOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
|
||||
</PARA>
|
||||
<PARA>This report summarizes your assets, liabilities, and
|
||||
equity.
|
||||
|
||||
</PARA>
|
||||
<PARA>You can select the date for which the balance sheet is to be
|
||||
calculated up to using the "preferences" toolbar button. The
|
||||
default is today.
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
640
doc/sgml/C/xacc-chartofaccts.sgml
Normal file
640
doc/sgml/C/xacc-chartofaccts.sgml
Normal file
@ -0,0 +1,640 @@
|
||||
|
||||
<ARTICLE ID="XACC-CHARTOFACCTS">
|
||||
<ARTHEADER>
|
||||
<TITLE>Chart of Accounts and Account Numbering</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Chart of Accounts</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>Typically accounts are arranged as a tree, in hierarchical
|
||||
form.
|
||||
|
||||
</PARA>
|
||||
<PARA>The main branches represent entire categories or groups,
|
||||
while the leaves of the tree denote individual bank accounts or
|
||||
expense categories.
|
||||
|
||||
</PARA>
|
||||
<PARA>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:
|
||||
<LITERAL REMAP="TT"><MSGTEXT>
|
||||
<LITERALLAYOUT> 300 Expenses
|
||||
|
|
||||
+--310 Living Expenses
|
||||
| |
|
||||
| +--311 Beer
|
||||
| |
|
||||
| +--312 Cable
|
||||
|
|
||||
+--320 Business Expenses
|
||||
| |
|
||||
| +--321 8-inch Floppies
|
||||
| |
|
||||
: :</LITERALLAYOUT>
|
||||
</MSGTEXT></LITERAL>
|
||||
|
||||
</PARA>
|
||||
<PARA>Note that accounts not only have names; they have <EMPHASIS> codes,</EMPHASIS> in order to provide <EMPHASIS>order.</EMPHASIS> When a report is
|
||||
generated, the <ANCHOR ID="SORTORDER">sort order is determined by
|
||||
the numbering.
|
||||
|
||||
</PARA>
|
||||
<PARA>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:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> Overall Assets: <SCREEN>100</SCREEN>
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> Overall Cash: <SCREEN>110</SCREEN>
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Cash in Wallet: <SCREEN>111</SCREEN>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Cash in Sock in Closet: <SCREEN>112</SCREEN>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Cash in Mattress: <SCREEN>113</SCREEN>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Petty Cash Box: <SCREEN>114</SCREEN>
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Overall Banking Assets <SCREEN>120</SCREEN>
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Checking Account <SCREEN>121</SCREEN>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Savings Account <SCREEN>122</SCREEN>
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
<PARA>When you <LINK LINKEND="XACC-NEWACCTWIN">create a new
|
||||
account</LINK>, 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
|
||||
encourage you to avoid this. Account codes are treated as
|
||||
numbers in base-36, thus, if you run out of numbers, you
|
||||
can use the letters, <KEYSYM>a</KEYSYM> through <KEYSYM>z</KEYSYM>.</PARA>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-SAMPLECHART">
|
||||
<TITLE> A Sample Chart of Accounts</TITLE>
|
||||
<PARA>A "typical" chart of accounts is shown below. Each
|
||||
account is of a given <LINK LINKEND="XACC-ACCTYPES">account
|
||||
type</LINK>. This example is a combination of some typical
|
||||
business and personal accounts.
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> Assets
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> Cash On Hand
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Checking account
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Money Market Account
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Certificate of Deposit
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Fixed Assets
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Furniture
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Computers
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Jewelry, Collectibles
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Tools, Machinery
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Investments
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Stocks
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Bonds
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Mutual Funds
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Real Estate
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Liabilities
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> Taxes
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Federal Income Tax
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Social Security
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Medicare
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>FUTA
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>State Income Tax
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Accounts Payable
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>MasterCard
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Visa
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>American Express
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Diner's Club
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Loans
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Debentures
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>School Loan
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Uncle Harry's Tide-me-over
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Equity
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Retained Earnings
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Current Year Earnings
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Historical Adjustments
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Income
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> Interest Income
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Bank Account Interest
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Certificate of Deposit
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Bond Interest
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Dividends
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Stock
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Mutual Fund
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Consulting
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>ABC Design
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>PQR Infomatics
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Salary
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>My Day Job
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Commissions
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Royalties
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Expenses
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> Rent and Utilities
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Rent
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Rent Late Fees
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Electricity
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Gas
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Phone
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Internet
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Cable TV
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Office Expenses
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Accounting
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Legal
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Software
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Postage
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Bank Charges
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Credit Card Charges
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Toner, Paper, Paper Clips
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Auto Expenses
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Gas
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Insurance
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Repair
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Rental
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Taxes
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Social Security
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Unemployment
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>IRS penalties
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Wages and Salaries
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Consulting
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Wages
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Health Insurance
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Travel
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Air
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Hotel
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Meals
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Auto
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Marketing
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Advertising
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Trade Shows
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Give Aways
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
841
doc/sgml/C/xacc-currencyhandling.sgml
Normal file
841
doc/sgml/C/xacc-currencyhandling.sgml
Normal file
@ -0,0 +1,841 @@
|
||||
|
||||
<ARTICLE ID="XACC-CURRENCYHANDLING">
|
||||
<ARTHEADER>
|
||||
<TITLE></TITLE>
|
||||
<TITLE>Currency Handling and Double Entry Bookkeeping</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Currency Handling and Double Entry Bookkeeping</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>A <LINK LINKEND="DOUBLE">Double Entry bookkeeping
|
||||
system</LINK> stores both values, and requires that all
|
||||
transactions balance, as described in the <LINK LINKEND="IDENTITY">Double Entry Identity.</LINK>
|
||||
|
||||
</PARA>
|
||||
<PARA>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:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>value=exch-rate*amount</EMPHASIS> (for currency
|
||||
accounts)
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>value=price*num-shares</EMPHASIS> (for
|
||||
stocks/mutual-funds)
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
<PARA>Thus, buying a widget in Japan (JPY) and using US Dollars
|
||||
(USD) to pay for it would appear thus:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> <EMPHASIS><EMPHASIS>SpendAcct:</EMPHASIS> (an ordinary bank/cash acct valued in
|
||||
USD)</EMPHASIS>
|
||||
<LITERAL REMAP="TT"><MSGTEXT>
|
||||
<LITERALLAYOUT><EMPHASIS>Date xfer from memo cost
|
||||
1/5/99 [JPYAcct] Buy widget $1.00</EMPHASIS></LITERALLAYOUT>
|
||||
</MSGTEXT></LITERAL>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> <EMPHASIS><EMPHASIS>JPYAcct</EMPHASIS>: (a currency trading account valued in
|
||||
yen)</EMPHASIS>
|
||||
<LITERAL REMAP="TT"><MSGTEXT>
|
||||
<LITERALLAYOUT><EMPHASIS>Date xfer from memo purchase rate
|
||||
1/5/99 [SpendAcct] Buy widget Y150 0.00667</EMPHASIS></LITERALLAYOUT>
|
||||
</MSGTEXT></LITERAL>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
<PARA>The engine links together all three of these values <ENVAR> (1.0, 150, 0.00667)</ENVAR> permanently and makes it impossible to
|
||||
change one without changing another, so that the grand total is
|
||||
always zero, thereby guaranteeing satisfaction of the <LINK LINKEND="IDENTITY">double entry accounting
|
||||
identity.</LINK>
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-ISOCURR">
|
||||
<TITLE> ISO Currency Codes</TITLE>
|
||||
<PARA>More currencies than you thought possible...
|
||||
|
||||
<TABLE>
|
||||
<TITLE>ISO Currency Codes</TITLE>
|
||||
<TGROUP COLS="2">
|
||||
<THEAD>
|
||||
<ROW>
|
||||
<ENTRY>ISO Code</ENTRY>
|
||||
<ENTRY>Full Description</ENTRY>
|
||||
</ROW>
|
||||
</THEAD>
|
||||
<TBODY>
|
||||
<ROW>
|
||||
<ENTRY> </ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>ADP</ENTRY>
|
||||
<ENTRY>Andoran peseta</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>AED</ENTRY>
|
||||
<ENTRY>United Arab Emirates Dirham</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>AFA</ENTRY>
|
||||
<ENTRY>Afghani</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>ALL</ENTRY>
|
||||
<ENTRY>Albanian Lek</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>AMD</ENTRY>
|
||||
<ENTRY>Armenian Dram</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>ANG</ENTRY>
|
||||
<ENTRY>West Indian Guilder</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>AOK</ENTRY>
|
||||
<ENTRY>Angolan Kwanza</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>ARA</ENTRY>
|
||||
<ENTRY>Argentinian Austral</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>ARS</ENTRY>
|
||||
<ENTRY>Argentina Peso</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>ATS</ENTRY>
|
||||
<ENTRY>Austrian Schilling</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>AUD</ENTRY>
|
||||
<ENTRY>Australian Dollar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>AWG</ENTRY>
|
||||
<ENTRY>Aruban Guilder</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>AZM</ENTRY>
|
||||
<ENTRY>Azerbaijan Manat</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>BAD</ENTRY>
|
||||
<ENTRY>Bosnia-Herzogovinian Dinar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>BBD</ENTRY>
|
||||
<ENTRY>Barbados Dollar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>BDT</ENTRY>
|
||||
<ENTRY>Bangladesh Taka</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>BEF</ENTRY>
|
||||
<ENTRY>Belgian Franc</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>BGL</ENTRY>
|
||||
<ENTRY>Bulgarian Lev</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>BHD</ENTRY>
|
||||
<ENTRY>Bahrain Dinar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>BIF</ENTRY>
|
||||
<ENTRY>Burundi Franc</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>BMD</ENTRY>
|
||||
<ENTRY>Bermudan Dollar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>BND</ENTRY>
|
||||
<ENTRY>Brunei Dollar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>BOB</ENTRY>
|
||||
<ENTRY>Bolivian Boliviano</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>BRL</ENTRY>
|
||||
<ENTRY>Brazilian Real</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>BRR</ENTRY>
|
||||
<ENTRY>Brazil</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>BSD</ENTRY>
|
||||
<ENTRY>Bahaman Dollar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>BWP</ENTRY>
|
||||
<ENTRY>Botswana Pula</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>BYR</ENTRY>
|
||||
<ENTRY>Belorussian Ruble</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>BZD</ENTRY>
|
||||
<ENTRY>Belize Dollar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>CAD</ENTRY>
|
||||
<ENTRY>Canadian Dollar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>CDP</ENTRY>
|
||||
<ENTRY>Santo Domiongo</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>CHF</ENTRY>
|
||||
<ENTRY>Swiss Franc</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>CLP</ENTRY>
|
||||
<ENTRY>CHILEAN PESO</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>CNY</ENTRY>
|
||||
<ENTRY>China</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>COP</ENTRY>
|
||||
<ENTRY>Colombian Peso</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>CRC</ENTRY>
|
||||
<ENTRY>Costa Rica Colon</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>CUP</ENTRY>
|
||||
<ENTRY>Cuban Peso</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>CVE</ENTRY>
|
||||
<ENTRY>Cape Verde Escudo</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>CYP</ENTRY>
|
||||
<ENTRY>Cyprus Pound</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>CZK</ENTRY>
|
||||
<ENTRY>Czech Krona</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>DEM</ENTRY>
|
||||
<ENTRY>German Mark</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>DJF</ENTRY>
|
||||
<ENTRY>Djibouti Franc</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>DKK</ENTRY>
|
||||
<ENTRY>Danish Krone</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>DOP</ENTRY>
|
||||
<ENTRY>Dominican Peso</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>DRP</ENTRY>
|
||||
<ENTRY>Dominican Republic Peso</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>DZD</ENTRY>
|
||||
<ENTRY>Algerian Dinar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>ECS</ENTRY>
|
||||
<ENTRY>ECUADORIAN SUCRE</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>ECS</ENTRY>
|
||||
<ENTRY>Ecuador Sucre</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>ECU</ENTRY>
|
||||
<ENTRY>European Currency Unit</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>EEK</ENTRY>
|
||||
<ENTRY>Estonian Krone</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>EGP</ENTRY>
|
||||
<ENTRY>Egyptian Pound</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>ESP</ENTRY>
|
||||
<ENTRY>Spanish Peseta</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>ETB</ENTRY>
|
||||
<ENTRY>Ethiopian Birr</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>EUR</ENTRY>
|
||||
<ENTRY>Currency of EMU member states</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>FIM</ENTRY>
|
||||
<ENTRY>Finnish Mark</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>FJD</ENTRY>
|
||||
<ENTRY>Fiji Dollar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>FKP</ENTRY>
|
||||
<ENTRY>Falkland Pound</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>FRF</ENTRY>
|
||||
<ENTRY>French Franc</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>GBP</ENTRY>
|
||||
<ENTRY>British Pound</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>GEK</ENTRY>
|
||||
<ENTRY>Georgian Kupon</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>GHC</ENTRY>
|
||||
<ENTRY>Ghanian Cedi</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>GIP</ENTRY>
|
||||
<ENTRY>Gibraltar Pound</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>GMD</ENTRY>
|
||||
<ENTRY>Gambian Dalasi</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>GNF</ENTRY>
|
||||
<ENTRY>Guinea Franc</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>GRD</ENTRY>
|
||||
<ENTRY>Greek Drachma</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>GTQ</ENTRY>
|
||||
<ENTRY>Guatemalan Quedzal</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>GWP</ENTRY>
|
||||
<ENTRY>Guinea Peso</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>GYD</ENTRY>
|
||||
<ENTRY>Guyanese Dollar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>HKD</ENTRY>
|
||||
<ENTRY>Hong Kong Dollar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>HNL</ENTRY>
|
||||
<ENTRY>Honduran Lempira</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>HRD</ENTRY>
|
||||
<ENTRY>Croatian Dinar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>HTG</ENTRY>
|
||||
<ENTRY>Haitian Gourde</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>HUF</ENTRY>
|
||||
<ENTRY>Hungarian forint</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>IDR</ENTRY>
|
||||
<ENTRY>Indeonesian Rupiah</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>IEP</ENTRY>
|
||||
<ENTRY>Irish Pound</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>ILS</ENTRY>
|
||||
<ENTRY>Israeli Scheckel</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>INR</ENTRY>
|
||||
<ENTRY>Indian Rupee</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>IQD</ENTRY>
|
||||
<ENTRY>Iraqui Dinar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>IRR</ENTRY>
|
||||
<ENTRY>Iranian Rial</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>ISK</ENTRY>
|
||||
<ENTRY>Iceland Krona</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>ITL</ENTRY>
|
||||
<ENTRY>Italian Lira</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>JMD</ENTRY>
|
||||
<ENTRY>JAMAICAN DOLLAR</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>JOD</ENTRY>
|
||||
<ENTRY>Jordanian Dinar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>JPY</ENTRY>
|
||||
<ENTRY>Japanese Yen</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>KES</ENTRY>
|
||||
<ENTRY>Kenyan Shilling</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>KHR</ENTRY>
|
||||
<ENTRY>Cambodian Riel</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>KIS</ENTRY>
|
||||
<ENTRY>Kirghizstan Som</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>KMF</ENTRY>
|
||||
<ENTRY>Comoros Franc</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>KPW</ENTRY>
|
||||
<ENTRY>North Korean Won</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>KRW</ENTRY>
|
||||
<ENTRY>South Korean Won</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>KWD</ENTRY>
|
||||
<ENTRY>Kuwaiti Dinar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>KYD</ENTRY>
|
||||
<ENTRY>Cayman Dollar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>KZT</ENTRY>
|
||||
<ENTRY>Kazakhstani Tenge</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>LAK</ENTRY>
|
||||
<ENTRY>Laotian Kip</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>LBP</ENTRY>
|
||||
<ENTRY>Lebanese Pound</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>LKR</ENTRY>
|
||||
<ENTRY>Sri Lankan Rupee</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>LRD</ENTRY>
|
||||
<ENTRY>Liberian Dollar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>LSL</ENTRY>
|
||||
<ENTRY>Lesotho Loti</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>LTL</ENTRY>
|
||||
<ENTRY>Lithuanian Lita</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>LUF</ENTRY>
|
||||
<ENTRY>Luxembourgian Franc</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>LVL</ENTRY>
|
||||
<ENTRY>Latvian Lat</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>LYD</ENTRY>
|
||||
<ENTRY>Libyan Dinar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>MAD</ENTRY>
|
||||
<ENTRY>Moroccan Dirham</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>MDL</ENTRY>
|
||||
<ENTRY>Moldavian Lei</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>MGF</ENTRY>
|
||||
<ENTRY>Madagascan Franc</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>MNC</ENTRY>
|
||||
<ENTRY>Monaco</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>MNT</ENTRY>
|
||||
<ENTRY>Mongolian Tugrik</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>MOP</ENTRY>
|
||||
<ENTRY>Macao Pataca</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>MRO</ENTRY>
|
||||
<ENTRY>Mauritanian Ouguiya</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>MTL</ENTRY>
|
||||
<ENTRY>Maltese Lira</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>MUR</ENTRY>
|
||||
<ENTRY>Mauritius Rupee</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>MVR</ENTRY>
|
||||
<ENTRY>Maldive Rufiyaa</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>MWK</ENTRY>
|
||||
<ENTRY>Malawi Kwacha</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>MXN</ENTRY>
|
||||
<ENTRY>Mexican Peso (new)</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>MXP</ENTRY>
|
||||
<ENTRY>Mexican Peso (old)</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>MYR</ENTRY>
|
||||
<ENTRY>Malaysian Ringgit</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>MZM</ENTRY>
|
||||
<ENTRY>Mozambique Metical</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>NGN</ENTRY>
|
||||
<ENTRY>Nigerian Naira</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>NIC</ENTRY>
|
||||
<ENTRY>Nicaragua</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>NIO</ENTRY>
|
||||
<ENTRY>Nicaraguan Cordoba</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>NIS</ENTRY>
|
||||
<ENTRY>Isreal</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>NLG</ENTRY>
|
||||
<ENTRY>Dutch Guilder</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>NOK</ENTRY>
|
||||
<ENTRY>Norwegian Krone</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>NPR</ENTRY>
|
||||
<ENTRY>Nepalese Rupee</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>NZD</ENTRY>
|
||||
<ENTRY>New Zealand Dollars</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>OMR</ENTRY>
|
||||
<ENTRY>Omani Rial</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>PAB</ENTRY>
|
||||
<ENTRY>Panamanian Balboa</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>PEI</ENTRY>
|
||||
<ENTRY>Peruvian Inti</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>PEN</ENTRY>
|
||||
<ENTRY>Peruvian Sol - New</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>PES</ENTRY>
|
||||
<ENTRY>Peruvian Sol</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>PGK</ENTRY>
|
||||
<ENTRY>Papua New Guinea Kina</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>PHP</ENTRY>
|
||||
<ENTRY>Philippino Peso</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>PKR</ENTRY>
|
||||
<ENTRY>Pakistan Rupee</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>PLN</ENTRY>
|
||||
<ENTRY>Polish Zloty</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>PLZ</ENTRY>
|
||||
<ENTRY>Poland</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>PTE</ENTRY>
|
||||
<ENTRY>Portuguese Escudo</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>PYG</ENTRY>
|
||||
<ENTRY>Paraguayan Guarani</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>QAR</ENTRY>
|
||||
<ENTRY>Qatar Riyal</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>RMB</ENTRY>
|
||||
<ENTRY>Chinese Renminbi Yuan</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>ROL</ENTRY>
|
||||
<ENTRY>Roumanian Lei</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>RUR</ENTRY>
|
||||
<ENTRY>Russian Rouble</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>RWF</ENTRY>
|
||||
<ENTRY>Rwanda Franc</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>SAR</ENTRY>
|
||||
<ENTRY>Saudi Riyal</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>SBD</ENTRY>
|
||||
<ENTRY>Solomon Islands Dollar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>SCR</ENTRY>
|
||||
<ENTRY>Seychelles Rupee</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>SDP</ENTRY>
|
||||
<ENTRY>Sudanese Pound</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>SEK</ENTRY>
|
||||
<ENTRY>Swedish Krona</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>SGD</ENTRY>
|
||||
<ENTRY>Singapore Dollar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>SHP</ENTRY>
|
||||
<ENTRY>St.Helena Pound</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>SIT</ENTRY>
|
||||
<ENTRY>Slovenian Tolar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>SKK</ENTRY>
|
||||
<ENTRY>Slovakian Krona</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>SLL</ENTRY>
|
||||
<ENTRY>Leone</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>SOL</ENTRY>
|
||||
<ENTRY>Peru</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>SOS</ENTRY>
|
||||
<ENTRY>Somalian Shilling</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>SRG</ENTRY>
|
||||
<ENTRY>Surinam Guilder</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>STD</ENTRY>
|
||||
<ENTRY>Sao Tome / Principe Dobra</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>SUR</ENTRY>
|
||||
<ENTRY>Russian Ruble (old)</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>SVC</ENTRY>
|
||||
<ENTRY>El Salvador Colon</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>SYP</ENTRY>
|
||||
<ENTRY>Syrian Pound</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>SZL</ENTRY>
|
||||
<ENTRY>Swaziland Lilangeni</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>THB</ENTRY>
|
||||
<ENTRY>Thailand Baht</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>TJR</ENTRY>
|
||||
<ENTRY>Tadzhikistani Ruble</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>TMM</ENTRY>
|
||||
<ENTRY>Turkmenistani Manat</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>TND</ENTRY>
|
||||
<ENTRY>Tunisian Dinar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>TOP</ENTRY>
|
||||
<ENTRY>Tongan Pa'anga</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>TPE</ENTRY>
|
||||
<ENTRY>Timor Escudo</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>TRL</ENTRY>
|
||||
<ENTRY>Turkish Lira</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>TTD</ENTRY>
|
||||
<ENTRY>Trinidad and Tobago Dollar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>TWD</ENTRY>
|
||||
<ENTRY>New Taiwan Dollar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>TZS</ENTRY>
|
||||
<ENTRY>Tanzanian Shilling</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>UAK</ENTRY>
|
||||
<ENTRY>Ukrainian Karbowanez</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>UGS</ENTRY>
|
||||
<ENTRY>Ugandan Shilling</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>USD</ENTRY>
|
||||
<ENTRY>American Dollar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>UYP</ENTRY>
|
||||
<ENTRY>Uruguayan New Peso</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>UYU</ENTRY>
|
||||
<ENTRY>Uruguay</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>VEB</ENTRY>
|
||||
<ENTRY>Venezuelan Bolivar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>VND</ENTRY>
|
||||
<ENTRY>Vietnamese Dong</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>VUV</ENTRY>
|
||||
<ENTRY>Vanuatu Vatu</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>WST</ENTRY>
|
||||
<ENTRY>Samoan Tala</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>XAF</ENTRY>
|
||||
<ENTRY>Gabon C.f.A Franc</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>XCD</ENTRY>
|
||||
<ENTRY>East Carribean Dollar</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>XOF</ENTRY>
|
||||
<ENTRY>Benin C.f.A. Franc</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>YER</ENTRY>
|
||||
<ENTRY>Yemeni Ryal</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>ZAR</ENTRY>
|
||||
<ENTRY>South African Rand</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>ZMK</ENTRY>
|
||||
<ENTRY>Zambian Kwacha</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>ZRZ</ENTRY>
|
||||
<ENTRY>Zaire</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>ZWD</ENTRY>
|
||||
<ENTRY>Zimbabwean Dollar</ENTRY>
|
||||
</ROW>
|
||||
</TBODY>
|
||||
</TGROUP>
|
||||
</TABLE>
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
66
doc/sgml/C/xacc-dateinput.sgml
Normal file
66
doc/sgml/C/xacc-dateinput.sgml
Normal file
@ -0,0 +1,66 @@
|
||||
|
||||
<ARTICLE ID="XACC-DATEINPUT">
|
||||
<ARTHEADER>
|
||||
<TITLE></TITLE>
|
||||
<TITLE>Date Data Input</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Date Input</TITLE>
|
||||
<PARA> The date cell handles the following accelerator keys:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA><KEYSYM>+, =</KEYSYM> increment day
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><KEYSYM>_ , -</KEYSYM> decrement day
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><KEYSYM>} , ]</KEYSYM> increment month
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><KEYSYM>{ , [</KEYSYM> decrement month
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><KEYSYM>M , m</KEYSYM> beginning of month
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><KEYSYM>H , h</KEYSYM> end of month
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><KEYSYM>Y , y</KEYSYM> beginning of year
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><KEYSYM>R , r</KEYSYM> end of year
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><KEYSYM>T , t</KEYSYM> today
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
<PARA>GnuCash can be configured to use a variety of date input
|
||||
formats by <LINK LINKEND="USERPREF">setting a
|
||||
preference</LINK>.
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
819
doc/sgml/C/xacc-depreciation.sgml
Normal file
819
doc/sgml/C/xacc-depreciation.sgml
Normal file
@ -0,0 +1,819 @@
|
||||
|
||||
<ARTICLE ID="XACC-DEPRECIATION">
|
||||
<ARTHEADER>
|
||||
<TITLE>Depreciation and Capital Gains</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Depreciation and Capital Gains</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>This section provides a treatment of the handling of
|
||||
depreciation and appreciation of assets in GnuCash.
|
||||
|
||||
</PARA>
|
||||
<PARA>It also provides a brief introduction to the related tax
|
||||
issues.
|
||||
|
||||
</PARA>
|
||||
<PARA><EMPHASIS>Warning:</EMPHASIS> <EMPHASIS>Be aware that different countries can
|
||||
have <EMPHASIS>substantially</EMPHASIS> different tax policies for handling
|
||||
these things; all that this document can really provide is some
|
||||
of the underlying ideas to help you apply your "favorite"
|
||||
tax/depreciation policies.</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
<PARA>Note that appreciation and depreciation of assets tend to be
|
||||
treated somewhat differently:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> <LINK LINKEND="XACC-DEPRECIATION">Depreciation</LINK> is <EMPHASIS>usually</EMPHASIS>
|
||||
recognized (the technical term is <EMPHASIS>accrued</EMPHASIS>) as an
|
||||
expense on an ongoing basis, gradually reducing the value
|
||||
of an asset towards zero.
|
||||
|
||||
</PARA>
|
||||
<PARA>Depreciation tends to only get calculated on assets that
|
||||
are used for professional or business purposes, because
|
||||
governments don't generally allow you to claim depreciation
|
||||
deductions on personal assets, and it's pointless to bother
|
||||
with the procedure if it's not deductible.
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> In contrast, <LINK LINKEND="APPR">Capital Gains,</LINK> which could
|
||||
be called <EMPHASIS>asset value appreciation,</EMPHASIS> are typically
|
||||
<EMPHASIS>not</EMPHASIS> recognized until some time down the road when
|
||||
the asset is sold, and at that <EMPHASIS>instant,</EMPHASIS> the entire
|
||||
gain becomes income.
|
||||
|
||||
</PARA>
|
||||
<PARA>Unlike depreciation, governments tend to be <EMPHASIS>quite
|
||||
interested</EMPHASIS> in taxing capital gains in one manner or
|
||||
another.
|
||||
|
||||
</PARA>
|
||||
<PARA>(As always, there are exceptions. If you hold a bond
|
||||
that pays all of its interest at maturity, tax authorities
|
||||
will often require that you recognize interest each year,
|
||||
and refuse this to be treated as a capital gain. The
|
||||
phrases <EMPHASIS>accrued interest,</EMPHASIS> or <EMPHASIS>imputed
|
||||
interest</EMPHASIS> are often there to scare those that are
|
||||
sensitive to such things...)
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-CAPITALGAINS">
|
||||
<TITLE> Capital Gains - Asset Appreciation</TITLE>
|
||||
<PARA> <ANCHOR ID="APPR">
|
||||
|
||||
</PARA>
|
||||
<PARA>Appreciation of assets is, in general, a fairly tricky
|
||||
matter to deal with. This is so because, for some sorts of
|
||||
assets, it is difficult to correctly estimate an increase in
|
||||
value <EMPHASIS>until you actually sell the asset.</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
<PARA>If you invest in <LINK LINKEND="XACC-TICKER">securities</LINK>
|
||||
that are traded on a daily basis on open markets such as stock
|
||||
exchanges, prices may be quite exact, and selling the asset at
|
||||
market prices may be as simple as calling a broker and issuing
|
||||
a <EMPHASIS>Market Order.</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
<PARA>On the other hand, homes in your neighborhood are sold
|
||||
somewhat less often, such sales tend to involve expending
|
||||
considerable effort, and involve negotiations, which means that
|
||||
estimates are likely to be less precise. Similarly, selling a
|
||||
used automobile involves a negotiation process that makes
|
||||
pricing a bit less predictable.
|
||||
|
||||
</PARA>
|
||||
<PARA>Harder to estimate are values of collectible objects such as
|
||||
jewelry, works of art, baseball cards, and "Beanie Babies." The
|
||||
markets for such objects are somewhat less open than the
|
||||
securities markets.
|
||||
|
||||
</PARA>
|
||||
<PARA>Worse still are one-of-a-kind assets. Factories often
|
||||
contain presses and dies customized to build a very specific
|
||||
product that cost tens or hundreds of thousands of dollars;
|
||||
this equipment may be <EMPHASIS>worthless</EMPHASIS> outside of that very
|
||||
specific context. In such cases, there several conflicting
|
||||
values might be attached to the asset, <EMPHASIS>none</EMPHASIS> of them
|
||||
unambiguously correct.
|
||||
|
||||
</PARA>
|
||||
<PARA>Let's suppose you buy an asset expected to increase in
|
||||
value, say a Degas painting, and want to track this. (The
|
||||
insurance company will care about this, even if nobody else
|
||||
does.)
|
||||
|
||||
</PARA>
|
||||
<PARA>Properly tracking the continually-increasing value of the
|
||||
Degas will require at least three, quite possibly the following
|
||||
four accounts (plus a bank or cash account where the money for
|
||||
the purchase comes from):
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>An <EMPHASIS>Asset Cost</EMPHASIS> asset account to track the
|
||||
original cost of the painting,
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>An <EMPHASIS>Accrued Unrealized Gains on Asset</EMPHASIS> asset
|
||||
account to keep track of increases in value, and
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>An <EMPHASIS>Accrued Gain On Asset Income</EMPHASIS> income account
|
||||
in which to record the income side of the annual gains in
|
||||
your riches, and
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>A <EMPHASIS>Realized Gain On Asset Income</EMPHASIS> income account
|
||||
in which to record the realized income when you sell the
|
||||
asset.
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
<PARA>The <EMPHASIS>accrued gains</EMPHASIS> likely won't affect your taxable
|
||||
income for <EMPHASIS>income</EMPHASIS> tax purposes, although it could have
|
||||
some effect on <EMPHASIS>property</EMPHASIS> taxes.
|
||||
|
||||
</PARA>
|
||||
<SECT2>
|
||||
<TITLE>The handling of capital gains in GnuCash</TITLE>
|
||||
<PARA> </PARA>
|
||||
<SECT3>
|
||||
<TITLE>The Acquisition</TITLE>
|
||||
<PARA>The first thing you have to do is to create the <EMPHASIS>asset
|
||||
cost account</EMPHASIS>, then transfer the sum you paid for this
|
||||
painting from your bank account to this asset account to record
|
||||
the purchase.
|
||||
|
||||
</PARA>
|
||||
<PARA>A month later, you have reason to suspect that the value of
|
||||
your painting has increased by $1200. In order to record this
|
||||
you transfer $1200 from your <EMPHASIS>accrued gains on asset</EMPHASIS>
|
||||
income account to your asset account.
|
||||
|
||||
</PARA>
|
||||
<PARA>Your main window will resemble this:
|
||||
<INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="appr-main1.gif">
|
||||
</IMAGEOBJECT>
|
||||
<TEXTOBJECT>
|
||||
<PHRASE>Main window after purchase and appreciation</PHRASE>
|
||||
</TEXTOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
|
||||
</PARA>
|
||||
<PARA>and your asset account will resemble this:
|
||||
<INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="appr-asset1.gif">
|
||||
</IMAGEOBJECT>
|
||||
<TEXTOBJECT>
|
||||
<PHRASE>Asset account after purchase and appreciation</PHRASE>
|
||||
</TEXTOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
|
||||
</PARA>
|
||||
</SECT3>
|
||||
<SECT3>
|
||||
<TITLE>While You Hold the Asset</TITLE>
|
||||
<PARA>Asset appreciation is a sort of income but it is <EMPHASIS> not</EMPHASIS> cash in hand.
|
||||
|
||||
</PARA>
|
||||
<PARA>The people that got "rich" in 1999 from IPOs of
|
||||
Linux-related companies like Red Hat Software and VA Linux
|
||||
Systems could verify this. They hold options or stock that are
|
||||
<EMPHASIS>theoretically</EMPHASIS> valued at millions of dollars USD.
|
||||
|
||||
</PARA>
|
||||
<PARA>That doesn't mean that they are actually millionaires; the
|
||||
principal participants have to hold their stock for at least
|
||||
six months before selling <EMPHASIS>any</EMPHASIS> of it. The fact that
|
||||
they <EMPHASIS>can't</EMPHASIS> sell it means that while it may in theory
|
||||
be worth millions of dollars on paper, there is, as of late
|
||||
1999, no way for them to legally <EMPHASIS>get</EMPHASIS> those
|
||||
millions.
|
||||
|
||||
</PARA>
|
||||
</SECT3>
|
||||
<SECT3>
|
||||
<TITLE>Selling the Asset</TITLE>
|
||||
<PARA>Let´s say another month later prices for Degas
|
||||
paintings have gone up some more, in your case about $2500, you
|
||||
estimate. You duly record these $2500 as an income like above,
|
||||
then decide to sell the painting.
|
||||
|
||||
</PARA>
|
||||
<PARA>Now there arise three possibilities:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> Your optimistic estimate of the painting's value was
|
||||
correct.
|
||||
|
||||
</PARA>
|
||||
<PARA>The income account is left alone (or perhaps gets
|
||||
transferred from an <EMPHASIS>Accrued Gain</EMPHASIS> income to a <EMPHASIS> Realized Gain</EMPHASIS> income account), and the recording is
|
||||
rather like:
|
||||
|
||||
<TABLE>
|
||||
<TITLE>Turning an Accrued Gain into a Realized Gain</TITLE>
|
||||
<TGROUP COLS="2">
|
||||
<THEAD>
|
||||
<ROW>
|
||||
<ENTRY>Account</ENTRY>
|
||||
<ENTRY>Amount</ENTRY>
|
||||
</ROW>
|
||||
</THEAD>
|
||||
<TBODY>
|
||||
<ROW>
|
||||
<ENTRY>Cash</ENTRY>
|
||||
<ENTRY>$16055</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Painting</ENTRY>
|
||||
<ENTRY>-$11000</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Realized Gain Income</ENTRY>
|
||||
<ENTRY>-$5055</ENTRY>
|
||||
</ROW>
|
||||
</TBODY>
|
||||
</TGROUP>
|
||||
</TABLE>
|
||||
|
||||
</PARA>
|
||||
<PARA>And if any amounts had been accrued as <EMPHASIS>Accrued
|
||||
Gains,</EMPHASIS> the asset amount should be closed out, offset
|
||||
by a <EMPHASIS>negative</EMPHASIS> value for <EMPHASIS>Accrued Gain</EMPHASIS>
|
||||
income. If the total that had been accrued was $5000, then
|
||||
the transaction might look like the following:
|
||||
|
||||
<TABLE>
|
||||
<TITLE>Accrued Gain becomes Realized Loss</TITLE>
|
||||
<TGROUP COLS="2">
|
||||
<THEAD>
|
||||
<ROW>
|
||||
<ENTRY>Account</ENTRY>
|
||||
<ENTRY>Amount</ENTRY>
|
||||
</ROW>
|
||||
</THEAD>
|
||||
<TBODY>
|
||||
<ROW>
|
||||
<ENTRY>Cash</ENTRY>
|
||||
<ENTRY>$16055</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Painting</ENTRY>
|
||||
<ENTRY>-$11000</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Accrued Gain Asset</ENTRY>
|
||||
<ENTRY>-$5000</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Realized Gain Income</ENTRY>
|
||||
<ENTRY>-$5055</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Accrued Gain Income</ENTRY>
|
||||
<ENTRY>$5000</ENTRY>
|
||||
</ROW>
|
||||
</TBODY>
|
||||
</TGROUP>
|
||||
</TABLE>
|
||||
|
||||
</PARA>
|
||||
<PARA>Note that the two income accounts offset one another so
|
||||
that the <EMPHASIS>current</EMPHASIS> income resulting from the
|
||||
transaction is only $55. The remaining $5000 had previously
|
||||
been recognized as <EMPHASIS>Accrued Gain Income.</EMPHASIS>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> You were over-optimistic about the value of the painting.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>The numbers change a little bit, but not too
|
||||
dramatically.
|
||||
|
||||
<TABLE>
|
||||
<TITLE>Accrued Gain becomes Realized Gain</TITLE>
|
||||
<TGROUP COLS="2">
|
||||
<THEAD>
|
||||
<ROW>
|
||||
<ENTRY>Account</ENTRY>
|
||||
<ENTRY>Amount</ENTRY>
|
||||
</ROW>
|
||||
</THEAD>
|
||||
<TBODY>
|
||||
<ROW>
|
||||
<ENTRY>Cash</ENTRY>
|
||||
<ENTRY>$15000</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Painting</ENTRY>
|
||||
<ENTRY>-$11000</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Accrued Gain Asset</ENTRY>
|
||||
<ENTRY>-$5000</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Realized Gain Income</ENTRY>
|
||||
<ENTRY>-$4000</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Accrued Gain Income</ENTRY>
|
||||
<ENTRY>$5000</ENTRY>
|
||||
</ROW>
|
||||
</TBODY>
|
||||
</TGROUP>
|
||||
</TABLE>
|
||||
|
||||
</PARA>
|
||||
<PARA>Note that the two income accounts offset one another so
|
||||
that the <EMPHASIS>current</EMPHASIS> income resulting from the
|
||||
transaction turns out to be a <EMPHASIS>loss</EMPHASIS> of $1000.
|
||||
That's fine, as you had previously recognized $5000 in
|
||||
income.
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> You manage to sell your painting for more than you thought
|
||||
in your wildest dreams.
|
||||
|
||||
</PARA>
|
||||
<PARA>The extra value is, again, recorded as a gain, <EMPHASIS> i.e.</EMPHASIS> an income.
|
||||
|
||||
<TABLE>
|
||||
<TITLE>Accrued Gain Becomes Handsome Realized Gain</TITLE>
|
||||
<TGROUP COLS="2">
|
||||
<THEAD>
|
||||
<ROW>
|
||||
<ENTRY>Account</ENTRY>
|
||||
<ENTRY>Amount</ENTRY>
|
||||
</ROW>
|
||||
</THEAD>
|
||||
<TBODY>
|
||||
<ROW>
|
||||
<ENTRY>Cash</ENTRY>
|
||||
<ENTRY>$50000</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Painting</ENTRY>
|
||||
<ENTRY>-$11000</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Accrued Gain Asset</ENTRY>
|
||||
<ENTRY>-$5000</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Realized Gain Income</ENTRY>
|
||||
<ENTRY>-$39000</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Accrued Gain Income</ENTRY>
|
||||
<ENTRY>$5000</ENTRY>
|
||||
</ROW>
|
||||
</TBODY>
|
||||
</TGROUP>
|
||||
</TABLE>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
<PARA>In practice, it truly is important to keep the <EMPHASIS>Accrued
|
||||
Gain Income</EMPHASIS> separate from the <EMPHASIS>Realized Gain
|
||||
Income,</EMPHASIS> as the former is likely to be ignored by your tax
|
||||
authorities, who will only care to charge you on the <EMPHASIS> Realized Gain.</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
<PARA>Below, we show the second case discussed.
|
||||
<INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="appr-main2.gif">
|
||||
</IMAGEOBJECT>
|
||||
<TEXTOBJECT>
|
||||
<PHRASE>Main window after sale</PHRASE>
|
||||
</TEXTOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
<INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="appr-asset2.gif">
|
||||
</IMAGEOBJECT>
|
||||
<TEXTOBJECT>
|
||||
<PHRASE>Asset account after sale</PHRASE>
|
||||
</TEXTOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
|
||||
</PARA>
|
||||
</SECT3>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>Caution about Valuation</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>As we see in this example, for non-financial assets, it may
|
||||
be difficult to correctly estimate the ``true'' value of an
|
||||
asset.
|
||||
|
||||
</PARA>
|
||||
<PARA>It is quite easy to count yourself rich based on
|
||||
questionable estimates that do not reflect "money in the
|
||||
bank."
|
||||
|
||||
</PARA>
|
||||
<PARA>Thus, when dealing with appreciation of assets,
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> Be careful with your estimation of values.
|
||||
|
||||
</PARA>
|
||||
<PARA>Do not indulge in wishful thinking.
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Never, ever, count on money you do not have in your bank or
|
||||
as cash.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>Be aware: all too many companies that appear
|
||||
"profitable" on paper go out of business as a result of
|
||||
running out of <EMPHASIS>cash,</EMPHASIS> precisely because "valuable
|
||||
assets" were not the same thing as cash.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>Taxation of Capital Gains</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>Taxation policies vary considerably between countries, so it
|
||||
is virtually impossible to say anything that will be
|
||||
universally useful.
|
||||
|
||||
</PARA>
|
||||
<PARA>However, it is <EMPHASIS>common</EMPHASIS> 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.
|
||||
|
||||
</PARA>
|
||||
<PARA>North American home owners <EMPHASIS>usually</EMPHASIS> 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.
|
||||
|
||||
</PARA>
|
||||
<PARA><ULINK URL="mailto:cbbrowne@hex.net">I have</ULINK> one story from
|
||||
my professional tax preparation days where a family sold a
|
||||
farm, and expected a <EMPHASIS>considerable</EMPHASIS> 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 <EMPHASIS>dairy</EMPHASIS> farm, with some <EMPHASIS>really
|
||||
peculiar</EMPHASIS> resulting deductions.
|
||||
|
||||
</PARA>
|
||||
<PARA>In short, this presentation is fairly simple, but taxation
|
||||
often gets terribly complicated...
|
||||
|
||||
</PARA>
|
||||
</SECT2>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-DEPR">
|
||||
<TITLE> Depreciation of assets</TITLE>
|
||||
<PARA>Compared to the often uncertain estimates one has to do
|
||||
where appreciation of assets is concerned, we are on somewhat
|
||||
firmer ground here.
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Governments tend to set up precise rules as to how you
|
||||
are required to calculate depreciation for tax purposes.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>It is easy to look up in references such as "Blue Books"
|
||||
estimates of what an automobile should be worth after 3 years
|
||||
of use.
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<SECT2>
|
||||
<TITLE>Depreciation schemes</TITLE>
|
||||
<PARA> </PARA>
|
||||
<SECT3>
|
||||
<TITLE>Linear depreciation</TITLE>
|
||||
<PARA>Linear depreciation diminishes the value of an asset by a
|
||||
fixed amount each period until the net value is zero. This is
|
||||
the <EMPHASIS>simplest</EMPHASIS> calculation, as you estimate a useful
|
||||
lifetime, and simply divide the cost equally across that
|
||||
lifetime.
|
||||
|
||||
</PARA>
|
||||
<PARA><EMPHASIS>Example:</EMPHASIS> You have bought a computer for $1500 and
|
||||
wish to depreciate it over a period of 5 years. Each year the
|
||||
amount of depreciation is $300, leading to the following
|
||||
calculations:
|
||||
|
||||
|
||||
<TABLE>
|
||||
<TITLE>Example 1</TITLE>
|
||||
<TGROUP COLS="3">
|
||||
<THEAD>
|
||||
<ROW>
|
||||
<ENTRY>Year</ENTRY>
|
||||
<ENTRY>Depreciation</ENTRY>
|
||||
<ENTRY>Remaining Value</ENTRY>
|
||||
</ROW>
|
||||
</THEAD>
|
||||
<TBODY>
|
||||
<ROW>
|
||||
<ENTRY>1</ENTRY>
|
||||
<ENTRY>300</ENTRY>
|
||||
<ENTRY>1200</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>2</ENTRY>
|
||||
<ENTRY>300</ENTRY>
|
||||
<ENTRY>900</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>3</ENTRY>
|
||||
<ENTRY>300</ENTRY>
|
||||
<ENTRY>600</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>4</ENTRY>
|
||||
<ENTRY>300</ENTRY>
|
||||
<ENTRY>300</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>5</ENTRY>
|
||||
<ENTRY>300</ENTRY>
|
||||
<ENTRY>0</ENTRY>
|
||||
</ROW>
|
||||
</TBODY>
|
||||
</TGROUP>
|
||||
</TABLE>
|
||||
|
||||
</PARA>
|
||||
</SECT3>
|
||||
<SECT3>
|
||||
<TITLE>Geometric Depreciation</TITLE>
|
||||
<PARA>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 ( <EMPHASIS>i.e.</EMPHASIS> - a resale
|
||||
value).
|
||||
|
||||
</PARA>
|
||||
<PARA><EMPHASIS>Beware: Tax authorities may require (or allow) a larger
|
||||
percentage in the first period.</EMPHASIS> On the other hand, in
|
||||
Canada, this is reversed, as they permit only a <EMPHASIS>half</EMPHASIS>
|
||||
share of "Capital Cost Allowance" in the first year.
|
||||
|
||||
</PARA>
|
||||
<PARA>The result of this approach is that asset value decreases
|
||||
more rapidly at the beginning than at the end which is <EMPHASIS> probably</EMPHASIS> more realistic for most assets than a linear
|
||||
scheme. This is certainly true for automobiles.
|
||||
|
||||
</PARA>
|
||||
<PARA><EMPHASIS>Example:</EMPHASIS> We take the same example as above,
|
||||
with an annual depreciation of 30%.
|
||||
|
||||
<TABLE>
|
||||
<TITLE>Example 2</TITLE>
|
||||
<TGROUP COLS="3">
|
||||
<THEAD>
|
||||
<ROW>
|
||||
<ENTRY>Year</ENTRY>
|
||||
<ENTRY>Depreciation</ENTRY>
|
||||
<ENTRY>Remaining Value</ENTRY>
|
||||
</ROW>
|
||||
</THEAD>
|
||||
<TBODY>
|
||||
<ROW>
|
||||
<ENTRY>1</ENTRY>
|
||||
<ENTRY>450</ENTRY>
|
||||
<ENTRY>1050</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>2</ENTRY>
|
||||
<ENTRY>315</ENTRY>
|
||||
<ENTRY>735</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>3</ENTRY>
|
||||
<ENTRY>220.50</ENTRY>
|
||||
<ENTRY>514.50</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>4</ENTRY>
|
||||
<ENTRY>154.35</ENTRY>
|
||||
<ENTRY>360.15</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>5</ENTRY>
|
||||
<ENTRY>108.05</ENTRY>
|
||||
<ENTRY>252.10</ENTRY>
|
||||
</ROW>
|
||||
</TBODY>
|
||||
</TGROUP>
|
||||
</TABLE>
|
||||
|
||||
</PARA>
|
||||
</SECT3>
|
||||
<SECT3>
|
||||
<TITLE>Sum of digits</TITLE>
|
||||
<PARA>A third method most often employed in Anglo/Saxon countries
|
||||
is the "sum of digits" method. Here is an illustration:
|
||||
|
||||
</PARA>
|
||||
<PARA><EMPHASIS>Example:</EMPHASIS> First you divide the asset value
|
||||
by the sum of the years of use, <EMPHASIS>e.g.</EMPHASIS> 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:
|
||||
|
||||
<TABLE>
|
||||
<TITLE>Example 3</TITLE>
|
||||
<TGROUP COLS="3">
|
||||
<THEAD>
|
||||
<ROW>
|
||||
<ENTRY>Year</ENTRY>
|
||||
<ENTRY>Depreciation</ENTRY>
|
||||
<ENTRY>Remaining Value</ENTRY>
|
||||
</ROW>
|
||||
</THEAD>
|
||||
<TBODY>
|
||||
<ROW>
|
||||
<ENTRY>1</ENTRY>
|
||||
<ENTRY>100*5=500</ENTRY>
|
||||
<ENTRY>1000</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>2</ENTRY>
|
||||
<ENTRY>100*4=400</ENTRY>
|
||||
<ENTRY>600</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>3</ENTRY>
|
||||
<ENTRY>100*3=300</ENTRY>
|
||||
<ENTRY>300</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>4</ENTRY>
|
||||
<ENTRY>100*2=200</ENTRY>
|
||||
<ENTRY>100</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>5</ENTRY>
|
||||
<ENTRY>100*1=100</ENTRY>
|
||||
<ENTRY>0</ENTRY>
|
||||
</ROW>
|
||||
</TBODY>
|
||||
</TGROUP>
|
||||
</TABLE>
|
||||
|
||||
</PARA>
|
||||
</SECT3>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>The handling of depreciation in gnucash</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>In order to keep track of the depreciation of an asset, you
|
||||
need :
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>An <EMPHASIS>Asset Cost</EMPHASIS> asset account to keep track of the
|
||||
original value;
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>An <EMPHASIS>Accumulated Depreciation</EMPHASIS> asset account in
|
||||
which to collect the sum of all of the years' depreciation
|
||||
amounts;
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>A <EMPHASIS>Depreciation Expense</EMPHASIS> expense account in which
|
||||
to record periodic depreciation expenses.
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
<PARA>The first step, again, is to record the purchase of your
|
||||
asset by transferring the money from bank bank account to the
|
||||
<EMPHASIS>asset cost</EMPHASIS> account. Afterwards, in each accounting
|
||||
period you record the depreciation as an expense in the
|
||||
appropriate account.
|
||||
|
||||
</PARA>
|
||||
<PARA>The two windows below show your asset account and the main
|
||||
window after the third year of depreciation using a "sum of
|
||||
digits" scheme for the example above.
|
||||
<INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="depr-asset.gif">
|
||||
</IMAGEOBJECT>
|
||||
<TEXTOBJECT>
|
||||
<PHRASE>Asset account after depreciation</PHRASE>
|
||||
</TEXTOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
<INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="depr-main.gif">
|
||||
</IMAGEOBJECT>
|
||||
<TEXTOBJECT>
|
||||
<PHRASE>Main window after depreciation</PHRASE>
|
||||
</TEXTOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>A word of caution</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>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 <EMPHASIS>or required</EMPHASIS> to
|
||||
use.
|
||||
|
||||
</PARA>
|
||||
</SECT2>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
176
doc/sgml/C/xacc-dochack.sgml
Normal file
176
doc/sgml/C/xacc-dochack.sgml
Normal file
@ -0,0 +1,176 @@
|
||||
<article id="xacc-dochack">
|
||||
<artheader>
|
||||
<title> Hacking GnuCash Documentation </title>
|
||||
<author>
|
||||
<firstname>Christopher</firstname>
|
||||
<surname>Browne</surname>
|
||||
</author>
|
||||
</artheader>
|
||||
|
||||
<sect1 id="xacc-docbook">
|
||||
|
||||
<title> About DocBook </title>
|
||||
|
||||
<para> The GnuCash documentation has been changed to use SGML, and, in
|
||||
particular, the DocBook DTD. </para>
|
||||
|
||||
<PARA> DocBook is a DTD designed for authoring technical documents
|
||||
such as computer manuals. A number of tools are growing up to assist
|
||||
in processing DocBook-based material.
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
|
||||
<LISTITEM>
|
||||
<PARA> <ULINK URL="http://docbook.org/tdg/html/docbook.html"> DocBook:
|
||||
The Definitive Guide (online)</ULINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
|
||||
<LISTITEM>
|
||||
<PARA> <ULINK
|
||||
URL="http://www.oasis-open.com/davenport/dbdoc/">References for the
|
||||
DocBook DTD </ULINK> </PARA>
|
||||
</LISTITEM>
|
||||
|
||||
<LISTITEM>
|
||||
<PARA><ULINK
|
||||
URL="http://www.oasis-open.org/docbook/documentation/index.html">
|
||||
DocBook - Documentation</ULINK></PARA>
|
||||
</LISTITEM>
|
||||
|
||||
<LISTITEM>
|
||||
<PARA><ULINK URL="http://www.oasis-open.org/docbook/">DocBook - DocBook</ULINK></PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> <ULINK URL="http://fallout.campusview.indiana.edu/~jfieber/docbook/doc/over/index.html"> DocBook
|
||||
Overview </ULINK> </PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> <ULINK URL="http://fallout.campusview.indiana.edu/~jfieber/docbook/doc/user/index.html"> DocBook User
|
||||
Guide </ULINK> </PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> <ULINK URL="http://fallout.campusview.indiana.edu/~jfieber/docbook/doc/ref/index.html"> DocBook
|
||||
Reference Guide </ULINK> </PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> <ULINK URL="http://fallout.campusview.indiana.edu/~jfieber/docbook/doc/maint/index.html">DocBook
|
||||
Customization Guide </ULINK> </PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM ID="MODULARDOCBOOK">
|
||||
<PARA> <ULINK URL="http://nwalsh.com/docbook/dsssl/index.html"> The
|
||||
Modular DocBook Stylesheets </ULINK> </PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><ULINK URL="http://nwalsh.com/docbook/edbsyn/"> The
|
||||
nwalsh.com Home Page - Extended DocBook Synopses </ULINK>
|
||||
|
||||
</PARA>
|
||||
<PARA> Adds tags for DocBook to support object oriented languages like
|
||||
Java, C++, and IDL, including such new entities as classes, fields,
|
||||
methods, exceptions, and so forth...
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> <ULINK URL="http://nwalsh.com/docbook/qr/quickref.htm"> DocBook V3.0 Quick
|
||||
Reference </ULINK> </PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> <ULINK URL="http://nis-www.lanl.gov/~rosalia/mydocs/docbook-intro.html"> Get
|
||||
Going With DocBook </ULINK></PARA>
|
||||
<PARA> This document describes how one might use the DocBook DTD to
|
||||
write documents, including information on how to use tables, and
|
||||
insert program listings. </PARA>
|
||||
<PARA> Hopefully it will soon document the care and feeding of insertion
|
||||
of graphics, and more information on ``interesting'' crossreferencing.</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><ULINK URL="http://lwn.net/2000/features/DocBook/">Exploring SGML DocBook </ULINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> <ULINK URL="http://itrc.uwaterloo.ca/~papresco/SgmlTools/demo.html"> DocBook
|
||||
SGMLTOOLS demo </ULINK> </PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> <ULINK URL="http://nwalsh.com/docbook/nutshell.html">DocBook in a Nutshell </ULINK></PARA>
|
||||
|
||||
</LISTITEM>
|
||||
|
||||
<LISTITEM> <PARA><ULINK URL=
|
||||
"http://www.dfwuug.org/newsletters/2000/newsletter_0003.html"> My
|
||||
review of DocBook: The Definitive Guide </ULINK> as written for the
|
||||
DFW Unix User's Group
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><ULINK URL="http://www.freebsd.org/%7enik/primer/index.html"> FreeBSD Documentation
|
||||
Project Primer for New Contributors (SGMLTools)</ULINK> </PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><ULINK URL="http://www.sslug.dk/%7epto/docbook.html">Getting started with SGMLTOOLS and DOCBOOK</ULINK></PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST> </PARA>
|
||||
|
||||
</sect1>
|
||||
|
||||
<sect1 id="xacc-docbookuse">
|
||||
<title>The GnuCash Documentation Set</title>
|
||||
|
||||
<para> The GnuCash documentation is managed as a BOOK, composed of a
|
||||
set of DocBook "ARTICLES." </para>
|
||||
|
||||
<PARA> The main document is <filename>gnucash.sgml</filename>, which
|
||||
really contains only the "sequencing" information on what files are to
|
||||
be consulted to make up the body of the document, each file
|
||||
representing one of the ARTICLEs. </PARA>
|
||||
|
||||
<para> Note that filenames for the HTML output files are generated in
|
||||
three notable ways:
|
||||
|
||||
<itemizedlist>
|
||||
|
||||
<listitem><para> The ID tag for each ARTICLE defines a
|
||||
filename;</para></listitem>
|
||||
|
||||
<listitem><para> The ID tag for each SECT1 defines a filename, unless
|
||||
it is the first SECT1 in an ARTICLE;</para></listitem>
|
||||
|
||||
<listitem><para> If you create a new ARTICLE or SECT1 without an ID
|
||||
tag, filenames will be generated with names like
|
||||
<filename>t1234.html</filename>, <filename>x892.html</filename>, and
|
||||
such. They will look quite random. </para></listitem>
|
||||
|
||||
</itemizedlist>
|
||||
</para>
|
||||
|
||||
<para> Styling is controlled by the DSSSL document,
|
||||
<filename>mysheet.dsl</filename>, using the conventions documented in
|
||||
the <link linkend="MODSTYLE"> Modular DocBook Stylesheets </link></para>
|
||||
|
||||
<para> Components that need to be installed in order for the command
|
||||
<command>jade -ioutput.html -d mysheet.dsl -t sgml
|
||||
gnucash.sgml</command> to work include:
|
||||
|
||||
<itemizedlist>
|
||||
|
||||
<listitem><para> <ULINK URL="http://www.jclark.com/jade/">Jade
|
||||
</ULINK> or <ULINK URL= "http://www.netfolder.com/DSSSL/index.html">
|
||||
DSSSL/OpenJade </ULINK></para></listitem>
|
||||
|
||||
<listitem><para> The DocBook 3.1 DTD, available from <ULINK URL=
|
||||
"http://docbook.org"> DocBook.org </ULINK></para></listitem>
|
||||
|
||||
<listitem><para> Norman Walsh's <ULINK id="MODSTYLE" URL=
|
||||
"http://nwalsh.com/docbook/dsssl/index.html"> Modular DocBook
|
||||
Stylesheets </ULINK></para></listitem>
|
||||
|
||||
</itemizedlist>
|
||||
</para>
|
||||
</sect1>
|
||||
|
||||
</article>
|
||||
212
doc/sgml/C/xacc-doubleentry.sgml
Normal file
212
doc/sgml/C/xacc-doubleentry.sgml
Normal file
@ -0,0 +1,212 @@
|
||||
|
||||
<ARTICLE ID="XACC-DOUBLEENTRY">
|
||||
<ARTHEADER>
|
||||
<TITLE></TITLE>
|
||||
<TITLE>Understanding Double Entry Accounting</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Why Use Double Entry Accounting?</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>If you are a novice to accounting, you <EMPHASIS>need</EMPHASIS> 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.
|
||||
|
||||
</PARA>
|
||||
<PARA>And if you are an experienced accountant, you would likely
|
||||
feel <EMPHASIS>ill</EMPHASIS> at the thought of life without it.
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-DOUBLEDEF">
|
||||
<TITLE> What is Double Entry Accounting?</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>Double entry bookkeeping is an accounting methodology
|
||||
introduced in the 13th century to to make sure that each
|
||||
accounts and indeed <EMPHASIS>each transaction</EMPHASIS> is properly
|
||||
balanced.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>A double-entry transaction is a transaction that contains
|
||||
entries for two (or more) accounts that balance against one
|
||||
another. One account is <EMPHASIS>debited</EMPHASIS> by an amount exactly
|
||||
equal to what the other is <EMPHASIS>credited.</EMPHASIS> 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 <EMPHASIS>I forgot to enter
|
||||
that part of the transaction</EMPHASIS> errors.
|
||||
|
||||
</PARA>
|
||||
<PARA>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 <EMPHASIS> have</EMPHASIS> to have another component to that transaction to
|
||||
balance it.
|
||||
|
||||
</PARA>
|
||||
<PARA><EMPHASIS>Not-quite-an-aside:</EMPHASIS> If you look at your bank
|
||||
statements, they are typically written up from the <EMPHASIS> bank's</EMPHASIS> perspective, which is exactly <EMPHASIS>opposite</EMPHASIS> to
|
||||
yours. For instance, when you put money in, establishing a
|
||||
deposit, this establishes a <EMPHASIS>DEBT</EMPHASIS> on their part.
|
||||
As a result, "newcomers to accounting," who only see the terms
|
||||
"Debit" and "Credit" on statements from their bank seem to get
|
||||
fairly confused about this.
|
||||
|
||||
</PARA>
|
||||
<PARA>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 <LINK LINKEND="XACC-EXPENSE"> Income/Expense</LINK> page for a more detailed discussion of
|
||||
that.
|
||||
|
||||
</PARA>
|
||||
<PARA><ANCHOR ID="IDENTITY">In a traditional system that records
|
||||
debits and credits separately, the identity that all
|
||||
transactions are required to satisfy is that <ENVAR>Total of
|
||||
Debits = Total of Credits.</ENVAR>
|
||||
|
||||
</PARA>
|
||||
<PARA>The fact that the identity requires merely that the <EMPHASIS> total</EMPHASIS> balances means that it is a little bit misleading to
|
||||
call this <EMPHASIS>double</EMPHASIS>-entry bookkeeping; it would be
|
||||
somewhat more accurate to call it <EMPHASIS>multiple-</EMPHASIS>entry
|
||||
bookkeeping. Unfortunately, there's 700 years of history of use
|
||||
of the term, which sufficiently discourages changing it. (To
|
||||
think some newcomers to UNIX think that it has some crufty old
|
||||
bits of oddness. Hah! We've got UNIX beat by the better part of
|
||||
a millennium!)
|
||||
|
||||
</PARA>
|
||||
<PARA>GnuCash treats "Debits" as positive values, and "Credits" as
|
||||
negative values, so that this identity simplifies to <LITERAL> value<SUBSCRIPT>1</SUBSCRIPT> + value<SUBSCRIPT>2</SUBSCRIPT> + value<SUBSCRIPT>3</SUBSCRIPT> + ...
|
||||
= 0</LITERAL>
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-DOUBLEUSE">
|
||||
<TITLE> Using Double Entry</TITLE>
|
||||
<PARA> </PARA>
|
||||
<SECT2>
|
||||
<TITLE>Creating Transactions</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>To create a double-entry transaction:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> Click on a box in the column marked <SCREEN>Transfer From</SCREEN>
|
||||
on the left-hand side of the register.
|
||||
|
||||
</PARA>
|
||||
<PARA>A menu will drop down, listing all of the accounts from
|
||||
which a transfer may be made.
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Select one.
|
||||
|
||||
</PARA>
|
||||
<PARA>When you record the transaction, the double-entry will
|
||||
automatically be made, and the transaction automatically
|
||||
appear in all windows showing the transferred-from and the
|
||||
transferred-to accounts.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>Changing Transactions</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>To <EMPHASIS>change</EMPHASIS> a double-entry transaction:
|
||||
|
||||
</PARA>
|
||||
<PARA>Simply edit the transaction in any window in which it
|
||||
appears.
|
||||
|
||||
</PARA>
|
||||
<PARA>Any changes made will be automatically reflected in both
|
||||
accounts and all windows displaying the transaction.
|
||||
|
||||
</PARA>
|
||||
<PARA>Similarly, when a double-entry transaction is deleted, the
|
||||
"splits" will be deleted from both accounts, and balances will
|
||||
automatically be recalculated for <EMPHASIS>both</EMPHASIS> accounts.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
</SECT2>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-SCRUBBING">
|
||||
<TITLE> Scrubbing Clean</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>GnuCash may be configured to be strict about double entry,
|
||||
or you may configure it to be "loose."
|
||||
|
||||
</PARA>
|
||||
<PARA>In "loose" mode, you can create <EMPHASIS>unbalanced
|
||||
transactions,</EMPHASIS> 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
|
||||
probably not a really wise move. In effect:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>If you aren't sure of what you're doing, you likely do
|
||||
not want to discard the validation of <EMPHASIS>double entry,</EMPHASIS> as
|
||||
this helps you keep your accounts balanced even when you're
|
||||
not perfectly clear on this.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>If you are an <EMPHASIS>accounting whiz,</EMPHASIS> you'll know that
|
||||
it's <EMPHASIS>really important</EMPHASIS> to keep things in balance, and
|
||||
again will prefer <EMPHASIS>double entry.</EMPHASIS>
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
<PARA>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 <EMPHASIS>Scrub</EMPHASIS> the account clean by choosing
|
||||
<GUIMENU>Scrub</GUIMENU> from the window menu.
|
||||
|
||||
</PARA>
|
||||
<PARA>The process will examine each transaction; if the
|
||||
transaction doesn't balance, a split entry will be created and
|
||||
placed into an account named <EMPHASIS>Unbalanced.</EMPHASIS> You may then
|
||||
review these splits and move them to their proper accounts.
|
||||
|
||||
</PARA>
|
||||
<PARA><EMPHASIS>Warning: Functionality Changing...</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
<PARA>At present, control over whether GnuCash is "strict" or
|
||||
"loose" is established at compile time, and defaults to <EMPHASIS> strict.</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
<PARA>In the future, there will be no option of "looseness."
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
144
doc/sgml/C/xacc-euro.sgml
Normal file
144
doc/sgml/C/xacc-euro.sgml
Normal file
@ -0,0 +1,144 @@
|
||||
|
||||
<ARTICLE ID="XACC-EURO">
|
||||
<ARTHEADER>
|
||||
<TITLE></TITLE>
|
||||
<TITLE>GnuCash and the EURO</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> GnuCash and the EURO</TITLE>
|
||||
<PARA> </PARA>
|
||||
<SECT2>
|
||||
<TITLE>Introduction</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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
|
||||
transactions like cheques or wire transfers are possible in
|
||||
euro
|
||||
|
||||
</PARA>
|
||||
<PARA>You can find more information about the euro at: <ULINK URL="http://europa.eu.int/euro">http://europa.eu.int/euro</ULINK> .
|
||||
|
||||
</PARA>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>EMU Member Countries and Exchange Rates</TITLE>
|
||||
<PARA> <ANCHOR ID="EUROISOCURR">
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
<TABLE>
|
||||
<TITLE>EMU Exchange Rates</TITLE>
|
||||
<TGROUP COLS="4">
|
||||
<THEAD>
|
||||
<ROW>
|
||||
<ENTRY>Country</ENTRY>
|
||||
<ENTRY>ISO Code</ENTRY>
|
||||
<ENTRY>Full Description</ENTRY>
|
||||
<ENTRY>Exchange Rate</ENTRY>
|
||||
</ROW>
|
||||
</THEAD>
|
||||
<TBODY>
|
||||
<ROW>
|
||||
<ENTRY> </ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Austria</ENTRY>
|
||||
<ENTRY>ATS</ENTRY>
|
||||
<ENTRY>Austrian Schilling</ENTRY>
|
||||
<ENTRY>1 euro = 13.7603 S</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Belgium</ENTRY>
|
||||
<ENTRY>BEF</ENTRY>
|
||||
<ENTRY>Belgian Franc</ENTRY>
|
||||
<ENTRY>1 euro = 40.3399 bfrs</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Finland</ENTRY>
|
||||
<ENTRY>FIM</ENTRY>
|
||||
<ENTRY>Finnish Mark</ENTRY>
|
||||
<ENTRY>1 euro = 5.94573 Fmk</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>France</ENTRY>
|
||||
<ENTRY>FRF</ENTRY>
|
||||
<ENTRY>French Franc</ENTRY>
|
||||
<ENTRY>1 euro = 6.55957 FF</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Germany</ENTRY>
|
||||
<ENTRY>DEM</ENTRY>
|
||||
<ENTRY>German Mark</ENTRY>
|
||||
<ENTRY>1 euro = 1.95538 DM</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Ireland</ENTRY>
|
||||
<ENTRY>IEP</ENTRY>
|
||||
<ENTRY>Irish Pound</ENTRY>
|
||||
<ENTRY>1 euro = 0.787564 Ir. £</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Italy</ENTRY>
|
||||
<ENTRY>ITL</ENTRY>
|
||||
<ENTRY>Italian Lira</ENTRY>
|
||||
<ENTRY>1 euro = 1936.27 Lit</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Luxembourg</ENTRY>
|
||||
<ENTRY>LUF</ENTRY>
|
||||
<ENTRY>Luxembourgian Franc</ENTRY>
|
||||
<ENTRY>1 euro = 40.3399 lfrs</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Netherlands</ENTRY>
|
||||
<ENTRY>NLG</ENTRY>
|
||||
<ENTRY>Dutch Guilder</ENTRY>
|
||||
<ENTRY>1 euro = 2.20371 hfl</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Portugal</ENTRY>
|
||||
<ENTRY>PTE</ENTRY>
|
||||
<ENTRY>Portuguese Escudo</ENTRY>
|
||||
<ENTRY>1 euro = 200.482 Esc</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Spain</ENTRY>
|
||||
<ENTRY>ESP</ENTRY>
|
||||
<ENTRY>Spanish Peseta</ENTRY>
|
||||
<ENTRY>1 euro = 166.386 Ptas</ENTRY>
|
||||
</ROW>
|
||||
</TBODY>
|
||||
</TGROUP>
|
||||
</TABLE>
|
||||
|
||||
</PARA>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>EURO support in GnuCash</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>You can enable euro support in GnuCash in the international
|
||||
category of the <LINK LINKEND="USERPREF">preferences</LINK>
|
||||
dialog box. If your system locale specifies one of the <LINK LINKEND="EUROISOCURR">EMU member currencies</LINK>, euro support is
|
||||
enabled by default.
|
||||
|
||||
</PARA>
|
||||
<PARA>FIXME: Actual documentation with screenshots and so on
|
||||
|
||||
</PARA>
|
||||
</SECT2>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
372
doc/sgml/C/xacc-gpl.sgml
Normal file
372
doc/sgml/C/xacc-gpl.sgml
Normal file
@ -0,0 +1,372 @@
|
||||
<ARTICLE ID="XACC-GPL">
|
||||
<ARTHEADER>
|
||||
<TITLE>GNU General Public License</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> GNU General Public License</TITLE>
|
||||
<PARA> </PARA>
|
||||
<SECT2>
|
||||
<TITLE>Version 2, June 1991</TITLE>
|
||||
<PARA> Copyright (C) 1989, 1991 Free Software Foundation, Inc. 675
|
||||
Mass Ave, Cambridge, MA 02139, USA
|
||||
|
||||
</PARA>
|
||||
<PARA>Everyone is permitted to copy and distribute verbatim
|
||||
copies of this license document, but changing it is not
|
||||
allowed.
|
||||
|
||||
</PARA>
|
||||
<SECT3>
|
||||
<TITLE><ANCHOR ID="SEC001">Preamble</TITLE>
|
||||
<PARA>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
|
||||
free for all its users. This General Public License applies to
|
||||
most of the Free Software Foundation's software and to any
|
||||
other program whose authors commit to using it. (Some other
|
||||
Free Software Foundation software is covered by the GNU Library
|
||||
General Public License instead.) You can apply it to your
|
||||
programs, too.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>The precise terms and conditions for copying, distribution
|
||||
and modification follow.
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT3>
|
||||
<SECT3>
|
||||
<TITLE><ANCHOR ID="SEC002">GNU GENERAL PUBLIC LICENSE TERMS AND
|
||||
CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION</TITLE>
|
||||
<PARA>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
|
||||
"work based on the Program" means either the Program or any
|
||||
derivative work under copyright law: that is to say, a work
|
||||
containing the Program or a portion of it, either verbatim or
|
||||
with modifications and/or translated into another language.
|
||||
(Hereinafter, translation is included without limitation in the
|
||||
term "modification".) Each licensee is addressed as "you".
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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
|
||||
warranty; keep intact all the notices that refer to this
|
||||
License and to the absence of any warranty; and give any other
|
||||
recipients of the Program a copy of this License along with the
|
||||
Program.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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
|
||||
conditions:
|
||||
|
||||
<BLOCKQUOTE>
|
||||
<PARA> a) You must cause the modified files to carry prominent
|
||||
notices stating that you changed the files and the date of
|
||||
any change.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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
|
||||
copyright notice and a notice that there is no warranty (or
|
||||
else, saying that you provide a warranty) and that users may
|
||||
redistribute the program under these conditions, and telling
|
||||
the user how to view a copy of this License. (Exception: if
|
||||
the Program itself is interactive but does not normally print
|
||||
such an announcement, your work based on the Program is not
|
||||
required to print an announcement.)
|
||||
</PARA>
|
||||
</BLOCKQUOTE>
|
||||
|
||||
These requirements apply to the modified work as a whole. If
|
||||
identifiable sections of that work are not derived from the
|
||||
Program, and can be reasonably considered independent and
|
||||
separate works in themselves, then this License, and its terms,
|
||||
do not apply to those sections when you distribute them as
|
||||
separate works. But when you distribute the same sections as
|
||||
part of a whole which is a work based on the Program, the
|
||||
distribution of the whole must be on the terms of this License,
|
||||
whose permissions for other licensees extend to the entire
|
||||
whole, and thus to each and every part regardless of who wrote
|
||||
it.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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:
|
||||
|
||||
<BLOCKQUOTE>
|
||||
<PARA> a) Accompany it with the complete corresponding
|
||||
machine-readable source code, which must be distributed under
|
||||
the terms of Sections 1 and 2 above on a medium customarily
|
||||
used for software interchange; or,
|
||||
|
||||
</PARA>
|
||||
<PARA>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
|
||||
code, to be distributed under the terms of Sections 1 and 2
|
||||
above on a medium customarily used for software interchange;
|
||||
or,
|
||||
|
||||
</PARA>
|
||||
<PARA>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
|
||||
executable form with such an offer, in accord with Subsection
|
||||
b above.)
|
||||
</PARA>
|
||||
</BLOCKQUOTE>
|
||||
|
||||
</PARA>
|
||||
<PARA>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,
|
||||
plus the scripts used to control compilation and installation
|
||||
of the executable. However, as a special exception, the source
|
||||
code distributed need not include anything that is normally
|
||||
distributed (in either source or binary form) with the major
|
||||
components (compiler, kernel, and so on) of the operating
|
||||
system on which the executable runs, unless that component
|
||||
itself accompanies the executable.
|
||||
|
||||
</PARA>
|
||||
<PARA>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
|
||||
parties are not compelled to copy the source along with the
|
||||
object code.
|
||||
|
||||
4. You may not copy, modify, sublicense, or distribute the
|
||||
Program except as expressly provided under this License. Any
|
||||
attempt otherwise to copy, modify, sublicense or distribute the
|
||||
Program is void, and will automatically terminate your rights
|
||||
under this License. However, parties who have received copies,
|
||||
or rights, from you under this License will not have their
|
||||
licenses terminated so long as such parties remain in full
|
||||
compliance.
|
||||
|
||||
</PARA>
|
||||
<PARA>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
|
||||
License. Therefore, by modifying or distributing the Program
|
||||
(or any work based on the Program), you indicate your
|
||||
acceptance of this License to do so, and all its terms and
|
||||
conditions for copying, distributing or modifying the Program
|
||||
or works based on it.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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
|
||||
this License. If you cannot distribute so as to satisfy
|
||||
simultaneously your obligations under this License and any
|
||||
other pertinent obligations, then as a consequence you may not
|
||||
distribute the Program at all. For example, if a patent license
|
||||
would not permit royalty-free redistribution of the Program by
|
||||
all those who receive copies directly or indirectly through
|
||||
you, then the only way you could satisfy both it and this
|
||||
License would be to refrain entirely from distribution of the
|
||||
Program.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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
|
||||
distribution system, which is implemented by public license
|
||||
practices. Many people have made generous contributions to the
|
||||
wide range of software distributed through that system in
|
||||
reliance on consistent application of that system; it is up to
|
||||
the author/donor to decide if he or she is willing to
|
||||
distribute software through any other system and a licensee
|
||||
cannot impose that choice.
|
||||
|
||||
This section is intended to make thoroughly clear what is
|
||||
believed to be a consequence of the rest of this License.
|
||||
|
||||
</PARA>
|
||||
<PARA>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
|
||||
geographical distribution limitation excluding those countries,
|
||||
so that distribution is permitted only in or among countries
|
||||
not thus excluded. In such case, this License incorporates the
|
||||
limitation as if written in the body of this License.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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
|
||||
any later version published by the Free Software Foundation. If
|
||||
the Program does not specify a version number of this License,
|
||||
you may choose any version ever published by the Free Software
|
||||
Foundation.
|
||||
|
||||
</PARA>
|
||||
<PARA>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,
|
||||
write to the Free Software Foundation; we sometimes make
|
||||
exceptions for this. Our decision will be guided by the two
|
||||
goals of preserving the free status of all derivatives of our
|
||||
free software and of promoting the sharing and reuse of
|
||||
software generally.
|
||||
|
||||
</PARA>
|
||||
</SECT3>
|
||||
<SECT3>
|
||||
<TITLE><ANCHOR ID="SEC003">NO WARRANTY</TITLE>
|
||||
<PARA>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,
|
||||
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
||||
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE
|
||||
ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS
|
||||
WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE
|
||||
COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
|
||||
|
||||
</PARA>
|
||||
<PARA>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,
|
||||
INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
|
||||
INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS
|
||||
OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED
|
||||
BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE
|
||||
WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY
|
||||
HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
|
||||
|
||||
</PARA>
|
||||
</SECT3>
|
||||
<SECT3>
|
||||
<TITLE>END OF TERMS AND CONDITIONS</TITLE>
|
||||
<PARA></PARA>
|
||||
</SECT3>
|
||||
</SECT2>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
211
doc/sgml/C/xacc-incomeexpense.sgml
Normal file
211
doc/sgml/C/xacc-incomeexpense.sgml
Normal file
@ -0,0 +1,211 @@
|
||||
|
||||
<ARTICLE ID="XACC-INCOMEEXPENSE">
|
||||
<ARTHEADER>
|
||||
<TITLE>Using Expense/Income Accounts</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> What are Incomes and Expenses?</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>The words "Income" and "Expense" are beguilingly simple;
|
||||
everyone <EMPHASIS>thinks</EMPHASIS> they know what they mean; this <EMPHASIS> usually</EMPHASIS> is that <EMPHASIS>When I spend something, this is an
|
||||
expense, and when I get money, this is an income.</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
<PARA>This oversimplifies things somewhat; it is often a <EMPHASIS> good-enough</EMPHASIS> 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."
|
||||
|
||||
</PARA>
|
||||
<PARA>For instance, companies usually have to recognize income
|
||||
<EMPHASIS>when the sale occurs.</EMPHASIS> That may mean that I have to
|
||||
recognize a $100,000 sale <EMPHASIS>at the moment I and the customer
|
||||
shake hands on the deal.</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
<PARA>Since the money hasn't come in, the sale has to be estimated
|
||||
in other way; the way this is done is to <EMPHASIS>accrue</EMPHASIS> 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
|
||||
<EMPHASIS>Accounts Receivable.</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
<PARA>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.)
|
||||
|
||||
</PARA>
|
||||
<PARA>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).
|
||||
|
||||
</PARA>
|
||||
<PARA>Another way of describing the requirement for "double entry"
|
||||
is that when you receive an income, two things happen:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>You receive a sum of <EMPHASIS>money,</EMPHASIS> and must record that
|
||||
effect on your bank account.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>You have received an income, and must record that effect
|
||||
on an income account.
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
<PARA>When, for instance, salary is deposited in a bank account,
|
||||
the bank account is credited, and the income account is
|
||||
debited, thus:
|
||||
|
||||
<TABLE>
|
||||
<TITLE>Accounting for Salary</TITLE>
|
||||
<TGROUP COLS="3">
|
||||
<THEAD>
|
||||
<ROW>
|
||||
<ENTRY>Account</ENTRY>
|
||||
<ENTRY>Debit</ENTRY>
|
||||
<ENTRY>Credit</ENTRY>
|
||||
</ROW>
|
||||
</THEAD>
|
||||
<TBODY>
|
||||
<ROW>
|
||||
<ENTRY>Chequing Account</ENTRY>
|
||||
<ENTRY>1,600.00</ENTRY>
|
||||
<ENTRY> </ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Salary</ENTRY>
|
||||
<ENTRY> </ENTRY>
|
||||
<ENTRY>1,600.00</ENTRY>
|
||||
</ROW>
|
||||
</TBODY>
|
||||
</TGROUP>
|
||||
</TABLE>
|
||||
|
||||
</PARA>
|
||||
<PARA>This may be readily extended to a greater number of "split"
|
||||
items thus:
|
||||
|
||||
<TABLE>
|
||||
<TITLE>A More Complex Paycheque</TITLE>
|
||||
<TGROUP COLS="3">
|
||||
<THEAD>
|
||||
<ROW>
|
||||
<ENTRY>Account</ENTRY>
|
||||
<ENTRY>Debit</ENTRY>
|
||||
<ENTRY>Credit</ENTRY>
|
||||
</ROW>
|
||||
</THEAD>
|
||||
<TBODY>
|
||||
<ROW>
|
||||
<ENTRY>Chequing Account</ENTRY>
|
||||
<ENTRY>1,300.00</ENTRY>
|
||||
<ENTRY> </ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Income Taxes</ENTRY>
|
||||
<ENTRY>200.00</ENTRY>
|
||||
<ENTRY> </ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Health Plan</ENTRY>
|
||||
<ENTRY>100.00</ENTRY>
|
||||
<ENTRY> </ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Salary</ENTRY>
|
||||
<ENTRY> </ENTRY>
|
||||
<ENTRY>1,600.00</ENTRY>
|
||||
</ROW>
|
||||
</TBODY>
|
||||
</TGROUP>
|
||||
</TABLE>
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>If, as with <EMPHASIS>GnuCash,</EMPHASIS> everything is forced onto one
|
||||
column, so that <EMPHASIS>debits</EMPHASIS> are represented by positive
|
||||
values, and <EMPHASIS>credits</EMPHASIS> are represented by negative values,
|
||||
the income/expense accounts do a slightly non-intuitive thing
|
||||
and you see incomes as <EMPHASIS>negative</EMPHASIS> values. That <EMPHASIS> appears</EMPHASIS> contrary to intuition, but is nonetheless
|
||||
necessary in order for the <LINK LINKEND="IDENTITY"> double-entry bookkeeping identity to hold true.</LINK>
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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 <EMPHASIS>equity.</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
<PARA>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, <EMPHASIS>they</EMPHASIS> correspondingly do
|
||||
not appear on a P&L statement.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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 <EMPHASIS>causes</EMPHASIS> for such
|
||||
transfers tend to be somewhat peculiar, so it's pretty fair for
|
||||
this to be a pretty odd situation.)
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-INCEXPUSE">
|
||||
<TITLE> Using Income/Expense Accounts</TITLE>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>You will doubtless wish to create quite a number of income
|
||||
and expense accounts; it may be worth looking at the <LINK LINKEND="XACC-SAMPLECHART">Sample Chart of Accounts</LINK> for
|
||||
ideas.
|
||||
|
||||
</PARA>
|
||||
<PARA>This partitioning of incomes and expenses is likely to prove
|
||||
particularly useful for North Americans when <EMPHASIS>income tax
|
||||
time</EMPHASIS> rolls around.
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-TERMSOTHER">
|
||||
<TITLE> Use of Terminology In Other Software</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>If you have used other personal finance software, be aware
|
||||
that <LINK LINKEND="XACC-QUICKENCATS">Quicken calls them
|
||||
"Categories."</LINK>
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
254
doc/sgml/C/xacc-locatingtxns.sgml
Normal file
254
doc/sgml/C/xacc-locatingtxns.sgml
Normal file
@ -0,0 +1,254 @@
|
||||
|
||||
<ARTICLE ID="XACC-LOCATINGTXNS">
|
||||
<ARTHEADER>
|
||||
<TITLE>Locating transactions with the "Find Transactions" dialog</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Locating transactions with the "Find Transactions" dialog</TITLE>
|
||||
<PARA> </PARA>
|
||||
<SECT2>
|
||||
<TITLE>Bill Gribble <grib@billgribble.com></TITLE>
|
||||
<ANCHOR ID="FINDOVERVIEW">
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>Overview</TITLE>
|
||||
<PARA>
|
||||
</PARA>
|
||||
<PARA>The Find Transactions dialog allows you to search for
|
||||
transactions which match criteria that you specify, including:
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> Account(s) affected by the transaction, </PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Value of the transaction,</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Date </PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Memo field</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Transaction description</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST></PARA>
|
||||
<PARA> etc.
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> You may bring up the <EMPHASIS> Find Transactions </EMPHASIS>
|
||||
dialog by clicking on the "Find" button in the main GnuCash window or
|
||||
any register display window.
|
||||
|
||||
</PARA>
|
||||
<PARA> 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".
|
||||
|
||||
</PARA>
|
||||
<PARA>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. </PARA>
|
||||
<PARA> By combining multiple searches,
|
||||
you may construct rather sophisticated queries to display exactly the
|
||||
subset of your transactions that you want to see.</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
<ANCHOR ID="HOW-TO-FIND"></PARA>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>How to use the Find Transactions dialog</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>The Find Transactions dialog has two main parts.
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> The upper
|
||||
part of the dialog is a Notebook with tabs that allow you to specify
|
||||
the conditions of your search. </PARA>
|
||||
<PARA> See <LINK LINKEND="SETUP">Setting up a
|
||||
search</LINK> for details on each search type.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>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.</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
<PARA>If you get the Find Transactions dialog by clicking the Find
|
||||
button in the main GnuCash window or any normal account display
|
||||
register, the only option available will be "New Search". If you
|
||||
select Find from within a Search Results register the other options
|
||||
will be available; see <LINK LINKEND="MODIFY">Modifying your search</LINK> for
|
||||
details.
|
||||
|
||||
</PARA>
|
||||
<PARA>Most simple queries can be directly handled by a single
|
||||
invocation of the Find Transactions dialog. The dialog has nine tabs,
|
||||
each of which represents a particular field of the transaction (or
|
||||
split) that you can search on. If you specify conditions on multiple
|
||||
fields (for example, selecting one or more accounts in the Accounts
|
||||
tab and also entering a date range in the Date tab), a transaction
|
||||
must match all the conditions you specify in order to be displayed.
|
||||
|
||||
</PARA>
|
||||
<PARA>If simple searches are not specific enough, you can combine
|
||||
them by clicking the Find button in a search results window and
|
||||
selecting any "Type of Search" except "New search".
|
||||
|
||||
<ANCHOR ID="SETUP"></PARA>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>Setting up a search</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>You can find transactions by any or all of the following
|
||||
criteria. Each one has a tab in the dialog where you may enter
|
||||
the match value(s) and comparison method.
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> Accounts affected by the transaction
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Date the transaction took place
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> The string in the Description field
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> The string in the Number field
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Amount of the transaction's splits
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> The string in the Memo field
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Number of shares in a stock transaction
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Share price in a stock transaction
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> The string in the Action field
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
<PARA>If you specify multiple criteria in the search, all of the
|
||||
criteria must be true for the transaction to be displayed.
|
||||
|
||||
<ANCHOR ID="ACCOUNTSEARCH"></PARA>
|
||||
<SECT3>
|
||||
<TITLE>Account searches</TITLE>
|
||||
<PARA>In the Account tab, select any accounts of interest and then
|
||||
choose whether transactions affecting Any, All, or None of these
|
||||
accounts is to be displayed.
|
||||
|
||||
</PARA>
|
||||
<PARA>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. </PARA>
|
||||
<PARA> For example, if you select <EMPHASIS>My
|
||||
Checking Account</EMPHASIS> and <EMPHASIS> My VISA Account</EMPHASIS> and then choose <EMPHASIS>All</EMPHASIS>, only transfers from Checking to Visa will be shown.
|
||||
|
||||
</PARA>
|
||||
<PARA>If you select "Any" from the picker, transactions affecting any
|
||||
selected amount will be shown. For example, if you select "My
|
||||
Checking Account" and "My VISA Account" and then choose "Any", your
|
||||
entire checking account and your entire Visa account will be shown
|
||||
together in the Search Results window.
|
||||
|
||||
</PARA>
|
||||
</SECT3>
|
||||
<SECT3 ID="DATE">
|
||||
<TITLE>Date searches</TITLE>
|
||||
<PARA>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 <GUIMENU> Preferences:International:Date Format</GUIMENU>.
|
||||
|
||||
</PARA>
|
||||
<PARA>If you want to locate any transaction before a certain date,
|
||||
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. </PARA>
|
||||
<PARA>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.
|
||||
|
||||
<ANCHOR ID="AMOUNT"></PARA>
|
||||
</SECT3>
|
||||
<SECT3>
|
||||
<TITLE>Amount searches</TITLE>
|
||||
<PARA>The searches in the Amount, Shares, and Price tabs allow you to
|
||||
search for particular quantities in various transaction fields. You
|
||||
need to enter both the amount (in the entry box) and the type of
|
||||
comparison (with the option menu to the left of the entry box). The
|
||||
amount in the entry box is always positive.
|
||||
|
||||
</PARA>
|
||||
<PARA>For the Amount tab, you need to indicate whether you are
|
||||
interested in debits, credits, or both.
|
||||
|
||||
<ANCHOR ID="STRING"></PARA>
|
||||
</SECT3>
|
||||
<SECT3>
|
||||
<TITLE>String searches</TITLE>
|
||||
<PARA>In the Description, Number, Memo, and Action tabs, you can
|
||||
specify a string which is matched against the respective fields of
|
||||
splits and transactions. <ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> By default, the match used is a
|
||||
case-insensitive substring match. </PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> If you select the "Case sensitive"
|
||||
toggle button, the search is a case-sensitive substring match. </PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>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.</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
<ANCHOR ID="MODIFY"></PARA>
|
||||
</SECT3>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>Modifying your search</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>Clicking the "Find" button within a Search Results window allows
|
||||
you to modify or replace the search criteria used within that window.
|
||||
The search functionality is the same, but you have new options for
|
||||
how to use the results of the search.
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>New Search.</EMPHASIS> If you select "New Search", the current
|
||||
search will be replaced with the one you specify, and the results will
|
||||
be shown in the existing Search Results window.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</SECT2>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
56
doc/sgml/C/xacc-mainwin.sgml
Normal file
56
doc/sgml/C/xacc-mainwin.sgml
Normal file
@ -0,0 +1,56 @@
|
||||
|
||||
<ARTICLE ID="XACC-MAINWIN">
|
||||
<ARTHEADER>
|
||||
<TITLE>Main Window</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Main GnuCash Window</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>This is the main account window. You control your set of
|
||||
accounts from here.
|
||||
|
||||
</PARA>
|
||||
<PARA>Below is a picture of the main window, with only the main
|
||||
accounts shown. Note how <EMPHASIS>Business Expenses</EMPHASIS> 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.
|
||||
|
||||
</PARA>
|
||||
<PARA><INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="contract.gif">
|
||||
</IMAGEOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
|
||||
|
||||
</PARA>
|
||||
<PARA>Here is the main window, with the detail accounts
|
||||
showing.
|
||||
|
||||
</PARA>
|
||||
<PARA> <INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="expand.gif">
|
||||
</IMAGEOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
|
||||
|
||||
|
||||
</PARA>
|
||||
<PARA>The <GUIMENU>Open Subaccounts</GUIMENU> 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 their
|
||||
left. By choosing the <GUIMENU>Open Subaccounts</GUIMENU> menu item, a
|
||||
general ledger window is opened, which displays all
|
||||
transactions for the lead and the detail accounts. Note that
|
||||
the general ledger window is more complicated and harder to use
|
||||
than the individual account registers. The general ledger
|
||||
window allows a more comprehensive overview of accounts in a
|
||||
smaller space. Because of its increased complexity, it use is
|
||||
recommended only for accounting experts.
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
47
doc/sgml/C/xacc-newacctwin.sgml
Normal file
47
doc/sgml/C/xacc-newacctwin.sgml
Normal file
@ -0,0 +1,47 @@
|
||||
|
||||
<ARTICLE ID="XACC-NEWACCTWIN">
|
||||
<ARTHEADER>
|
||||
<TITLE></TITLE>
|
||||
<TITLE>New Account Window</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> New Account Window</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>This is what a new account window looks like:
|
||||
|
||||
</PARA>
|
||||
<PARA><INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="newaccwin-code.gif">
|
||||
</IMAGEOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
|
||||
</PARA>
|
||||
<PARA>Pick an <LINK LINKEND="XACC-ACCTYPES"><EMPHASIS>Account
|
||||
Type</EMPHASIS></LINK>.
|
||||
|
||||
</PARA>
|
||||
<PARA>The <EMPHASIS>Currency</EMPHASIS> field should typically be a <LINK LINKEND="XACC-ISOCURR">three-letter ISO currency code</LINK>
|
||||
(<EMPHASIS>e.g.</EMPHASIS> - <ACRONYM>USD</ACRONYM> for U.S. Dollars). The <EMPHASIS>Account
|
||||
Code</EMPHASIS> is a number that determines the <LINK LINKEND="SORTORDER">sort order</LINK> of the account when
|
||||
it appears in a report or in the <LINK LINKEND="XACC-CHARTOFACCTS"><EMPHASIS> Chart of Accounts</EMPHASIS></LINK>.
|
||||
|
||||
</PARA>
|
||||
<PARA>The picture below shows an example for a stock or currency
|
||||
trading account. Note that the Security field is not grayed
|
||||
out, and that you can enter a value. That value is typically a
|
||||
<LINK LINKEND="XACC-ISOCURR">three-letter ISO currency
|
||||
code.</LINK>
|
||||
|
||||
</PARA>
|
||||
<PARA> <INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="newaccwin-trade.gif">
|
||||
</IMAGEOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
24
doc/sgml/C/xacc-pnl.sgml
Normal file
24
doc/sgml/C/xacc-pnl.sgml
Normal file
@ -0,0 +1,24 @@
|
||||
|
||||
<ARTICLE ID="XACC-PNL">
|
||||
<ARTHEADER>
|
||||
<TITLE>Profit And Loss Statement</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Profit and Loss Statement</TITLE>
|
||||
<PARA> <INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="report-pnl.gif">
|
||||
</IMAGEOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
|
||||
</PARA>
|
||||
<PARA>This report summarizes your sources of income and
|
||||
expenditure.
|
||||
|
||||
</PARA>
|
||||
<PARA>You can specify the accounting period for the report using
|
||||
the "parameters" toolbar button.
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
23
doc/sgml/C/xacc-portfolio-report.sgml
Normal file
23
doc/sgml/C/xacc-portfolio-report.sgml
Normal file
@ -0,0 +1,23 @@
|
||||
|
||||
<ARTICLE ID="XACC-PORTFOLIO-REPORT">
|
||||
<ARTHEADER>
|
||||
<TITLE>Stock Portfolio Report</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Stock Portfolio Report</TITLE>
|
||||
<PARA> <INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="report-folio.gif">
|
||||
</IMAGEOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
|
||||
</PARA>
|
||||
<PARA>This report summarizes the value of the stocks in your
|
||||
current portfolio.
|
||||
|
||||
</PARA>
|
||||
<PARA>There are currently no options for this report.
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
59
doc/sgml/C/xacc-preferences.sgml
Normal file
59
doc/sgml/C/xacc-preferences.sgml
Normal file
@ -0,0 +1,59 @@
|
||||
|
||||
<ARTICLE ID="XACC-PREFERENCES">
|
||||
<ARTHEADER>
|
||||
<TITLE>Preferences</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Preferences</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>The settings are grouped into the following categories:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Account Fields:</EMPHASIS> sets which fields are displayed in
|
||||
the account list of the main window.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Account Types:</EMPHASIS> sets which account types are
|
||||
displayed in the main window.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>General:</EMPHASIS> anything that doesn't fit anywhere
|
||||
else.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>International:</EMPHASIS> Options relating to date and time
|
||||
display formats.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Register:</EMPHASIS> Options relating to the default
|
||||
appearance of account registers.
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
59
doc/sgml/C/xacc-preferences2.sgml
Normal file
59
doc/sgml/C/xacc-preferences2.sgml
Normal file
@ -0,0 +1,59 @@
|
||||
|
||||
<ARTICLE ID="XACC-PREFERENCES2">
|
||||
<ARTHEADER>
|
||||
<TITLE>Preferences</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Preferences</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>The settings are grouped into the following categories:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Account Fields:</EMPHASIS> sets which fields are displayed in
|
||||
the account list of the main window.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Account Types:</EMPHASIS> sets which account types are
|
||||
displayed in the main window.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>General:</EMPHASIS> anything that doesn't fit anywhere
|
||||
else.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>International:</EMPHASIS> Options relating to date and time
|
||||
display formats.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Register:</EMPHASIS> Options relating to the default
|
||||
appearance of account registers.
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
118
doc/sgml/C/xacc-print-check.sgml
Normal file
118
doc/sgml/C/xacc-print-check.sgml
Normal file
@ -0,0 +1,118 @@
|
||||
|
||||
<ARTICLE ID="XACC-PRINT-CHECK">
|
||||
<ARTHEADER>
|
||||
<TITLE>Printing Checks</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Printing Checks</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>You may print a GnuCash transaction as a check by selecting
|
||||
"Print Check" from the Transaction menu in a register display
|
||||
window.
|
||||
|
||||
</PARA>
|
||||
<PARA>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
|
||||
<GUIMENU>OK</GUIMENU> will take you to the <LINK LINKEND="XACC-PRINT"> GnuCash Printing</LINK> dialog, which will allow you to preview
|
||||
the check, select a printer and paper size, and start the print
|
||||
job.
|
||||
|
||||
</PARA>
|
||||
<SECT2>
|
||||
<TITLE>Check format</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>By default, the check format is <APPLICATION>Quicken/QuickBooks</APPLICATION>,
|
||||
which prints to any Quicken-compatible check forms.
|
||||
|
||||
</PARA>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>Custom Check Format</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>If you wish to print to a type of check form that is not in
|
||||
the <GUIMENU>Check Format</GUIMENU> option menu, select <GUIMENU>Custom</GUIMENU>
|
||||
in the format menu and enter the positions of the various check
|
||||
fields in the entry boxes below.
|
||||
|
||||
</PARA>
|
||||
<PARA>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 <GUIMENU>Units</GUIMENU> option menu are used to
|
||||
interpret all values entered in the custom check format
|
||||
area.
|
||||
|
||||
</PARA>
|
||||
<PARA>If you arrive at a working set of Custom Check Format
|
||||
parameters for a commercially-available printable check form,
|
||||
please submit them to <EMAIL>gnucash-devel@gnucash.org</EMAIL> so we
|
||||
can include them as standard in a future release.
|
||||
|
||||
</PARA>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>Check position</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>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. <GUIMENU>Top</GUIMENU>,
|
||||
<GUIMENU>Middle</GUIMENU>, and <GUIMENU>Bottom</GUIMENU> should be defined
|
||||
correctly for check forms using the paper size that you select
|
||||
in the printing dialog.
|
||||
|
||||
</PARA>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>Custom check position</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>If the preset check positions do not work correctly for your
|
||||
check forms, you may choose <GUIMENU>Custom</GUIMENU> from the Check
|
||||
Position option menu and enter a position for the check in the
|
||||
<GUIMENU>Check Position</GUIMENU> 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.
|
||||
|
||||
</PARA>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>Date format</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>The <SCREEN>MM/DD/</SCREEN> and <SCREEN>DD/MM/</SCREEN> 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.
|
||||
|
||||
</PARA>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>Custom date format</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>If you wish to use another date format besides those
|
||||
available in the picker, select <GUIMENU>Custom</GUIMENU> and enter a
|
||||
date-formatting string in the <GUIMENU>Date Format</GUIMENU> entry in the
|
||||
custom settings area. If custom date format is selected, this
|
||||
string is passed to <FUNCTION>strftime(3)</FUNCTION> as a format
|
||||
specifier.
|
||||
</PARA>
|
||||
</SECT2>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
19
doc/sgml/C/xacc-print.sgml
Normal file
19
doc/sgml/C/xacc-print.sgml
Normal file
@ -0,0 +1,19 @@
|
||||
|
||||
<ARTICLE ID="XACC-PRINT">
|
||||
<ARTHEADER>
|
||||
<TITLE>Printing</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Printing</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>At present, the only type of printing directly supported by
|
||||
GnuCash is <LINK LINKEND="XACC-PRINT-CHECK">check printing</LINK>.
|
||||
Other types of printing will be added in version 1.5.
|
||||
|
||||
</PARA>
|
||||
<PARA><LINK LINKEND="XACC-REPORTS">Reports</LINK> can also be <LINK LINKEND="EXPORT">exported as HTML</LINK>.
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
2962
doc/sgml/C/xacc-project.sgml
Normal file
2962
doc/sgml/C/xacc-project.sgml
Normal file
File diff suppressed because it is too large
Load Diff
569
doc/sgml/C/xacc-qif-import.sgml
Normal file
569
doc/sgml/C/xacc-qif-import.sgml
Normal file
@ -0,0 +1,569 @@
|
||||
|
||||
<ARTICLE ID="XACC-QIF-IMPORT">
|
||||
<ARTHEADER>
|
||||
<TITLE>Importing Quicken Data Into GnuCash</TITLE>
|
||||
<AUTHOR>
|
||||
<FIRSTNAME>Bill</FIRSTNAME>
|
||||
<SURNAME>Gribble</SURNAME>
|
||||
</AUTHOR>
|
||||
</ARTHEADER>
|
||||
<SECT1 ID="QIF">
|
||||
<TITLE> Importing Quicken data into GnuCash</TITLE>
|
||||
<SECT2 ID="OVERVIEW">
|
||||
<TITLE>Overview</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>Quicken is one of the best-selling programs in the history of
|
||||
the Universe. Pretty much everyone that has owned a PC or Mac since
|
||||
the late 80's has had a copy of it lying around somewhere, and lots of
|
||||
people actually use it to keep track of their finances. Why? Because
|
||||
it works pretty well and Intuit has (to their credit) done a good job
|
||||
of keeping up with what people want the program to do.
|
||||
|
||||
</PARA>
|
||||
<PARA>They've done such a good job, in fact, that lots of Linux folks
|
||||
keep a Windows partition on their machine just so they can run Quicken
|
||||
and the latest shoot-em-up games. So of course we want to give you a
|
||||
way to suck all your Quicken data into GnuCash and remove one more
|
||||
barrier to putting a nice <FUNCTION> ext2 </FUNCTION> filesystem on that Windows
|
||||
partition.
|
||||
|
||||
</PARA>
|
||||
<PARA>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, most critically, is severely flawed in its datamodel, that is, <EMPHASIS> what it saves in
|
||||
data files.</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
<PARA> 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.
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> QIF files omit small things that may be fairly accurately inferred by
|
||||
examining the data.
|
||||
|
||||
</PARA>
|
||||
<PARA> For instance, are numbers in decimal-radix [1,000.00 ==
|
||||
1000] form or European comma-radix form [1.000,00 == 1000]? </PARA>
|
||||
<PARA> Or are
|
||||
dates <SCREEN> m/d/y </SCREEN> or <SCREEN> y/m/d</SCREEN>?
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> More problematic are major things where there is little way of
|
||||
guessing.
|
||||
|
||||
</PARA>
|
||||
<PARA> For instance, determining the currency the file is denominated in.
|
||||
|
||||
</PARA>
|
||||
<PARA> Or what <EMPHASIS> account </EMPHASIS> the file describes.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST></PARA>
|
||||
<PARA> GnuCash's QIF importer does a remarkably good job of guessing what
|
||||
it can, but you <EMPHASIS> do </EMPHASIS> have to keep an eye on it. Fortunately,
|
||||
the system is designed so that you can correct problems <EMPHASIS> before</EMPHASIS> you changes are dropped into your GnuCash accounts. Nothing is
|
||||
done to your GnuCash accounts until you click the final "OK" button.
|
||||
|
||||
</PARA>
|
||||
<PARA>In the next section, I'll give an overview of the QIF file and
|
||||
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.
|
||||
|
||||
</PARA>
|
||||
<PARA>There are two major "paths" for using the GnuCash QIF importer.
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> One is the "I am a Quicken user just migrating to GnuCash" path.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> The other is the "I am downloading some updates from my bank as a
|
||||
QIF file" path.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
<PARA> 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.
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT2>
|
||||
<SECT2 ID="INTRO">
|
||||
<TITLE>Introduction to the QIF file</TITLE>
|
||||
<PARA>
|
||||
</PARA>
|
||||
<PARA>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. </PARA>
|
||||
<PARA> Don't be afraid to pop up a QIF file using <APPLICATION> less </APPLICATION>
|
||||
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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>Here's a typical Quicken transaction record:
|
||||
<LITERAL REMAP="TT"><MSGTEXT>
|
||||
<LITERALLAYOUT> !Type:Bank
|
||||
D6/20/97
|
||||
T-500
|
||||
N1012
|
||||
C*
|
||||
M
|
||||
P
|
||||
L[Visa]
|
||||
^
|
||||
</LITERALLAYOUT>
|
||||
</MSGTEXT></LITERAL>
|
||||
|
||||
</PARA>
|
||||
<PARA>The ! tag denotes the start of a section of records of a
|
||||
certain type. In this case, Bank transactions. Type:Cat means
|
||||
a section of Category descriptions, Account means account
|
||||
descriptions, and so on.
|
||||
|
||||
</PARA>
|
||||
<PARA>The D tag denotes the date. Note y2k compliance "issue".
|
||||
Here's a lovely "feature" of some version of Quicken and dates in
|
||||
2000:
|
||||
<LITERAL REMAP="TT"><MSGTEXT>
|
||||
<LITERALLAYOUT> D1/ 1' 0
|
||||
T-640.00
|
||||
CX
|
||||
N511
|
||||
PJoe Bob
|
||||
LRent:Apartment
|
||||
^
|
||||
</LITERALLAYOUT>
|
||||
</MSGTEXT></LITERAL>
|
||||
|
||||
</PARA>
|
||||
<PARA>Ouch! Fortunately the GnuCash QIF importer can handle all of
|
||||
the wacky date formats that the gnucash-devel list can find.
|
||||
|
||||
</PARA>
|
||||
<PARA>The T field is the "Total" amount of the transaction. If there
|
||||
are splits, the sum of all the split amounts is in a T field. Money
|
||||
going out of the account is negative.
|
||||
|
||||
</PARA>
|
||||
<PARA>The N field is a "Number", which is usually a check number or
|
||||
some other identifying number for the transaction.
|
||||
|
||||
</PARA>
|
||||
<PARA>The C field represents the clearing/reconciliation state of the
|
||||
transaction. An x or X in this field means the transaction is
|
||||
"Cleared", a * means the transaction is Reconciled.
|
||||
|
||||
</PARA>
|
||||
<PARA>The M field is the transaction memo.
|
||||
|
||||
</PARA>
|
||||
<PARA>The P field is the Payee.
|
||||
|
||||
</PARA>
|
||||
<PARA>The L field is the Category/Account line. If the value in this
|
||||
field is enclosed in square brackets, like [Visa], this transaction is
|
||||
a transfer to the Quicken account named Visa. If there are no square
|
||||
brackets, the transaction is in the named Category (like
|
||||
Rent:Apartment).
|
||||
|
||||
</PARA>
|
||||
<PARA>The ^ tag means End of Record.
|
||||
|
||||
</PARA>
|
||||
<PARA>Quicken users taking advantage of Classes will see a slash (/)
|
||||
character followed by the class name appended on the Category line
|
||||
(like [Visa]/Project)
|
||||
|
||||
</PARA>
|
||||
<PARA>If a transaction has "splits", meaning that it is a single
|
||||
transaction with "this" account but is "split" into multiple
|
||||
source/destination accounts, the splits are described with S fields
|
||||
for the category/account/class of each split, an $ field for the
|
||||
amount of the split, and an E field for a per-split memo. The total
|
||||
of all the $ fields in a transaction record should equal the T field.
|
||||
|
||||
</PARA>
|
||||
<PARA>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 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:
|
||||
|
||||
<LITERAL REMAP="TT"><MSGTEXT>
|
||||
<LITERALLAYOUT> !Type:Bank
|
||||
D12/03/95
|
||||
T4,706.57
|
||||
CX
|
||||
POpening Balance
|
||||
L[New Bank]
|
||||
^
|
||||
</LITERALLAYOUT>
|
||||
</MSGTEXT></LITERAL>
|
||||
|
||||
</PARA>
|
||||
<PARA>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 <LINK LINKEND="DIALOG-ACCOUNTS">Accounts Tab</LINK> section there's a discussion
|
||||
of what we do with them.
|
||||
|
||||
</PARA>
|
||||
<SECT3>
|
||||
<TITLE>Multi-account Quicken exports</TITLE>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
<ANCHOR ID="HOW-TO-QIF"></PARA>
|
||||
</SECT3>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>How to use the QIF Import dialog</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
|
||||
</PARA>
|
||||
<PARA>Why you need to load all your files at the same time:
|
||||
|
||||
</PARA>
|
||||
<PARA>There are two different types of QIF files: those that describe
|
||||
single accounts and those that describe multiple accounts. Both kinds
|
||||
to try to be "complete" in representing all the transactions involving
|
||||
each account that they represent. What this means is that if you have
|
||||
multiple Quicken accounts, with transfers between them, transactions
|
||||
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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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
|
||||
importer's <LINK LINKEND="DIALOG-FILES">Files tab</LINK> will allow you to
|
||||
load as many QIF files as you want, and to make sure that the
|
||||
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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>Once you have loaded all the files into the importer, go to the
|
||||
<LINK LINKEND="DIALOG-ACCOUNTS">Accounts tab</LINK>, and then to the <LINK LINKEND="DIALOG-CATEGORIES">Categories tab</LINK>, 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 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
|
||||
accounts you won't have to correct the importer again.
|
||||
|
||||
</PARA>
|
||||
<PARA>Make sure (especially in the Accounts tab) that the QIF account
|
||||
names and transaction counts make sense to you. If you see that one
|
||||
QIF account is mentioned by two different names, make sure that the
|
||||
"QIF Account" for every file in the Files tab is what you meant it to
|
||||
be. If the QIF Account for a file is wrong, the importer won't be
|
||||
able to match up transfers correctly and your balances will be wrong.
|
||||
If a QIF Account for a file is wrong, select the file in the Files tab,
|
||||
unmark the "Auto" checkbox, and edit the text box to contain the right
|
||||
name, then click "Load File" again. You will be asked to confirm a
|
||||
reload of the file and then it will be done. Flip back to the
|
||||
Accounts tab, see if that fixed the problem, repeat as necessary.
|
||||
|
||||
</PARA>
|
||||
<PARA>When you are happy with the account mappings (double check
|
||||
them, and make sure to save your GnuCash session first just to be
|
||||
sure), then and only then click OK. If you click Cancel at any time,
|
||||
your accounts will not be touched.
|
||||
|
||||
</PARA>
|
||||
<PARA>Again, the importer is written mostly in Guile, and it can be a
|
||||
little slow on large QIF files. It takes 3-4 seconds to stuff 1000
|
||||
transactions into GnuCash on a Celeron 433, proportionately longer on
|
||||
slower CPUs. You only have to do a large import like that a few
|
||||
times, fortunately, so I'm not too worried about it.
|
||||
|
||||
<ANCHOR ID="DIALOG-FILES"></PARA>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>The "Files" Tab</TITLE>
|
||||
<PARA>
|
||||
</PARA>
|
||||
<PARA>The first thing to do is load all your files. Click "Select
|
||||
File", pick your file, then set the account, currency, radix, and date
|
||||
fields, then click "Load File". The Currency field defaults to the
|
||||
GnuCash default currency (set in the International tab of the
|
||||
Preferences dialog). Try autodetecting radix, date format, and
|
||||
account name first. The radix and date formats will stay on
|
||||
"Autodetect" if the autodetector is not 100 percent sure of the right
|
||||
answer; in that case, you will have to make a manual selection. You
|
||||
probably know what the correct radix format is; if you're in the US or
|
||||
the UK, it's definitely "decimal". Almost every QIF file I have seen
|
||||
in the US is m/d/y for the date format, so try that if auto-detect
|
||||
doesn't work.
|
||||
|
||||
</PARA>
|
||||
<PARA>To go back to a file that you have previously loaded, select
|
||||
its name in the file list on the left. If you change settings for a
|
||||
previously-loaded file, click "Load File" again to reload it with new
|
||||
settings. Don't forget to turn off "Auto" on the QIF Account entry if
|
||||
you manually enter it.
|
||||
|
||||
</PARA>
|
||||
<PARA>If there's no Opening Balance record in the file, the account
|
||||
name is guessed from the file name: any .qif extension is removed, and
|
||||
all dashes and underscores are changed to spaces. If you want to save
|
||||
yourself manually re-entering the name, save the file with a name that
|
||||
will get guessed correctly (i.e. save the account "My Bank Account" as
|
||||
My-Bank-Account.qif or My_Bank_Account.qif).
|
||||
|
||||
<ANCHOR ID="DIALOG-ACCOUNTS"></PARA>
|
||||
</SECT2>
|
||||
<SECT2 ID="DIALOG-CATEGORIES">
|
||||
<TITLE>The "Accounts" and "Categories" Tabs</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>Each line in the Accounts tab display represents a mapping from
|
||||
a Quicken account to a GnuCash account. Similarly, the Categories tab
|
||||
display shows mappings from Quicken categories to GnuCash
|
||||
accounts. Only QIF accounts referenced by one or more transaction
|
||||
records are displayed. The name of the GnuCash account is displayed
|
||||
in "full name" format, including the names of all parent accounts
|
||||
separated by your default separator character (generally ":").
|
||||
|
||||
</PARA>
|
||||
<PARA>The first thing to check is the column of Quicken account
|
||||
names. Make sure there are no duplicates with slightly-different
|
||||
names. If a QIF transaction makes a transfer to [My Checking], and
|
||||
you imported a file called my-checking.qif, you might have one account
|
||||
entry for "my checking" and one for "My Checking". If these are the
|
||||
same account, you need to go back to the Files tab and reload
|
||||
my-checking.qif with the correct Quicken account name, My Checking.
|
||||
|
||||
</PARA>
|
||||
<PARA>Once you have all the Quicken accounts making sense, check the
|
||||
GnuCash account column. The default GnuCash account for a given
|
||||
Quicken account is determined by a fallback procedure which makes the
|
||||
best guess it can given the available information. The guesses that
|
||||
are tried are (in order of preference):
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Saved mappings from previous import sessions. Each time you
|
||||
click "OK" in the import dialog, the mappings that you have selected
|
||||
are saved for the next time you import files. At the moment, the file
|
||||
is always called ~/.gnucash/qif-accounts-map. If you get some weird
|
||||
default mappings (for instance, if you change an account name and the
|
||||
importer wants to keep creating a new account with the old name) just
|
||||
delete this file. It's on my wishlist to make this work a little
|
||||
more smoothly.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Similar accounts from your existing GnuCash account tree.
|
||||
"Similar" means that the account types are compatible and the names
|
||||
could reasonably be assumed to refer to the same thing. Full-path
|
||||
exact name matches are preferred most, followed by case-insensitive
|
||||
matches, followed by matches with prepended account parents (i.e.
|
||||
QIF account Visa matches GnuCash account Credit Cards:Visa), followed
|
||||
by various substring matches. If you think of a good heuristic
|
||||
for this, let me know.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>New account. The name of the new account is currently just
|
||||
the same as the name of the Quicken account; again, if you think of a
|
||||
good heuristic to make this better let me know. I've thought about
|
||||
making it look for subtrees to insert into (if all existing credit
|
||||
card accounts are children of an account, make the new account a child
|
||||
of that account, etc). On the wishlist.
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
<PARA>Check both the name of the GnuCash account for each QIF account
|
||||
and the type. If you are unhappy with either, click on the row in the
|
||||
display containing the offensive mapping. You will see the
|
||||
<LINK LINKEND="DIALOG-PICKER">Account Picker </LINK>dialog which will allow you
|
||||
to change it.
|
||||
|
||||
<ANCHOR ID="DIALOG-PICKER"></PARA>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>The Account Picker</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>This account picker is sort of broken. The idea is that you
|
||||
can select an existing account from the tree display, or enter
|
||||
information for a new account in the boxes below. However, right now
|
||||
it's possible to do Very Bad things like specify a subaccount of an
|
||||
existing account with a type that's not compatible with the parent.
|
||||
As soon as I figure out how I want this dialog to work I'll fix it. I
|
||||
have tested out the worst things that you can do and nothing terrible
|
||||
happens, except your account tree might be in a state that you could
|
||||
never have created through the GUI (a Credit Card account as a child
|
||||
of a Bank account, for example). Don't do that. I'll fix it Real
|
||||
Soon.
|
||||
|
||||
<ANCHOR ID="OK-BUTTON"></PARA>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>The "OK" Button</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>Everything really happens when you hit the "OK" button, so it
|
||||
gets a section to itself.
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>First we do a "mark and sweep" to eliminate the duplicated
|
||||
halves of transfers in the loaded Quicken transactions.
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>A GnuCash account tree is created which mirrors
|
||||
your existing tree and includes any new accounts added by your
|
||||
Accounts and Categories mappings.
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>All the QIF transactions are converted into GnuCash splits and
|
||||
stuffed into the new account tree.
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Finally, the GnuCash engine is asked to merge the old account
|
||||
tree with the new account tree.
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
<ANCHOR ID="MOREHINTS"></PARA>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>More hints</TITLE>
|
||||
<PARA> <ANCHOR ID="OPENING-BALANCE"></PARA>
|
||||
<SECT3>
|
||||
<TITLE>Opening Balance</TITLE>
|
||||
<PARA>If your Quicken files have "Opening Balance" records, you will
|
||||
see an account called "Opening Balance" in the Accounts tab.
|
||||
Accounting for the source of opening balances is sort of a hassle,
|
||||
when you think about it, because they come from accounts that are
|
||||
outside the scope of the GnuCash universe. The suggestion I've seen
|
||||
on the gnucash-devel list is to make Opening Balances point to a
|
||||
GnuCash account called "Retained Earnings", of type Equity. I don't
|
||||
exactly understand this but it seems reasonable, and it's the default
|
||||
for accounts called "Opening Balance".
|
||||
|
||||
<ANCHOR ID="EMPTY-CATEGORY"></PARA>
|
||||
</SECT3>
|
||||
<SECT3>
|
||||
<TITLE>Empty category</TITLE>
|
||||
<PARA>In the Categories display, you may notice a blank QIF Category
|
||||
entry. Quicken transactions are not required to have a Category, but
|
||||
GnuCash transactions are required to have a source and a destination.
|
||||
The blank category lets you select which GnuCash account all
|
||||
uncategorized transactions go to. This will generally be
|
||||
miscellaneous checks you have written, cash withdrawals, and so on, so
|
||||
you probably want to put these in a "Misc Expenses" account or
|
||||
something similar. It may make sense to put this in an equity
|
||||
account; let me know if there's a good explanation for how it should
|
||||
be.
|
||||
|
||||
<ANCHOR ID="DIVIDEND-CATEGORY"></PARA>
|
||||
</SECT3>
|
||||
<SECT3>
|
||||
<TITLE>Dividend category</TITLE>
|
||||
<PARA>Quicken stock transactions have a recognizable pattern for
|
||||
dividend payments. If the importer can definitely tell that a
|
||||
transaction is a transfer from dividends then it will default to
|
||||
creating a "Dividend" income account. This category is usually not
|
||||
present in the Quicken file, so it's being manufactured out of
|
||||
nowhere.
|
||||
|
||||
<ANCHOR ID="FUND-FAMILIES"></PARA>
|
||||
</SECT3>
|
||||
<SECT3>
|
||||
<TITLE>Fund families</TITLE>
|
||||
<PARA>Quicken has the abstraction of a single account representing a
|
||||
"fund family" for the purpose of allowing smooth transfers between the
|
||||
various accounts administered within the family. The GnuCash Importer
|
||||
will ALWAYS get this wrong the first time, because Quicken explicitly
|
||||
puts the wrong information in the file. The "blanket" account
|
||||
representing the fund family as a whole should probably be a Bank
|
||||
account, since the transfers to and from it in the Quicken file are
|
||||
denominated in currency, not shares. The balance of such an account
|
||||
is supposed to always be 0 since you just use it as an intermediary
|
||||
between two accounts in the family. Hopefully I'll fix this at some
|
||||
point if someone tells me how it's supposed to work.
|
||||
|
||||
<ANCHOR ID="BROKERAGE-ACCOUNTS"></PARA>
|
||||
</SECT3>
|
||||
<SECT3>
|
||||
<TITLE>Brokerage accounts</TITLE>
|
||||
<PARA>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
|
||||
account, you can lose the information about where the dividend came
|
||||
from. The importer tries to save this information by putting the
|
||||
security name in the Payee slot (which shows up in the GnuCash
|
||||
Description field for the transaction). If you have a better idea,
|
||||
let me know.
|
||||
|
||||
</PARA>
|
||||
</SECT3>
|
||||
</SECT2>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
204
doc/sgml/C/xacc-quicken.sgml
Normal file
204
doc/sgml/C/xacc-quicken.sgml
Normal file
@ -0,0 +1,204 @@
|
||||
|
||||
<ARTICLE ID="XACC-QUICKEN">
|
||||
<ARTHEADER>
|
||||
<TITLE>A Guide for Former Users of Quicken</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1 ID="XACC-QUICKENGUIDE">
|
||||
<TITLE> Quicken (TM) User's Guide</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-QUICKENCATS">
|
||||
<TITLE> Quicken Categories</TITLE>
|
||||
<PARA>What Quicken calls <EMPHASIS>Categories</EMPHASIS> are
|
||||
really just <LINK LINKEND="XACC-EXPENSE">Income/Expense
|
||||
accounts. </LINK> 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
|
||||
that as the name of the account.
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-QIF">
|
||||
<TITLE> Quicken QIF File Import</TITLE>
|
||||
<PARA> GnuCash supports the import of Quicken
|
||||
Import Files (QIF). (Note: Only Quicken Version 3.0 QIF has
|
||||
been formally tested so far.)
|
||||
|
||||
</PARA>
|
||||
<PARA>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 <EMPHASIS>all</EMPHASIS> of the accounts you might have had in
|
||||
Quicken.
|
||||
|
||||
</PARA>
|
||||
<PARA>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 <EMPHASIS>different</EMPHASIS> set of
|
||||
account names that you might be using in GnuCash.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<SECT2>
|
||||
<TITLE>Creating QIF Files</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>To create a set of Quicken <FILENAME>QIF</FILENAME> files, perform the
|
||||
following procedure:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> Start Quicken.
|
||||
|
||||
</PARA>
|
||||
<PARA>It works on <ULINK URL="http://www.winehq.com/">Wine,</ULINK>
|
||||
Caldera's Wabi, and doubtless on VMWare, so this may not
|
||||
forcibly require that you run Windows.
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Select the account that you wish to export.
|
||||
|
||||
</PARA>
|
||||
<PARA>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 <EMPHASIS>less</EMPHASIS> tedious than entering
|
||||
the data from scratch.)
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Choose the menu <GUIMENU>File</GUIMENU> and select the <GUIMENU> Export...</GUIMENU> menu entry.
|
||||
|
||||
</PARA>
|
||||
<PARA>This will provide a dialog that requests a filename,
|
||||
effective dates, as well as a series of checkboxes,
|
||||
including <GUIMENU>Transactions</GUIMENU>, <GUIMENU>Accounts List</GUIMENU>,
|
||||
<GUIMENU>Category List</GUIMENU>, and so forth.
|
||||
|
||||
</PARA>
|
||||
<PARA>For best results, you should make sure that those three
|
||||
are checked.
|
||||
|
||||
</PARA>
|
||||
<PARA>If you do <EMPHASIS>not</EMPHASIS> check the <GUIMENU>Accounts List</GUIMENU>
|
||||
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.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
Now you have a set of <FILENAME>.QIF</FILENAME> files, and should run
|
||||
GnuCash.
|
||||
|
||||
</PARA>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>Loading QIF files into GnuCash</TITLE>
|
||||
<PARA> <ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>To import a Quicken QIF file, choose the menu <GUIMENU> File</GUIMENU> and select the entry <GUIMENU>Import QIF</GUIMENU>.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>The imported file will be merged with whatever other data
|
||||
you currently have in GnuCash. The merge allows multiple
|
||||
Quicken accounts to be imported and merged into one account
|
||||
group.
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</SECT2>
|
||||
<SECT2>
|
||||
<TITLE>Things To Note About QIF Import</TITLE>
|
||||
<PARA> <ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> <EMPHASIS>Duplicate Entry Scanning</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
<PARA>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 <EMPHASIS>exactly.</EMPHASIS> Thus, the merge <EMPHASIS> should</EMPHASIS> 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.
|
||||
|
||||
</PARA>
|
||||
<PARA>This unfortunately <EMPHASIS>can</EMPHASIS> occur, the typical
|
||||
scenario involving where you make multiple withdrawals of
|
||||
identical amounts from ATM machines on the same day.
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> <EMPHASIS>Empty Accounts</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
<PARA>Note that when the <GUIMENU>Accounts List</GUIMENU> and <GUIMENU> Category List</GUIMENU> is exported from Quicken, <EMPHASIS>all</EMPHASIS>
|
||||
accounts and categories will be exported, even if they are
|
||||
empty and contain no transactions. When these are imported,
|
||||
they will appear as accounts with a balance of zero. If you
|
||||
do not plan to use such accounts, feel free to delete them.
|
||||
Future enhancements may allow you to delete them "en
|
||||
masse," or to make them invisible without deleting
|
||||
them.
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> <EMPHASIS>QIF Mark II</EMPHASIS> 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.
|
||||
|
||||
</PARA>
|
||||
<PARA>At this point, it successfully parses <FILENAME>QIF</FILENAME>
|
||||
files; what remains is the (rather complex task) of
|
||||
determine appropriate correspondences between the Quicken
|
||||
<EMPHASIS>Categories</EMPHASIS> and the GnuCash equivalents. That is one
|
||||
of the most significant weaknesses with the present QIF
|
||||
import scheme.
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> <EMPHASIS>More about QIF</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
<PARA>Further details about the QIF Interchange Format may be
|
||||
found <LINK LINKEND="QIF"> here.</LINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT2>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
118
doc/sgml/C/xacc-recnwin.sgml
Normal file
118
doc/sgml/C/xacc-recnwin.sgml
Normal file
@ -0,0 +1,118 @@
|
||||
|
||||
<ARTICLE ID="XACC-RECNWIN">
|
||||
<ARTHEADER>
|
||||
<TITLE>Reconciliation Window</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Reconciliation Window</TITLE>
|
||||
<PARA>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 <GUIMENU>OK</GUIMENU>
|
||||
. The window will then show all unreconciled transactions since
|
||||
your last bank statement. The reconcile window looks like
|
||||
this:
|
||||
|
||||
</PARA>
|
||||
<PARA> <INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="recnwin.gif">
|
||||
</IMAGEOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>For example, when you write a check for something, you
|
||||
should enter the transaction into GnuCash.
|
||||
|
||||
</PARA>
|
||||
<PARA>At the end of the month, you receive your bank statement,
|
||||
perhaps including canceled checks. At <EMPHASIS>that</EMPHASIS> point, you
|
||||
should "reconcile" the account, that is, agree your personal
|
||||
records to the documentation provided by the bank.
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Open the reconcile window, and GnuCash will prompt you to
|
||||
enter the ending balance from the bank statement.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Then the reconcile window will pop-up, and you will see a
|
||||
credit and a debit column that lists all the non-reconciled
|
||||
transactions.
|
||||
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Now, examine each item on the bank statement.
|
||||
|
||||
</PARA>
|
||||
<PARA>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 <ENVAR>n</ENVAR> to <ENVAR>c</ENVAR>, indicating the
|
||||
transaction
|
||||
has <EMPHASIS>c</EMPHASIS>cleared.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>At the bottom of the window is a difference field, which
|
||||
should be $0.00 when you are done reconciling. If it isn't,
|
||||
then you have either missed transactions, or some amounts may
|
||||
be incorrect in GnuCash. (Or, probably rather less likely,
|
||||
the bank may have made an error.)
|
||||
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>When you have completed marking off all the items on the
|
||||
bank statement, and when the difference heads to $0.00, you
|
||||
should press <GUIMENU>Ok</GUIMENU>, then the <ENVAR>n</ENVAR> or <ENVAR>c</ENVAR>
|
||||
in the transactions that were checked off will change to a
|
||||
<ENVAR>y</ENVAR>, indicating that they have been validated to agree
|
||||
between the bank statement and your own records.
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
<PARA>When you change anything in a transaction that has been
|
||||
reconciled, a dialog box warning you that such changes are
|
||||
unwise should pop up, but this doesn't seem to happen
|
||||
anymore.
|
||||
|
||||
</PARA>
|
||||
<PARA>Also, the "cleared" total at the bottom seems to display
|
||||
<SCREEN>$0.00</SCREEN> regardless of what transactions are cleared or
|
||||
reconciled.
|
||||
|
||||
</PARA>
|
||||
<PARA>The "cleared" total should display the total of only the
|
||||
transactions that have been cleared (<ENVAR>c</ENVAR>) or reconciled
|
||||
(<ENVAR>y</ENVAR>).
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
74
doc/sgml/C/xacc-regwin-kbd.sgml
Normal file
74
doc/sgml/C/xacc-regwin-kbd.sgml
Normal file
@ -0,0 +1,74 @@
|
||||
|
||||
<ARTICLE ID="XACC-REGWIN-KBD">
|
||||
<ARTHEADER>
|
||||
<TITLE>Register Keyboard Shortcuts</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1 ID="XACC-REGKEYSC">
|
||||
<TITLE> Register Keyboard Shortcuts</TITLE>
|
||||
<PARA> The following keys can be used to move around in the register:
|
||||
<EMPHASIS>Please check that I didn't miss any</EMPHASIS>
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA><KEYCAP>Right Arrow, Left Arrow</KEYCAP>move left and right
|
||||
within one field
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><KEYCAP>Home</KEYCAP> move to the left of the field
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><KEYCAP>End</KEYCAP> move to the right of the field
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><KEYCAP>TAB</KEYCAP> move to the next field
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><KEYCAP>Shift + TAB</KEYCAP> move to the previous field
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><KEYCAP>Enter, Down Arrow</KEYCAP> move to the next transaction
|
||||
(if necessary, a new blank transaction will be created)
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><KEYCAP>Up Arrow</KEYCAP> move to the previous transaction
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><KEYCAP>Page Up</KEYCAP> move up one screenful
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><KEYCAP>Page Down</KEYCAP> move down one screenful
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><KEYCAP>Shift + Page Up</KEYCAP>Go to the first transaction
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><KEYCAP>Shift + Page Down</KEYCAP>Go to the blank (last)
|
||||
transaction
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
261
doc/sgml/C/xacc-regwin.sgml
Normal file
261
doc/sgml/C/xacc-regwin.sgml
Normal file
@ -0,0 +1,261 @@
|
||||
|
||||
<ARTICLE ID="XACC-REGWIN">
|
||||
<ARTHEADER>
|
||||
<TITLE>Register Window</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Register Window</TITLE>
|
||||
<PARA> <INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="regwin-single.gif">
|
||||
</IMAGEOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
|
||||
</PARA>
|
||||
<PARA>This is the "Register" or the "Ledger" window. Transactions
|
||||
are entered here.
|
||||
|
||||
</PARA>
|
||||
<PARA>To enter a new transaction, just type into the last blank
|
||||
transaction. As well as just typing them in, ou can use can use
|
||||
the <LINK LINKEND="DATE">Date Accelerator keys</LINK> to
|
||||
quickly enter dates. Use the mouse or the <LINK LINKEND="XACC-REGWIN-KBD">Register Keyboard Shortcuts</LINK>to move
|
||||
between fields, and hit the Enter key or click record to record
|
||||
the transaction:
|
||||
<INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="regwin-single2.gif">
|
||||
</IMAGEOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
|
||||
</PARA>
|
||||
<PARA>Notice how a the transaction has been recorded and a new,
|
||||
blank transaction has been created.
|
||||
|
||||
</PARA>
|
||||
<PARA>You can edit existing transactions in a similar manner.
|
||||
GnuCash will prompt you to confirm any changes you make.
|
||||
|
||||
</PARA>
|
||||
<PARA>After you have entered a few transactions, GnuCash will try
|
||||
to guess some or all of the remaining details of a transaction
|
||||
when you type into the "Description" field. If GnuCash has
|
||||
guessed wrong, simply type over or delete the incorrect
|
||||
information and replace it with the correct information.
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-MANTXN">
|
||||
<TITLE> Manipulating transactions</TITLE>
|
||||
<PARA>You can manipulate transactions with the toolbar or the
|
||||
"Transaction" menu:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Delete:</EMPHASIS> you can delete a transaction or an
|
||||
individual split.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Cancel:</EMPHASIS> this reverts any changes you have made to
|
||||
the transaction you are currently entering/changing
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>New:</EMPHASIS> this moves the cursor to the last line of the
|
||||
register where new transactions are entered
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Jump:</EMPHASIS> When placed over an existing transaction, it
|
||||
takes you to the corresponding register entry in the other
|
||||
register entry that this transaction appears in
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Transfer:</EMPHASIS>This is an alternative way to enter a
|
||||
transaction. You can do a transfer between any two accounts
|
||||
without opening up other registers.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Close:</EMPHASIS>Closes this register
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-VIEWTXN">
|
||||
<TITLE> Viewing Transactions</TITLE>
|
||||
<PARA>The register can show transactions in a variety of different
|
||||
ways, controlled by entries on the "Register" menu.
|
||||
|
||||
</PARA>
|
||||
<PARA>The register can display transactions in several different
|
||||
styles:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>single-line mode:</EMPHASIS> transactions are displayed on a
|
||||
single line.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>double-line mode:</EMPHASIS> transactions are displayed over
|
||||
two lines, with more information about each transaction
|
||||
shown.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>multi-line mode:</EMPHASIS> 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).
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>auto-single and auto-double modes</EMPHASIS> 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.
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
<PARA>To change the display style, to go the "Register" menu and
|
||||
select "style".
|
||||
|
||||
</PARA>
|
||||
<PARA>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".
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-RECONCILIATION">
|
||||
<TITLE> Reconciliation</TITLE>
|
||||
<PARA>Transactions are typically checked against bank statements -
|
||||
a process known as "reconciliation". GnuCash keeps track of the
|
||||
reconciliation status of each transaction.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>Reconciliation can be done in the <LINK LINKEND="XACC-RECNWIN">Reconcile Window</LINK>
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-STKPTLO">
|
||||
<TITLE> Stock Portfolios</TITLE>
|
||||
<PARA>You can do stock transactions either from a single-stock
|
||||
window, or from a portfolio-view window, shown below.
|
||||
|
||||
</PARA>
|
||||
<PARA><INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="foliowin.gif">
|
||||
</IMAGEOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
<INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="foliowin-single.gif">
|
||||
</IMAGEOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
|
||||
</PARA>
|
||||
<PARA>The portfolio ledger can seem a bit daunting at first
|
||||
sight.
|
||||
|
||||
</PARA>
|
||||
<PARA>If you have trouble understanding it, then you may wish to
|
||||
create an account for each stock you wish to track.
|
||||
|
||||
</PARA>
|
||||
<PARA>Some important points to remember about the portfolio
|
||||
window:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> It shows <EMPHASIS>all</EMPHASIS> stocks in your portfolio, not just
|
||||
one.
|
||||
|
||||
</PARA>
|
||||
<PARA>The share amounts shown are for each particular
|
||||
stock.
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Note that it uses a two line display.
|
||||
|
||||
</PARA>
|
||||
<PARA>Debited accounts and debited amounts are on the upper
|
||||
line, and credited amounts and accounts are on the lower
|
||||
line.
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>If you buy or sell a stock with money from the brokerage
|
||||
account, the total balance will not change, since the value
|
||||
of the stock equals the amount of money exchanged.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>If you buy or sell a stock with money from the brokerage
|
||||
account, the value of the transaction will appear twice, once
|
||||
in red, and once in black. If shares are purchased, the
|
||||
amount of money debited from the brokerage account will be in
|
||||
red, and the value of the shares in black. If shares are
|
||||
sold, then value of the shares is in red, and the money
|
||||
credited to the brokerage account in black.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>If you are having trouble indicating a share
|
||||
purchase/sale in the portfolio ledger, then make sure that
|
||||
<EMPHASIS>Transfer From</EMPHASIS> and <EMPHASIS>Transfer To</EMPHASIS> accounts are in
|
||||
the right order. A transfer from a stock account is always
|
||||
interpreted as a sale, even if you entered the data as a
|
||||
purchase. The vice-versa is also true.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Eventually, an alternative simpler portfolio ledger
|
||||
window may be provided.
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
140
doc/sgml/C/xacc-reports.sgml
Normal file
140
doc/sgml/C/xacc-reports.sgml
Normal file
@ -0,0 +1,140 @@
|
||||
|
||||
<ARTICLE ID="XACC-REPORTS">
|
||||
<ARTHEADER>
|
||||
<TITLE>Reports</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> Reports</TITLE>
|
||||
<PARA>A variety of financial reports can be selected on the
|
||||
"Reports" menu":
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-BALANCESHEET">Balance Sheet:</LINK>shows
|
||||
Assets, Liabilities and Equity.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-PNL">Profit And Loss State:</LINK>shows
|
||||
Income and expenses over a selectable period.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-TRANS-REPORT">Transaction
|
||||
Report</LINK>shows transactions in an account, presented in a
|
||||
variety of ways.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-PORTFOLIO-REPORT">Stock Portfolio</LINK>
|
||||
provides a quick summary of your stocks, their current value,
|
||||
and profits made.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><APPLICATION>Balance Tracker</APPLICATION>
|
||||
tracks the balance of one or more accounts over time, and
|
||||
supports graphical output (if you have <APPLICATION>gnuplot</APPLICATION>
|
||||
installed).
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-REPORTWINDOW">
|
||||
<TITLE> The Report Window</TITLE>
|
||||
<PARA> Once you select a report, a report window will appear:
|
||||
|
||||
</PARA>
|
||||
<PARA><INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="reportwin.gif">
|
||||
</IMAGEOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
|
||||
</PARA>
|
||||
<PARA>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:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Back</EMPHASIS> and <EMPHASIS>Forward</EMPHASIS> allow you to view the
|
||||
previous contents of the window, just like a web browser
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> <EMPHASIS>Parameters</EMPHASIS> pops up a dialog box allowing you to
|
||||
change the information presented in the report:
|
||||
|
||||
</PARA>
|
||||
<PARA><INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="report-option.gif">
|
||||
</IMAGEOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
|
||||
</PARA>
|
||||
<PARA>See the help for the individual reports for details of
|
||||
options available.
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><ANCHOR ID="EXPORT"><EMPHASIS>Export</EMPHASIS> allows you to export the
|
||||
contents of the report as a HTML file for later viewing or
|
||||
printing.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Close</EMPHASIS> closes the report window.
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-CUSTOMREPORTS">
|
||||
<TITLE> Constructing custom reports</TITLE>
|
||||
<PARA> 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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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.
|
||||
|
||||
</PARA>
|
||||
<PARA>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).
|
||||
|
||||
</PARA>
|
||||
<PARA>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 <ULINK URL="mailto:gnucash-devel@gnucash.org"> gnucash-devel@gnucash.org</ULINK>.
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
292
doc/sgml/C/xacc-ticker.sgml
Normal file
292
doc/sgml/C/xacc-ticker.sgml
Normal file
@ -0,0 +1,292 @@
|
||||
|
||||
<ARTICLE ID="XACC-TICKER">
|
||||
<ARTHEADER>
|
||||
<TITLE>Stock Ticker</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1 ID="XACC-STOCKTICKER">
|
||||
<TITLE> Stock Pricing and Ticker Symbols</TITLE>
|
||||
<PARA> GnuCash provides a somewhat rudimentary automated stock quote
|
||||
gathering system.
|
||||
|
||||
</PARA>
|
||||
<PARA>If a GnuCash <LINK LINKEND="STOCKACCT">stock
|
||||
account</LINK> is suitably configured, and the host computer is
|
||||
connected to the Internet, the program <APPLICATION>gnc-prices</APPLICATION> may
|
||||
be used to load stock and mutual fund price quotes from various
|
||||
web sites directly into GnuCash.
|
||||
|
||||
</PARA>
|
||||
<PARA>To make use of this facility, the following must be
|
||||
done:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Create an account and mark it as being of type "Mutual
|
||||
Fund" or "Stock".
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Enter a valid ticker symbol in the box marked
|
||||
"Security:"
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Select a quote source from the pull-down menu. Currently
|
||||
supported quote sources include <EMPHASIS>Yahoo</EMPHASIS>, <EMPHASIS>Yahoo
|
||||
Europe</EMPHASIS>, <EMPHASIS>Fidelity Investments</EMPHASIS>, <EMPHASIS>T. Rowe
|
||||
Price</EMPHASIS>, the <EMPHASIS>Vanguard Group</EMPHASIS>, <EMPHASIS>the Australian Stock
|
||||
Exchange</EMPHASIS> (ASX) and <EMPHASIS>TIAA-CREF</EMPHASIS>. Note that Yahoo will
|
||||
provide price quotes for many mutual funds <EMPHASIS>including</EMPHASIS>
|
||||
Fidelity, T.Rowe Price and Vanguard, and that the quoted
|
||||
prices at Yahoo <EMPHASIS>should</EMPHASIS> be identical to those that may
|
||||
be found at the source sites (otherwise, somebody's reporting
|
||||
wrong information!). If you choose Yahoo Europe, you should
|
||||
append the market code for the security, such as PA for
|
||||
Paris, BE for Berlin, etc. Example: 12150.PA (a Peugeot
|
||||
security in the Paris market).
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> Ensure that the currency of the account matches the source
|
||||
of the stock you have selected. This means:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA>Quotes from the <EMPHASIS>Australian Stock Exchange</EMPHASIS>
|
||||
(ASX) should be in Australian dollars (AUD).
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Quotes from <EMPHASIS>Yahoo Europe</EMPHASIS> should be in Euros
|
||||
(ECU)
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA>Quotes from <EMPHASIS>Yahoo</EMPHASIS>, <EMPHASIS>Fidelity
|
||||
Investments</EMPHASIS>, <EMPHASIS>T. Rowe Price</EMPHASIS> and the <EMPHASIS>Vanguard
|
||||
Group</EMPHASIS> should be in US Dollars (USD).
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
<TABLE>
|
||||
<TITLE> Code list for European markets
|
||||
</TITLE>
|
||||
<TGROUP COLS="2">
|
||||
<THEAD>
|
||||
<ROW>
|
||||
<ENTRY>Code</ENTRY>
|
||||
<ENTRY>Market</ENTRY>
|
||||
</ROW>
|
||||
</THEAD>
|
||||
<TBODY>
|
||||
<ROW>
|
||||
<ENTRY>PA</ENTRY>
|
||||
<ENTRY>Paris</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>BC</ENTRY>
|
||||
<ENTRY>Barcelona</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>BE</ENTRY>
|
||||
<ENTRY>Berlin</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>BI</ENTRY>
|
||||
<ENTRY>Bilbao</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>BR</ENTRY>
|
||||
<ENTRY>Brême</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>CO</ENTRY>
|
||||
<ENTRY>Copenhagen</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>D</ENTRY>
|
||||
<ENTRY>Dusseldorf</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>F</ENTRY>
|
||||
<ENTRY>Frankfurt</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>H</ENTRY>
|
||||
<ENTRY>Hamburg</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>HA</ENTRY>
|
||||
<ENTRY>Hanover</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>L</ENTRY>
|
||||
<ENTRY>London</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>MA</ENTRY>
|
||||
<ENTRY>Madrid</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>MC</ENTRY>
|
||||
<ENTRY>Madrid (M.C.)</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>MI</ENTRY>
|
||||
<ENTRY>Milan</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>MU</ENTRY>
|
||||
<ENTRY>Munich</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>O</ENTRY>
|
||||
<ENTRY>Oslo</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>ST</ENTRY>
|
||||
<ENTRY>Stockholm</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>SG</ENTRY>
|
||||
<ENTRY>Stuttgart</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>VA</ENTRY>
|
||||
<ENTRY>Valence</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>FX</ENTRY>
|
||||
<ENTRY>Xetra</ENTRY>
|
||||
</ROW>
|
||||
</TBODY>
|
||||
</TGROUP>
|
||||
</TABLE>
|
||||
|
||||
<TABLE>
|
||||
<TITLE> Pseudo-symbols that can be used for TIAA-CREF quotes.
|
||||
</TITLE>
|
||||
<TGROUP COLS="2">
|
||||
<THEAD>
|
||||
<ROW>
|
||||
<ENTRY>Name</ENTRY>
|
||||
<ENTRY>Pseudo-symbol</ENTRY>
|
||||
</ROW>
|
||||
</THEAD>
|
||||
<TBODY>
|
||||
<ROW>
|
||||
<ENTRY>Stock</ENTRY>
|
||||
<ENTRY>CREFstok</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Money Market</ENTRY>
|
||||
<ENTRY>CREFmony</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Equity Index</ENTRY>
|
||||
<ENTRY>CREFequi</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Inflation-Linked Bond</ENTRY>
|
||||
<ENTRY>CREFinfb</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Bond Market</ENTRY>
|
||||
<ENTRY>CREFbond</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>TIAA Real Estate</ENTRY>
|
||||
<ENTRY>TIAAreal</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Social Choice</ENTRY>
|
||||
<ENTRY>CREFsoci</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Teachers PA Stock Index</ENTRY>
|
||||
<ENTRY>TIAAsndx</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Global Equities</ENTRY>
|
||||
<ENTRY>CREFglob</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Teachers PA Select Stock</ENTRY>
|
||||
<ENTRY>TIAAsele</ENTRY>
|
||||
</ROW>
|
||||
<ROW>
|
||||
<ENTRY>Growth</ENTRY>
|
||||
<ENTRY>CREFgrow</ENTRY>
|
||||
</ROW>
|
||||
</TBODY>
|
||||
</TGROUP>
|
||||
</TABLE>
|
||||
|
||||
</PARA>
|
||||
<PARA>A sample image is shown below:
|
||||
<INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="ticker-a.gif">
|
||||
</IMAGEOBJECT>
|
||||
<TEXTOBJECT>
|
||||
<PHRASE>Sample Diagram</PHRASE>
|
||||
</TEXTOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
|
||||
</PARA>
|
||||
<PARA>To update the prices stored in a gnucash account file, run
|
||||
the command line command <APPLICATION>gnc-price</APPLICATION>, specifying the
|
||||
filename; for example:
|
||||
<COMMAND> gnc-prices myaccts.xac</COMMAND>
|
||||
|
||||
</PARA>
|
||||
<PARA>Running this command will print various diagnostic messages
|
||||
to the screen while it loads data. It will work only when the
|
||||
host computer is attached to the Internet. It can function in
|
||||
conjunction with masquerading-style firewalls and proxy
|
||||
servers.
|
||||
|
||||
</PARA>
|
||||
<PARA>The command can be run many times in one day; however, it
|
||||
will update the accounts at most once with the most recent
|
||||
trading days price data.
|
||||
|
||||
</PARA>
|
||||
<PARA>Thus, if <APPLICATION>gnc-prices</APPLICATION> is run on Friday, Saturday,
|
||||
Sunday and Monday, only two price entries will be made: one
|
||||
containing Friday's data, and one containing Monday's data,
|
||||
since the Saturday and Sunday runs will only retrieve the
|
||||
Friday closing price.
|
||||
|
||||
</PARA>
|
||||
<PARA>To keep <APPLICATION>gnc-prices</APPLICATION> from updating one account, while
|
||||
allowing it to update another account, merely mark the data
|
||||
source for that account as <SCREEN>(none)</SCREEN>. You can do this
|
||||
from the <GUIMENU>Edit Account</GUIMENU> window.
|
||||
|
||||
</PARA>
|
||||
<PARA>After running <APPLICATION>gnc-prices</APPLICATION> for a few days, your
|
||||
accounts will begin to resemble the following:
|
||||
<INLINEMEDIAOBJECT>
|
||||
<IMAGEOBJECT>
|
||||
<IMAGEDATA FILEREF="ticker-b.gif">
|
||||
</IMAGEOBJECT>
|
||||
<TEXTOBJECT>
|
||||
<PHRASE>Later Ticker Listing</PHRASE>
|
||||
</TEXTOBJECT>
|
||||
</INLINEMEDIAOBJECT>
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
141
doc/sgml/C/xacc-trans-report.sgml
Normal file
141
doc/sgml/C/xacc-trans-report.sgml
Normal file
@ -0,0 +1,141 @@
|
||||
|
||||
<ARTICLE ID="XACC-TRANS-REPORT">
|
||||
<ARTHEADER>
|
||||
<TITLE>Transaction Report</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1 ID="XACC-TXNREPORTS">
|
||||
<TITLE> Transaction Report</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>Transaction reports list details for transactions in a
|
||||
specified account over a specified period, in a convenient
|
||||
format for viewing and exporting.
|
||||
|
||||
</PARA>
|
||||
<PARA>Options specifiable for this report include:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA> <EMPHASIS>Display:</EMPHASIS>Select fields to display in the report. The
|
||||
choices include:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Date</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Number</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Description</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Memo</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Account</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Other Account</EMPHASIS>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Amount</EMPHASIS> - note that you can choose a
|
||||
single-column or two-column amount display. Two column
|
||||
displays credits and debits in separate columns.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Column Headers</EMPHASIS> - labels naming the fields
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Totals</EMPHASIS> - numeric fields will be totalled.
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> <EMPHASIS>Report Options:</EMPHASIS> This is for general report options,
|
||||
including:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Date To and Date From:</EMPHASIS> the date range for the
|
||||
report to cover.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Account:</EMPHASIS> the account(s) to do the report
|
||||
on.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Style:</EMPHASIS> Choose from either single-line (in
|
||||
which all transactions will be displayed on a single
|
||||
line), or multi-line (on which each split of a
|
||||
transaction is displayed on a separate line).
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> <EMPHASIS>Sorting:</EMPHASIS>
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Primary Sort Key:</EMPHASIS> the field to sort on
|
||||
first.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Primary Sort Order:</EMPHASIS> the order in which to
|
||||
sort. "Ascending" specifies smallest/largest,
|
||||
alphabetical ordering, earliest->latest, or smallest
|
||||
amounts first. Descending produces the opposite
|
||||
effects.
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Secondary Sort Key:</EMPHASIS> the field to sort on if
|
||||
the primary sort keys are equal
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><EMPHASIS>Secondary Sort Order:</EMPHASIS> the ordering on which to
|
||||
sort the secondary key.
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
166
doc/sgml/C/xacc-userdocs.sgml
Normal file
166
doc/sgml/C/xacc-userdocs.sgml
Normal file
@ -0,0 +1,166 @@
|
||||
|
||||
<ARTICLE ID="XACC-USERDOCS">
|
||||
<ARTHEADER>
|
||||
<TITLE>GnuCash Help Main Window</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> User Documentation Overview</TITLE>
|
||||
<PARA> For help on a specific topic:
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-ABOUT">About GnuCash</LINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-ACCTYPES">Account Types</LINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-APAR">Accounts Payable and Accounts
|
||||
Receivable</LINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-CHARTOFACCTS">Chart of Accounts</LINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-NEWACCTWIN">Creating a new
|
||||
account</LINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="DATE">Date Input</LINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-DEPRECIATION">Depreciation and Capital
|
||||
Gains</LINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="CURRENCY">Foreign Currency
|
||||
Accounts</LINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-EURO">GnuCash and the EURO</LINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><ULINK URL="bofa-mym.html">Importing MYM (Managing Your
|
||||
Money) Files</ULINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-QIF-IMPORT">A Guide for Former Users
|
||||
of Quicken(TM)</LINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA> <LINK LINKEND="XACC-GPL">License - GPL</LINK>
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="SEC003">Warranty</LINK>
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-MAINWIN">The Main Window</LINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-RECNWIN">The Reconcile Window</LINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-REGWIN">The Register Window</LINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-TICKER">Stock Ticker</LINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="DOUBLE">Using Double Entry</LINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-EXPENSE">Using Income/Expense
|
||||
Accounts</LINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="USERPREF">Personalising
|
||||
Gnucash</LINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-ACCOUNTEDIT">Changing Account
|
||||
Properties</LINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-Y2K">Y2K Considerations</LINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-REPORTS">Reports</LINK>
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
<SECT1 ID="XACC-EXTHELP">
|
||||
<TITLE> Extended Help/System Documentation</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>The following documentation is about the <EMPHASIS> implementation</EMPHASIS> of GnuCash as opposed to being <EMPHASIS>user
|
||||
documentation</EMPHASIS> on how to <EMPHASIS>use</EMPHASIS> it.
|
||||
|
||||
</PARA>
|
||||
<PARA>Some of it represents preliminary documentation for
|
||||
subsystems that are not yet sufficiently functional for use by
|
||||
end users.
|
||||
|
||||
<ITEMIZEDLIST>
|
||||
<LISTITEM>
|
||||
<PARA><ULINK URL="projects.html">GnuCash Project Goals</ULINK>
|
||||
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
<LISTITEM>
|
||||
<PARA><LINK LINKEND="XACC-PRINT">Printing</LINK>
|
||||
</PARA>
|
||||
</LISTITEM>
|
||||
</ITEMIZEDLIST>
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
50
doc/sgml/C/xacc-y2k.sgml
Normal file
50
doc/sgml/C/xacc-y2k.sgml
Normal file
@ -0,0 +1,50 @@
|
||||
<ARTICLE ID="XACC-Y2K">
|
||||
<ARTHEADER>
|
||||
<TITLE>GnuCash Y2K Readiness</TITLE>
|
||||
</ARTHEADER>
|
||||
<SECT1>
|
||||
<TITLE> GnuCash Y2K Readiness</TITLE>
|
||||
<PARA> </PARA>
|
||||
<PARA>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 <EMPHASIS>too</EMPHASIS> many orders of magnitude outside
|
||||
cosmologists' estimations of the age of the universe.
|
||||
|
||||
</PARA>
|
||||
<PARA>The file format for version 1.1.25 and later stores dates in
|
||||
the above-described fashion.
|
||||
|
||||
</PARA>
|
||||
<PARA>Some internal routines use the <FUNCTION>time_t</FUNCTION> 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
|
||||
<FUNCTION>time_t</FUNCTION> will migrate to the use of 64 bit values by
|
||||
that time.
|
||||
|
||||
</PARA>
|
||||
<PARA>Backup and log files are time-stamped using the standard
|
||||
Unix <FUNCTION>ctime()</FUNCTION> routine, which takes a <FUNCTION>time_t</FUNCTION>
|
||||
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.
|
||||
|
||||
</PARA>
|
||||
<PARA>Note that GnuCash also correctly recognizes February 29th,
|
||||
2000 as a "leap day," another of the "critical Y2K dates."
|
||||
|
||||
</PARA>
|
||||
<PARA>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...
|
||||
|
||||
</PARA>
|
||||
<PARA>Y2K issues are described in more detail at <ULINK URL="http://www.ntlug.org/~cbbrowne/linuxy2k.html">Linux and Year
|
||||
2000.</ULINK>
|
||||
|
||||
|
||||
</PARA>
|
||||
</SECT1>
|
||||
</ARTICLE>
|
||||
5
doc/sgml/Makefile.am
Normal file
5
doc/sgml/Makefile.am
Normal file
@ -0,0 +1,5 @@
|
||||
|
||||
SUBDIRS = C
|
||||
|
||||
EXTRA_DIST = \
|
||||
.cvsignore
|
||||
333
doc/sgml/Makefile.in
Normal file
333
doc/sgml/Makefile.in
Normal file
@ -0,0 +1,333 @@
|
||||
# Makefile.in generated automatically by automake 1.4 from Makefile.am
|
||||
|
||||
# Copyright (C) 1994, 1995-8, 1999 Free Software Foundation, Inc.
|
||||
# This Makefile.in is free software; the Free Software Foundation
|
||||
# gives unlimited permission to copy and/or distribute it,
|
||||
# with or without modifications, as long as this notice is preserved.
|
||||
|
||||
# This program is distributed in the hope that it will be useful,
|
||||
# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
|
||||
# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
|
||||
# PARTICULAR PURPOSE.
|
||||
|
||||
|
||||
SHELL = @SHELL@
|
||||
|
||||
srcdir = @srcdir@
|
||||
top_srcdir = @top_srcdir@
|
||||
VPATH = @srcdir@
|
||||
prefix = @prefix@
|
||||
exec_prefix = @exec_prefix@
|
||||
|
||||
bindir = @bindir@
|
||||
sbindir = @sbindir@
|
||||
libexecdir = @libexecdir@
|
||||
datadir = @datadir@
|
||||
sysconfdir = @sysconfdir@
|
||||
sharedstatedir = @sharedstatedir@
|
||||
localstatedir = @localstatedir@
|
||||
libdir = @libdir@
|
||||
infodir = @infodir@
|
||||
mandir = @mandir@
|
||||
includedir = @includedir@
|
||||
oldincludedir = /usr/include
|
||||
|
||||
DESTDIR =
|
||||
|
||||
pkgdatadir = $(datadir)/@PACKAGE@
|
||||
pkglibdir = $(libdir)/@PACKAGE@
|
||||
pkgincludedir = $(includedir)/@PACKAGE@
|
||||
|
||||
top_builddir = ../..
|
||||
|
||||
ACLOCAL = @ACLOCAL@
|
||||
AUTOCONF = @AUTOCONF@
|
||||
AUTOMAKE = @AUTOMAKE@
|
||||
AUTOHEADER = @AUTOHEADER@
|
||||
|
||||
INSTALL = @INSTALL@
|
||||
INSTALL_PROGRAM = @INSTALL_PROGRAM@ $(AM_INSTALL_PROGRAM_FLAGS)
|
||||
INSTALL_DATA = @INSTALL_DATA@
|
||||
INSTALL_SCRIPT = @INSTALL_SCRIPT@
|
||||
transform = @program_transform_name@
|
||||
|
||||
NORMAL_INSTALL = :
|
||||
PRE_INSTALL = :
|
||||
POST_INSTALL = :
|
||||
NORMAL_UNINSTALL = :
|
||||
PRE_UNINSTALL = :
|
||||
POST_UNINSTALL = :
|
||||
host_alias = @host_alias@
|
||||
host_triplet = @host@
|
||||
AS = @AS@
|
||||
CATALOGS = @CATALOGS@
|
||||
CATOBJEXT = @CATOBJEXT@
|
||||
CC = @CC@
|
||||
DATADIRNAME = @DATADIRNAME@
|
||||
DLLTOOL = @DLLTOOL@
|
||||
GENCAT = @GENCAT@
|
||||
GLIB_CFLAGS = @GLIB_CFLAGS@
|
||||
GLIB_CONFIG_BIN = @GLIB_CONFIG_BIN@
|
||||
GLIB_LIBS = @GLIB_LIBS@
|
||||
GMOFILES = @GMOFILES@
|
||||
GMSGFMT = @GMSGFMT@
|
||||
GNC_CONFIGDIR = @GNC_CONFIGDIR@
|
||||
GNC_DOC_INSTALL_DIR = @GNC_DOC_INSTALL_DIR@
|
||||
GNC_LIBDIR = @GNC_LIBDIR@
|
||||
GNC_SCM_INSTALL_DIR = @GNC_SCM_INSTALL_DIR@
|
||||
GNC_SHAREDIR = @GNC_SHAREDIR@
|
||||
GNOME_CFLAGS = @GNOME_CFLAGS@
|
||||
GNOME_CONFIG_BIN = @GNOME_CONFIG_BIN@
|
||||
GNOME_LIBS = @GNOME_LIBS@
|
||||
GNOME_STATIC_TARGET = @GNOME_STATIC_TARGET@
|
||||
GNOME_TARGET = @GNOME_TARGET@
|
||||
GT_NO = @GT_NO@
|
||||
GT_YES = @GT_YES@
|
||||
GUILE = @GUILE@
|
||||
GUILE_COMPILE_ARGS = @GUILE_COMPILE_ARGS@
|
||||
GUILE_CONFIG = @GUILE_CONFIG@
|
||||
GUILE_LINK_ARGS = @GUILE_LINK_ARGS@
|
||||
G_WRAP = @G_WRAP@
|
||||
G_WRAP_COMPILE_ARGS = @G_WRAP_COMPILE_ARGS@
|
||||
G_WRAP_CONFIG = @G_WRAP_CONFIG@
|
||||
G_WRAP_LINK_ARGS = @G_WRAP_LINK_ARGS@
|
||||
INCLUDE_LOCALE_H = @INCLUDE_LOCALE_H@
|
||||
INSTOBJEXT = @INSTOBJEXT@
|
||||
INTLDEPS = @INTLDEPS@
|
||||
INTLLIBS = @INTLLIBS@
|
||||
INTLOBJS = @INTLOBJS@
|
||||
LIBTOOL = @LIBTOOL@
|
||||
LN_S = @LN_S@
|
||||
LOCALE_DIR = @LOCALE_DIR@
|
||||
MAKEINFO = @MAKEINFO@
|
||||
MKINSTALLDIRS = @MKINSTALLDIRS@
|
||||
MSGFMT = @MSGFMT@
|
||||
OBJDUMP = @OBJDUMP@
|
||||
PACKAGE = @PACKAGE@
|
||||
PERL = @PERL@
|
||||
PERLINCL = @PERLINCL@
|
||||
POFILES = @POFILES@
|
||||
POSUB = @POSUB@
|
||||
RANLIB = @RANLIB@
|
||||
SWIG = @SWIG@
|
||||
USE_INCLUDED_LIBINTL = @USE_INCLUDED_LIBINTL@
|
||||
USE_NLS = @USE_NLS@
|
||||
VERSION = @VERSION@
|
||||
l = @l@
|
||||
|
||||
SUBDIRS = C
|
||||
|
||||
EXTRA_DIST = .cvsignore
|
||||
|
||||
mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs
|
||||
CONFIG_HEADER = ../../config.h
|
||||
CONFIG_CLEAN_FILES =
|
||||
DIST_COMMON = Makefile.am Makefile.in
|
||||
|
||||
|
||||
DISTFILES = $(DIST_COMMON) $(SOURCES) $(HEADERS) $(TEXINFOS) $(EXTRA_DIST)
|
||||
|
||||
TAR = gtar
|
||||
GZIP_ENV = --best
|
||||
all: all-redirect
|
||||
.SUFFIXES:
|
||||
$(srcdir)/Makefile.in: Makefile.am $(top_srcdir)/configure.in $(ACLOCAL_M4)
|
||||
cd $(top_srcdir) && $(AUTOMAKE) --gnu doc/sgml/Makefile
|
||||
|
||||
Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status $(BUILT_SOURCES)
|
||||
cd $(top_builddir) \
|
||||
&& CONFIG_FILES=$(subdir)/$@ CONFIG_HEADERS= $(SHELL) ./config.status
|
||||
|
||||
|
||||
# This directory's subdirectories are mostly independent; you can cd
|
||||
# into them and run `make' without going through this Makefile.
|
||||
# To change the values of `make' variables: instead of editing Makefiles,
|
||||
# (1) if the variable is set in `config.status', edit `config.status'
|
||||
# (which will cause the Makefiles to be regenerated when you run `make');
|
||||
# (2) otherwise, pass the desired values on the `make' command line.
|
||||
|
||||
@SET_MAKE@
|
||||
|
||||
all-recursive install-data-recursive install-exec-recursive \
|
||||
installdirs-recursive install-recursive uninstall-recursive \
|
||||
check-recursive installcheck-recursive info-recursive dvi-recursive:
|
||||
@set fnord $(MAKEFLAGS); amf=$$2; \
|
||||
dot_seen=no; \
|
||||
target=`echo $@ | sed s/-recursive//`; \
|
||||
list='$(SUBDIRS)'; for subdir in $$list; do \
|
||||
echo "Making $$target in $$subdir"; \
|
||||
if test "$$subdir" = "."; then \
|
||||
dot_seen=yes; \
|
||||
local_target="$$target-am"; \
|
||||
else \
|
||||
local_target="$$target"; \
|
||||
fi; \
|
||||
(cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \
|
||||
|| case "$$amf" in *=*) exit 1;; *k*) fail=yes;; *) exit 1;; esac; \
|
||||
done; \
|
||||
if test "$$dot_seen" = "no"; then \
|
||||
$(MAKE) $(AM_MAKEFLAGS) "$$target-am" || exit 1; \
|
||||
fi; test -z "$$fail"
|
||||
|
||||
mostlyclean-recursive clean-recursive distclean-recursive \
|
||||
maintainer-clean-recursive:
|
||||
@set fnord $(MAKEFLAGS); amf=$$2; \
|
||||
dot_seen=no; \
|
||||
rev=''; list='$(SUBDIRS)'; for subdir in $$list; do \
|
||||
rev="$$subdir $$rev"; \
|
||||
test "$$subdir" = "." && dot_seen=yes; \
|
||||
done; \
|
||||
test "$$dot_seen" = "no" && rev=". $$rev"; \
|
||||
target=`echo $@ | sed s/-recursive//`; \
|
||||
for subdir in $$rev; do \
|
||||
echo "Making $$target in $$subdir"; \
|
||||
if test "$$subdir" = "."; then \
|
||||
local_target="$$target-am"; \
|
||||
else \
|
||||
local_target="$$target"; \
|
||||
fi; \
|
||||
(cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \
|
||||
|| case "$$amf" in *=*) exit 1;; *k*) fail=yes;; *) exit 1;; esac; \
|
||||
done && test -z "$$fail"
|
||||
tags-recursive:
|
||||
list='$(SUBDIRS)'; for subdir in $$list; do \
|
||||
test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) tags); \
|
||||
done
|
||||
|
||||
tags: TAGS
|
||||
|
||||
ID: $(HEADERS) $(SOURCES) $(LISP)
|
||||
list='$(SOURCES) $(HEADERS)'; \
|
||||
unique=`for i in $$list; do echo $$i; done | \
|
||||
awk ' { files[$$0] = 1; } \
|
||||
END { for (i in files) print i; }'`; \
|
||||
here=`pwd` && cd $(srcdir) \
|
||||
&& mkid -f$$here/ID $$unique $(LISP)
|
||||
|
||||
TAGS: tags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) $(LISP)
|
||||
tags=; \
|
||||
here=`pwd`; \
|
||||
list='$(SUBDIRS)'; for subdir in $$list; do \
|
||||
if test "$$subdir" = .; then :; else \
|
||||
test -f $$subdir/TAGS && tags="$$tags -i $$here/$$subdir/TAGS"; \
|
||||
fi; \
|
||||
done; \
|
||||
list='$(SOURCES) $(HEADERS)'; \
|
||||
unique=`for i in $$list; do echo $$i; done | \
|
||||
awk ' { files[$$0] = 1; } \
|
||||
END { for (i in files) print i; }'`; \
|
||||
test -z "$(ETAGS_ARGS)$$unique$(LISP)$$tags" \
|
||||
|| (cd $(srcdir) && etags $(ETAGS_ARGS) $$tags $$unique $(LISP) -o $$here/TAGS)
|
||||
|
||||
mostlyclean-tags:
|
||||
|
||||
clean-tags:
|
||||
|
||||
distclean-tags:
|
||||
-rm -f TAGS ID
|
||||
|
||||
maintainer-clean-tags:
|
||||
|
||||
distdir = $(top_builddir)/$(PACKAGE)-$(VERSION)/$(subdir)
|
||||
|
||||
subdir = doc/sgml
|
||||
|
||||
distdir: $(DISTFILES)
|
||||
here=`cd $(top_builddir) && pwd`; \
|
||||
top_distdir=`cd $(top_distdir) && pwd`; \
|
||||
distdir=`cd $(distdir) && pwd`; \
|
||||
cd $(top_srcdir) \
|
||||
&& $(AUTOMAKE) --include-deps --build-dir=$$here --srcdir-name=$(top_srcdir) --output-dir=$$top_distdir --gnu doc/sgml/Makefile
|
||||
@for file in $(DISTFILES); do \
|
||||
d=$(srcdir); \
|
||||
if test -d $$d/$$file; then \
|
||||
cp -pr $$d/$$file $(distdir)/$$file; \
|
||||
else \
|
||||
test -f $(distdir)/$$file \
|
||||
|| ln $$d/$$file $(distdir)/$$file 2> /dev/null \
|
||||
|| cp -p $$d/$$file $(distdir)/$$file || :; \
|
||||
fi; \
|
||||
done
|
||||
for subdir in $(SUBDIRS); do \
|
||||
if test "$$subdir" = .; then :; else \
|
||||
test -d $(distdir)/$$subdir \
|
||||
|| mkdir $(distdir)/$$subdir \
|
||||
|| exit 1; \
|
||||
chmod 777 $(distdir)/$$subdir; \
|
||||
(cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) top_distdir=../$(top_distdir) distdir=../$(distdir)/$$subdir distdir) \
|
||||
|| exit 1; \
|
||||
fi; \
|
||||
done
|
||||
info-am:
|
||||
info: info-recursive
|
||||
dvi-am:
|
||||
dvi: dvi-recursive
|
||||
check-am: all-am
|
||||
check: check-recursive
|
||||
installcheck-am:
|
||||
installcheck: installcheck-recursive
|
||||
install-exec-am:
|
||||
install-exec: install-exec-recursive
|
||||
|
||||
install-data-am:
|
||||
install-data: install-data-recursive
|
||||
|
||||
install-am: all-am
|
||||
@$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
|
||||
install: install-recursive
|
||||
uninstall-am:
|
||||
uninstall: uninstall-recursive
|
||||
all-am: Makefile
|
||||
all-redirect: all-recursive
|
||||
install-strip:
|
||||
$(MAKE) $(AM_MAKEFLAGS) AM_INSTALL_PROGRAM_FLAGS=-s install
|
||||
installdirs: installdirs-recursive
|
||||
installdirs-am:
|
||||
|
||||
|
||||
mostlyclean-generic:
|
||||
|
||||
clean-generic:
|
||||
|
||||
distclean-generic:
|
||||
-rm -f Makefile $(CONFIG_CLEAN_FILES)
|
||||
-rm -f config.cache config.log stamp-h stamp-h[0-9]*
|
||||
|
||||
maintainer-clean-generic:
|
||||
mostlyclean-am: mostlyclean-tags mostlyclean-generic
|
||||
|
||||
mostlyclean: mostlyclean-recursive
|
||||
|
||||
clean-am: clean-tags clean-generic mostlyclean-am
|
||||
|
||||
clean: clean-recursive
|
||||
|
||||
distclean-am: distclean-tags distclean-generic clean-am
|
||||
-rm -f libtool
|
||||
|
||||
distclean: distclean-recursive
|
||||
|
||||
maintainer-clean-am: maintainer-clean-tags maintainer-clean-generic \
|
||||
distclean-am
|
||||
@echo "This command is intended for maintainers to use;"
|
||||
@echo "it deletes files that may require special tools to rebuild."
|
||||
|
||||
maintainer-clean: maintainer-clean-recursive
|
||||
|
||||
.PHONY: install-data-recursive uninstall-data-recursive \
|
||||
install-exec-recursive uninstall-exec-recursive installdirs-recursive \
|
||||
uninstalldirs-recursive all-recursive check-recursive \
|
||||
installcheck-recursive info-recursive dvi-recursive \
|
||||
mostlyclean-recursive distclean-recursive clean-recursive \
|
||||
maintainer-clean-recursive tags tags-recursive mostlyclean-tags \
|
||||
distclean-tags clean-tags maintainer-clean-tags distdir info-am info \
|
||||
dvi-am dvi check check-am installcheck-am installcheck install-exec-am \
|
||||
install-exec install-data-am install-data install-am install \
|
||||
uninstall-am uninstall all-redirect all-am all installdirs-am \
|
||||
installdirs mostlyclean-generic distclean-generic clean-generic \
|
||||
maintainer-clean-generic clean mostlyclean distclean maintainer-clean
|
||||
|
||||
|
||||
# Tell versions [3.59,3.63) of GNU make to not export all variables.
|
||||
# Otherwise a system limit (for SysV at least) may be exceeded.
|
||||
.NOEXPORT:
|
||||
Loading…
Reference in New Issue
Block a user