Klaas. Holwerda.
group: DSA-DTA
Hollandse Signaalapparaten B.V. 
P.O. Box 42 , 7550GD Hengelo(ov)
The Netherlands

kholwerd@xs4all.nl (at home) 

tel. 31-742483339

IN CASE of problems feel free to contact me!!

The boolean software is FREE to use and distribute/modify.
I would in return appreciate to be informed about bugs, extentions etc.
, to give me the oppertunity to include them for a later version.

---------------------------------------
the zip file contains the executables and source code for the program
boolean (graphical)
booleanonly (standalone boolean algorithm)

The following operating/platforms are supported:
	WIN32  (winNT win95 wxwindows2b16)
	SUNOS5 (solaris, with GTK 1.2.6 & wxGTK2b16, egcs 2.95)
	Linux  (redhat 5.2 & 6.2 , with GTK 1.2.6 & wxGTK2b16, egcs 2.95)

boolean.zip has reduced unix links to files, where they pointed to.
also executable flags are spoiled.


##################
INSTALL WINNT 
##################
Unzip boolean.zip to C: or any other path.
---------------------------------------
For the win32 executable, create a shortcuts to the executable(s).
For instance to: c:\boolean\6.1\win32\bin\boolean.exe

Set $GDSROOT is to the right place, win95 add it to the autoexec.bat.
For WinNt just define it (My computer, properties, environment.) 
For instance:

     set GDSROOT=C:\any\where\boolean\6.1\

     C:/any/where/boolean/6.1/win32/bin/boolean.exe  #for graphical UI
     C:/any/where/boolean/6.1/win32/bin/booleanc.exe  #for commandline UI

You can also make a small dos batch file containing the above.
Notice that GDSROOT is NOT pointing to the executable, but 2 levels higher!!
This is where boolean gets his default settings.
It is also looking in the HOME directory if that variable is set.
In that case copy the C:\any\where\boolean\6.1\gdsuser to your home directory.



####################
INSTALL UNIX
####################

First you need to install the wxGTK and GTK/GLIB libraries on your system.
See my homepage on where to get them.
This will be the easiest as root, but it is possible also as normal user.
Test examples etc. to make sure you did it right.
I recommend wxGTK2.2b16 and GTK1.2.6

---------------------------------------
Some unix scripts are used as a wrapper mechanism to choose the
right executable for the given platform.

Asuming the boolean.zip file is for instance unpacked
in directory /any/where/, the directory "boolean" will contain
the file "toolmanager".

This file contains the following lines: 
	# boolean_loc=`getloc BOOLEAN`
	boolean_loc=/usr/tools/boolean
change this line to the following: 
  	boolean_loc=/any/where/boolean
  	 
In the directory /any/where/boolean/bin you will find several links
pointing to this toolmanager.
Those links are NOT in the boolean.zip So you need to create them yourself
Like this

#create links to toolmanager for all executables and script,
#the wrapper will find the right platform
cd /any/where/boolean/bin
ln -s ../toolmanager boolean
ln -s ../toolmanager booleanc
ln -s ../toolmanager booleanterm
ln -s ../toolmanager booleantest
ln -s ../toolmanager boolean_man

MAKE sure the following script are set executable the following files
using chmod a+x:

chmod a+x /any/where/boolean/toolmanager
chmod a+x /any/where/boolean/6.1/release_settings.sh
chmod a+x /any/where/boolean/6.1/all_arch.all_os/bin/*

#create a link to the default version (which is 6.1)
cd /any/where/boolean
ln -s 6.1 default


The PATH variable should at least contain "/any/where/boolean/bin".
Executing on of the links will start the toolmanager. 
The toolmanager 
A. checks the platform and the default release
B. extends the path to the right executable
C. defines in the file "release_settings.sh" the following variable:
   GDSROOT=$boolean/
   export GDSROOT
   Which will be pointing to the following directory in the end:
      /any/where/boolean/6.1/
D. Define the LD_LIBRARY_PATH variable in order to find the dynamic libraries of wxGTK and GTK etc.
   #LD_LIBRARY_PATH=/usr/local/lib:/usr/openwin/lib:$LD_LIBRARY_PATH
   LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
export LD_LIBRARY_PATH

D. eventually starts the right executable from the command line,
it will be found through the PATH variable.


Asuming we are on a solaris system, the following executable will be called at last:
     /any/where/boolean/6.1/sun4.sunos5/bin/boolean_exe  #for graphical UI
or 
     /any/where/boolean/6.1/sun4.sunos5/bin/booleanc_exe #for commandline version
     
Setting the variable $GDSROOT is VERY IMPORTANT, because it is used to 
find all the configuration files. If NOT set, the program will crash.


---------------------------------------
On unix as well PC, $HOME is used to overrule the default configuration,
Make a copy of /any/where/boolean/6.1/gdsuser to $HOME, and edit the files as wanted.

---------------------------------------
All the software was developed with Borland 5.2, projects and source are included.
The unix versions were compiled with the GNU compiler, makefiles are included.

---------------------------------------
The graphical interface was developed with "wxwindows", it is a platform independent layer on top
of the native API. It is completely object oriented.
Wxwindows is freeware. Wxwindows was developed by Julian Smart, 
new versions can be optained from the Internet.
--------------------------------------
 

