This distribution prepares an extended trial balancefrom a list of 
account names and transactions.It does not create a set of accounts.

Sundry notes:
- this software is pretty rubbish
- you need a C++ compiler. G++ 4.6.4 or higher should be fine.
- historical (hysterical?) versions are stored in folders v1 and v2.
- this program is released into the Public Domain.
- command-line only.



QUICKSTART
==========

+ Build it: make
+ Install it: make install
+ Run it: etb < etb.dat



DATA FILE FORMAT
================

In EBNF notation, input data is of the form:

<ledger> ::= {<descriptor>} "%\n" {<transaction>}

<descriptor> ::= <code> "\n" <description> "\n\n"

<transaction> := <code> "\n" <description> "\n" <amount> "\n\n"

<amount> ::= ["+"|"-"] <digit>+

<digit> ::= "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9"

<code> and <description> is any non-empty sequence of chars.

{} indicates that the expression may be repeated 0 or more times.

See the file `etb.dat' for an example. AMOUNT represents cents
(or pennies, if you like). CODE is an account code, which is 
case-dependent.


OUTPUT
======

The output from running `etb <etb.dat' is:

Bd    Balance B/d                                     10.00
cash  Cash                                           -65.00
rent  Rent                                             3.50
shop  Shopping                                        41.50
sund  Sundries                                        20.00
Grand: 1000

Use positive numbers for debits, and negative numbers for credits.



NOSTALGIA
=========

+ v3: 06-Oct-2017

It has been over 20 years since I released the first version of etb, 
and over a decade since I released the last one. Time for an update, 
then! I doubt that I have too many more decades in me. The program was 
rewritten in C++, and now only takes up 79 lines of code. Version 2 
was 982 lines long. The functionality of the two versions is similar,
but C++ has certainly sped up the development time and reduced 
the line count. 


+ v2: 19-Mar-2005

This project is a rebuild from Amiga 600 to Aros; the original
distribution is included. It is known to work with Aros version
20050308 hosted on Slackware 10.1.


+ v1: 30-Apr-1995

