.\"{{{}}}
.\"{{{  Title
.TH GACC 1 "Jul 26, 2000" "" "Personnal Bank Accounts Manager"
.\"}}}
.\"{{{  Name
.SH NAME
gAcc \- manages personnal bank accounts
.\"}}}
.\"{{{  Synopsis
.SH SYNOPSIS
.B gacc
.RB [ \-h ]
.RB [ \-v ]
.RB "[ \-\fBf\fP \fIfilename\fP ]"
.br
.\"}}}
.\"{{{  Description
.SH DESCRIPTION
.B gAcc
is a small personnal bank accounts manager. Its goal is to keep easy to use
with as much functionnalities as needed. The program loads the global
configuration file \fB/etc/gaccrc\fP and then loads personnal configuration and
the default (last) accounts wallet file. When gAcc loads, you can tell it to
directly open the last account you modified.
.PP
.B gAcc
functionnalities are next :
.br
\- Account editing
.br
\- Operation editing
.br
\- Operation search
.br
\- Operations printing
.br
\- Graphics
.br
\- Euro convertion
.br
\- Locales definitions
.br
\- Human readable definitions and wallet files
.br
\- ...
.PP
.\"}}}
.\"{{{  Options
.SH OPTIONS
.IP \fB\-h\fP
Help / usage.
.IP \fB\-v\fP
Display version number
.IP "\fB\-f\fP \fIfilename\fP"
Specify the accounts wallet file to load for modifications.
.\"}}}
.\"{{{  Overview
.SH OVERVIEW
.TP 4
.B 1. Getting started
Once you have compiled and installed gAcc without any problem, just launch
it and it'll create it's own default configuration directory and file, and show
you a window called "the accounts list". This is a list of the accounts you have
put in the wallet file. Of course, the first time you launch gAcc, you have no
wallet file.
.br
You can try an example provided with the gAcc package or create your own
new wallet file. To do so, you just have to add new accounts to the list and
then save the file. Take also a look to the preferences menus to set up gAcc
as you want.
.br
After that you can start to add new operations to any of your accounts.
.br
Note that not all of the functions are implemented.
.TP 4
.B 2. Accounts
An accounts is composed of several elements. First its name by with you
can know what account it is. Then its number, given by your bank. Next the
bank where you opened it. The opening balance is the amount you have put in
it at the opening or creation in gAcc. At last there is its operations list.
The operations list is the mean to remember the operation you've done with this
account and to keep you in mind how much there is left on this accounts.
.br
The Accounts list which is displayed in the main window contains 4 columns
that are for the name of the account, the bank where it is, its cleared
operation's amount (that must be equal to your bank statement) and its balance.
All accounts are listed in their entering order. Accounts the balance is below
0.0 have their last column in red.
.br
You can execute some functions on each account :
.br
\- Open its operations list
.br
\- Edit its informations
.br
\- Delete it
.br
\- Add a new account
.br
\- Graph its list of operations (Only account and operations graph by now).
.br
There are a few means to execute the functions you want. First there is a
menu entry in the menu bar. But the others are attached to each mouse button :
.br
\- button 1 (left), when double-clicked, displays the account's operations list
.br
\- button 2 (middle) displays the account's informations
.br
\- button 3 (right), when double-clicked, displays a context pop-up menu that
is similar to the menu in the menu bar.
.TP 4
.B 3. Operations
An operation is composed of 8 elements. A number for a cheque, an object to
know why you did that operation, the date when you bought/sold that thing, the
amount of the transaction, the medium specifying how you did it, an entry saying
if it's a credit or a debit operation, a flag to know if it is cleared or not,
a category, a third party, and finaly a splits list.
.br
The operations window that is displayed when ou open an account's list of
operations contains 8 columns. The first is the date when you did the operation,
next comes the number of the operation/cheque, after is the object or reason why
you did that operation, then comes the category in which you classify that
operation, the fifth column is the cleared state (when you've seen it in your
bank statement) of the operation, the amount is in the sixth column if it's a
debit operation or in the seventh column if it's a credit one. The last column
is for the intermediate balance. Cancelled operations have their line in violet,
and operation for which the intermediate balance is below 0.0 have their last
column is red.
.br
Functions available on an operation are :
.br
\- Edit the selected operation to make some modifications
.br
\- (un)Clear the selected operation
.br
\- (un)Cancel the selected operation
.br
\- Delete it
.br
\- Add a new operation
.br
\- Search for operations with differents criteria
.br
\- Print the operations list.
.br
There are a few means to do want you want with operations :
.br
\- with the mouse's left button you can double-click to open the operation's
   informations
