+-------------------------------------+
|                                     |
| Installing BaCon 3.2.2              |
|                                     |
+-------------------------------------+

(1) To install BaCon on your system, start by running the configure
script:

# ./configure

(2) This script checks the requirements on your system and should
finish successfully. A Makefile will be generated.

Then start building the BaCon binary by executing:

# make

(3) This will create a static archive containing BaCon functions.
Also the BaCon console version and GUI version are created.

To install BaCon, simply execute:

# make install

On Ubuntu based systems, use sudo:

# sudo make install

+-------------------------------------+
|                                     |
| Compatibility with earlier versions |
|                                     |
+-------------------------------------+

Though the BASIC syntax and API has not changed, it occasionally may
happen that older programs cannot be converted. The following hints
should help to troubleshoot such problems.

(1) Starting from 3.0, BaCon uses a new and optimized variable detection
mechanism. This mechanism is faster and more precise. Now global variables
with a certain name cannot be used in combination with local variables
using the same name.

Solution: either change the name of the global variable, or consistently
declare variables using LOCAL.

(2) The IF/THEN/ELSE statement can be used in two ways. The first way
is an IF/THEN/ELSE which contains a body with statements, ending with an
ENDIF. The second way is an IF/THEN/ELSE containing one single statement
on the same line, where no ENDIF is needed.

The problem is that it cannot be detected which ELSE belongs to which IF
in case of nested IF/THEN/ELSE statements.

Solution: combinations of IF/THEN/ELSE with a body and without a body
are not allowed anymore. Such combinations of IF/THEN/ELSE have to be
rewritten. Either use IF/THEN/ELSE each with a body, or use IF/THEN/ELSE
each with a single line.

+-------------------------------------+
|                                     |
| A note to beta testers              |
|                                     |
+-------------------------------------+

Before installing BaCon, please make sure that old beta versions of
the BaCon archive are removed from your system. This archive has the
name 'libbacon.a'.

+-----------------------------------------------------------------------

Greetings
Peter van Eerten

+-----------------------------------------------------------------------