This package is the culmination of over 2 months work. It is the
first  project  that I have done in the C programming language -
most of my other programs have been in Basic - especially  Blitz
Basic.  I  am a fully qualified Chartered Accountant,  so I know
all about bookkeeping.  I have forsaken accountancy to pursue  a
career  in research.  Currently,  I am half way through studying
for my PhD on the Diffraction of Reaction-Diffusion waves.

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
drwx------ 65534/65534       0       0 ****** -lhd- 0000 Oct  7 09:30 etb/
-rwx--x--x 65534/65534       6       6 100.0% -lh0- 0242 Oct  7 09:28 etb/AAA
-rwx------ 65534/65534      96     117  82.1% -lh5- 19ee Oct  6 06:32 etb/Makefile
-rwx------ 65534/65534     604    1406  43.0% -lh5- 9cb6 Oct  5 07:09 etb/etb.cc
-rwx------ 65534/65534     412     712  57.9% -lh5- a823 Oct  5 06:52 etb/etb.dat
-rwx------ 65534/65534    1482    2886  51.4% -lh5- c0b2 Oct  7 09:25 etb/etb.readme
-rwx--x--x 65534/65534      40      45  88.9% -lh5- 3e07 Oct  6 01:00 etb/make-dist
drwx------ 65534/65534       0       0 ****** -lhd- 0000 Oct  6 01:37 etb/v1/
-rwx------ 65534/65534     140     187  74.9% -lh5- de94 Oct  6 01:01 etb/v1/AAA
-rwx------ 65534/65534    1381    3296  41.9% -lh5- 0698 Oct  6 01:37 etb/v1/LICENSE
-rwx------ 65534/65534     311     835  37.2% -lh5- 4a1d Oct  6 01:01 etb/v1/LICENSE.info
-rwx------ 65534/65534     667    1528  43.7% -lh5- 4bce Oct  6 01:01 etb/v1/README.FIRST
-rwx------ 65534/65534     313     835  37.5% -lh5- 43ea Oct  6 01:01 etb/v1/README.FIRST.info
drwx------ 65534/65534       0       0 ****** -lhd- 0000 Oct  6 01:01 etb/v1/admin/
drwx------ 65534/65534       0       0 ****** -lhd- 0000 Oct  6 01:01 etb/v1/admin/OtherDocs/
-rwx------ 65534/65534     279     461  60.5% -lh5- 68cb Oct  6 01:01 etb/v1/admin/OtherDocs/etb.readme
-rwx------ 65534/65534     256     628  40.8% -lh5- 64d6 Oct  6 01:01 etb/v1/admin/OtherDocs.info
drwx------ 65534/65534       0       0 ****** -lhd- 0000 Oct  6 01:01 etb/v1/admin/TWdocs/
-rwx------ 65534/65534    5106   11717  43.6% -lh5- 8e60 Oct  6 01:01 etb/v1/admin/TWdocs/DEVEL.DOC
-rwx------ 65534/65534     505     792  63.8% -lh5- ab29 Oct  6 01:01 etb/v1/admin/TWdocs/DEVEL.DOC.info
-rwx------ 65534/65534    1314    2610  50.3% -lh5- 005b Oct  6 01:01 etb/v1/admin/TWdocs/LICENSE
-rwx------ 65534/65534     501     792  63.3% -lh5- 0985 Oct  6 01:01 etb/v1/admin/TWdocs/LICENSE.info
-rwx------ 65534/65534     632    1135  55.7% -lh5- b311 Oct  6 01:01 etb/v1/admin/TWdocs/README.FIRST
-rwx------ 65534/65534     500     790  63.3% -lh5- 1f6d Oct  6 01:01 etb/v1/admin/TWdocs/README.FIRST.info
-rwx------ 65534/65534    3818    8752  43.6% -lh5- 6632 Oct  6 01:01 etb/v1/admin/TWdocs/USER.DOC
-rwx------ 65534/65534     501     792  63.3% -lh5- 7c56 Oct  6 01:01 etb/v1/admin/TWdocs/USER.DOC.info
-rwx------ 65534/65534     268     628  42.7% -lh5- cbd8 Oct  6 01:01 etb/v1/admin/TWdocs.info
-rwx------ 65534/65534     257     461  55.7% -lh5- 8153 Oct  6 01:01 etb/v1/admin/admin.notes
-rwx------ 65534/65534     149     222  67.1% -lh5- cc80 Oct  6 01:01 etb/v1/admin/make-dist
-rwx------ 65534/65534     270     628  43.0% -lh5- ea10 Oct  6 01:01 etb/v1/admin.info
drwx------ 65534/65534       0       0 ****** -lhd- 0000 Oct  6 01:01 etb/v1/devel/
-rwx------ 65534/65534    5749   15179  37.9% -lh5- b183 Oct  6 01:01 etb/v1/devel/DEVEL.DOC
-rwx------ 65534/65534     319     839  38.0% -lh5- 75c1 Oct  6 01:01 etb/v1/devel/DEVEL.DOC.info
-rwx------ 65534/65534      80     116  69.0% -lh5- bacb Oct  6 01:01 etb/v1/devel/DMakefile
-rwx------ 65534/65534    4589   15990  28.7% -lh5- 68fa Oct  6 01:01 etb/v1/devel/etb.c
-rwx------ 65534/65534    1451    4244  34.2% -lh5- eeac Oct  6 01:01 etb/v1/devel/etb.h
-rwx------ 65534/65534     189     729  25.9% -lh5- 7cfe Oct  6 01:01 etb/v1/devel/main.c
-rwx------ 65534/65534     443    1213  36.5% -lh5- f835 Oct  6 01:01 etb/v1/devel/mcstd.h
-rwx------ 65534/65534    1482    5300  28.0% -lh5- 27d6 Oct  6 01:01 etb/v1/devel/mcstring.c
-rwx------ 65534/65534    1143    4077  28.0% -lh5- 3a2c Oct  6 01:01 etb/v1/devel/parsecli.c
drwx------ 65534/65534       0       0 ****** -lhd- 0000 Oct  6 01:01 etb/v1/devel/tests/
-rwx------ 65534/65534     809    1895  42.7% -lh5- e9dc Oct  6 01:01 etb/v1/devel/tests/dice.c
-rwx------ 65534/65534    3903    6036  64.7% -lh5- 4a25 Oct  6 01:01 etb/v1/devel/tests/test
-rwx------ 65534/65534     121     178  68.0% -lh5- 6a0d Oct  6 01:01 etb/v1/devel/tests/test.c
-rwx------ 65534/65534    5184    8092  64.1% -lh5- 7347 Oct  6 01:01 etb/v1/devel/tests/testcli
-rwx------ 65534/65534     459    1322  34.7% -lh5- d2ae Oct  6 01:01 etb/v1/devel/tests/testcli.c
-rwx------ 65534/65534    2017    3112  64.8% -lh5- 25ad Oct  6 01:01 etb/v1/devel/tests/testeasy
-rwx------ 65534/65534     310     938  33.0% -lh5- f0bd Oct  6 01:01 etb/v1/devel/tests/testeasy.c
-rwx------ 65534/65534     270     628  43.0% -lh5- e604 Oct  6 01:01 etb/v1/devel/tests.info
-rwx------ 65534/65534     268     628  42.7% -lh5- b318 Oct  6 01:01 etb/v1/devel.info
-rwx------ 65534/65534     280     470  59.6% -lh5- 73a4 Oct  3 10:28 etb/v1/etb.readme
drwx------ 65534/65534       0       0 ****** -lhd- 0000 Oct  6 01:01 etb/v1/user/
-rwx------ 65534/65534    4197   11601  36.2% -lh5- c6e5 Oct  6 01:01 etb/v1/user/USER.DOC
-rwx------ 65534/65534     318     839  37.9% -lh5- e0cd Oct  6 01:01 etb/v1/user/USER.DOC.info
-rwx------ 65534/65534   10071   17028  59.1% -lh5- 21c6 Oct  6 01:01 etb/v1/user/etb
-rwx------ 65534/65534     287     434  66.1% -lh5- 6b8e Oct  6 01:01 etb/v1/user/ledger.dat
-rwx------ 65534/65534     261     628  41.6% -lh5- 1f32 Oct  6 01:01 etb/v1/user.info
drwx------ 65534/65534       0       0 ****** -lhd- 0000 Oct  6 01:40 etb/v2/
-rwx------ 65534/65534      60      60 100.0% -lh0- 2a50 Oct  6 00:46 etb/v2/Makefile
-rwx------ 65534/65534    2239    5543  40.4% -lh5- 9a9d Oct  3 10:38 etb/v2/USER.DOC
-rwx------ 65534/65534    7143   24696  28.9% -lh5- 36b6 Oct  3 10:28 etb/v2/etb.c
-rwx------ 65534/65534     367     648  56.6% -lh5- 15d4 Oct  3 10:28 etb/v2/etb.readme
-rwx------ 65534/65534     287     434  66.1% -lh5- 6b8e Oct  3 10:28 etb/v2/ledger.dat
-rwx------ 65534/65534     170     370  45.9% -lh5- bd51 Oct  3 10:28 etb/v2/trans.dat
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        64 files   74274  175528  42.3%            Oct  7 21:39