.br
\- with the middle button you can set that operation to Cleared / Uncleared
.br
\- and with a double-click on the right button you can display the pop-up menu.
.TP 4
.B 4. Categories
Categories are a mean to create a classification in the list of operations
an account contain. They are usefull for a research of a list of operations of
a certain type.
.br
You can modify an operation's category by editing it.
.br
You have access to the categories list in the settings/categories menu.
There you can add/remove/edit any category. Each category has a name (you can
add a slash to specify a subcategory e.g. : "Car / Insurance") and a number. I
don't give you the advise of modifying the number since they are internaly
managed but in some cases you have to do this.
.br
There are a few means to access caterogies' functions :
.br
\- the left mouse button, when double-clicked, displays the selected category's
   informations
.br
\- and the right button's double-click displays the pop-up menu.
.TP 4
.B 5. Menus
.TP 5
.I 5.1. The "File" menu
.br
.TP 6
\- New wallet
.br
Create a new empty list of accounts and operations. If one is already
opened, you'll be asked for saving (if the "automatic saving" is not
on). Don't forget to save your changes.
.br
.TP 6
\- Open
.br
Open a wallet file. You'll be asked to save the wallet (if the
"automatic saving" is not on). Don't forget to save your changes.
.br
.TP 6
\- Save
.br
Save the already opened wallet file.
.br
.TP 6
\- Save As
.br
Save the already opened wallet file with another name.
.br
.TP 6
\- Close
.br
Close the already opened wallet file. You'll be asked for saving (if
the "automatic saving" is not on). Don't forget to save your changes.
.br
.TP 6
\- Quit
.br
Exit the program. You'll be asked for saving (if the "automatic saving"
is not on). Don't forget to save your changes.
.br
.TP 5
.I 5.2. The "Settings" menu
.br
.TP 6
\- Preferences
.br
Open the preference window. It has 4 panes that allow to configure :
.br
\fB\- 1 :\fP The first is to configure your country's currency and it's position
          in relation to the amount of an operation or an account.
.br
\fB\- 2 :\fP The second is for the date and the way you like to see it. you can
configure the date separator and the format (dd.mm.yyyy / mm.dd.yyyy).
.br
\fB\- 3 :\fP The third allow only to configure the Euro value in regard to your
country's money.
.br
\fB\- 4 :\fP The forth is the one for printer configuration (ASCII/PostScript and
command/options for each).
.br
\fB\- 5 :\fP The fifth pane contain a few options : "Auto save files",
"Tear off menus" and "Use last opened account".
.br
\fB\- 6 :\fP The sixth and last pane determines if the advanced features are used
or not (3rd parties and splits).
.br
You can, after modification click either on "OK" that will keep your
changes and save them later on, "Save" in order to immediately save your
changes and "Cancel" which will discard them.
.br
.TP 6
\- Categories
.br
Open the categories window. It display the list of categories you have
defined in order to changes/see them. They are listed in alphabetical
order, but debit and credit are separated : debit categories come first
and credit categories come after. See the "Categories" menu.
.br
.TP 6
\- 3rd parties
.br
If the advanced feature "3rd parties" has been selected in the
preferences window, this option is available. Its opens a window that
allow to edit 3rd parties the same way the categories window does it
for categories.
.br
.TP 6
\- Scheduled operations
.br
Opens the scheduler window. You can then add, change or remove some
scheduled operation that can be periodicaly done.
(Not yet implemented)
.br
.TP 6
\- Convert to Euro
.br
Open a window that will ask you if you are sure you want to convert all
your accounts and operations to Euro. If you answer "OK", your account
will be converted to Euro and renamed with a ".wallet-euro" extension.
Your old wallet file will remain in your ~/.gacc/ directory.
.br
.TP 5
.I 5.3. The "Accounts" menu
.br
.TP 6
\- Open
.br
Open the operations list's window for the selected account.
.br
.TP 6
\- Edit
.br
Edit the selected account's informations.
.br
.TP 6
\- Delete
.br
Delete the selected account.
.br
.TP 6
\- Add
.br
Add a new account to the opened wallet file.
.br
.TP 6
\- Graph
.br
Graph the selected account's amount during the past year up now (by
default since dates are modifiables), credit and debit operations
and finaly a pies graph for categories (Not yet implemented).
.br
.TP 5
.I 5.4. The "Operations" menu
.br
.TP 6
\- Edit
.br
Edit the operations informations. You can change anything for the
selected operation except the cancelled state that is modifyed by the
menu entry below. If you enter a category that is not in the categories
list you are asked to save or not that new category.
.br
.TP 6
\- (un)Clear
.br
Set or unset the cleared state of the selected operation.
.br
.TP 6
\- (un)Cancel
.br
Set or unset the cancelled stats of the selected operation.
.br
.TP 6
\- Delete
.br
Delete the selected operation.
.br
.TP 6
\- Add
.br
Add a new operation.
.br
.TP 6
\- Search
.br
Search for operations of the same medium, type, category, date or
cleared state. After the search is complete, a window opens that lists
all the matching operations. You can print that list the same way as
using the print list menu (see below). The window used to display the
resulting operations is the same as the usual operations' list window.
So you can use the mouse buttons to display the operation's
informations, change it's cleared state or display the pop-up menu...
.br
.TP 6
\- Print list
.br
Print the operations list. A "Print" window is opened for you to choose
the destination (printer or file) and the format (PostScript or ASCII).
The defaults entries for printing are :
.br
\- ASCII printing :
command = \fB"a2ps"\fP, options = \fB"--stdin="\fP
.br
\- PostScript printing :
command = \fB"lpr"\fP, options = \fB"-Plp "\fP
.br
Notice the space after \fB"-Plp "\fP : it's here to separate options from
filename. The default ASCII printing command is a2ps, anyway, you can
change it to what you want, but the printing function add a name for
the print job that is the name of the file where are stored the
informations befor printing. If you want to change that, you must know
the option to use to deal with that. For example, with lpr, options
would be \fB"-Pascii -J "\fP, with ascii = the name of your ASCII printer
configured in /etc/printcap.
.br
Note that the "Operations" menu is the same as the menu for editing and
manipulate operations that come from a research result, except that the
three last part are not shown (Add, Search and Print).
.br
.TP 5
.I 5.5. The "Categories" menu
.br
.TP 6
\- Edit
.br
Edit the selected category informations.
.br
.TP 6
\- Add
.br
Add a new category.
.br
.TP 6
\- Delete
.br
Delete the selected category.
.br
.TP 5
.I 5.6. The "3rd parties" menu
.br
.TP 6
\- Edit
.br
Edit the selected 3rd party informations.
.br
.TP 6
\- Add
.br
Add a new 3rd party.
.br
.TP 6
\- Delete
.br
Delete the selected 3rd party.
.br
.TP 5
.I 5.7. The "Help" menu
.br
.TP 6
\- Help Index
.br
Displays the Help System window at the Index page. Indexes are composed
of buttons that open a new paragraph of the help file.
.br
.TP 6
\- About
.br
Shows the "About box" :)
.br
.\"}}}
.\"{{{  Notes
.SH NOTES
The \fBHELP\fP file might not be found. You can specify that with an option in the
global configuration file or in your personnal configuration file if you have
no access to the first.
.\"}}}
.\"{{{  Configuration
.SH PERSONNAL CONFIGURATION FILE
.TP 1
.B CATFIL :
File where the personnal categories are stored.
.br
.TP 1
.B ACCFIL :
Last accounts wallet file opened.
.br
.TP 1
.B TRSFIL :
3rd parties file.
.br
.TP 1
.B CURREN :
Currency.
.br
.TP 1
.B CURPOS :
Currency position (0 = After, 1 = Before).
.br
.TP 1
.B LSTACC :
Last opened account in your file.
.br
.TP 1
.B USELOA :
Open last opened account on startup (0 = false, 1 = true).
.br
.TP 1
.B AUTSAV :
Auto save files (0 = false, 1 = true).
.br
.TP 1
.B TEAROF :
Tear of menus (0 = false, 1 = true). NOT YET IMPLEMENTED.
.br
.TP 1
.B DATFOR :
Date format (0 = French date, 1 = English date).
.br
.TP 1
.B DATSEP :
Date separator.
.br
.TP 1
.B EURVAL :
Euro value for your country's money.
.br
.TP 1
.B ADVANC :
Use advanced features.
.br
.TP 1
.B PSPRNC :
PostScript printing command.
.br
.TP 1
.B PSPRNO :
PostScript printing option.
.br
.TP 1
.B ASPRNC :
ASCII printing command.
.br
.TP 1
.B ASPRNO :
ASCII printing option.
.br
.TP 1
.B HLPPTH :
Help path (with filename).
.br
.TP 1
.B CATPTH :
Default categories file path (with filename).
.br
.SH SYSTEM WIDE CONFIGURATION FILE
.TP 1
.B HLPPTH :
System wide help path (with filename).
.br
.TP 1
.B CATPTH :
System wide default categories file path (with filename).
.br
.\"}}}
.\"{{{  Files
.SH FILES
~/.gAcc/gaccrc
.br
~/.gAcc/categories.def
.br
~/.gAcc/tiers.def
.br
~/.gAcc/accounts.wallet
.br
/etc/gaccrc
.br
PREFIX/share/HELP
.br
.\"}}}
.\"{{{  Version
.SH VERSION
gAcc version 0.7.3
.\"}}}
.\"{{{  Licence
.SH LICENCE
This program is released under the GPL. If you do anything interesting, please
let me know, I would like to have a look.
.\"}}}
.\"{{{  Author
.SH AUTHOR
Thomas Nemeth <tnemeth@free.fr>
.br
\fBhttp://gacc.sourceforge.net\fP
.br
.SH CONTRIBUTORS
Michel Verdier <mverdier@chez.com>
.br
Julien Blache <jb@jblache.org>
.br
Gianluca Montecchi <gianluca@pluto.linux.it>
.\"}}}
.\"{{{  See also
.SH SEE ALSO
.BR cron (8),
.BR crontab (1),
.BR crontab (5)
.\"}}}