FSMDESIGNER 4 README
--------------------

See the file COPYING for license information. This program is licensed under the GNU Public License.

For compilation & installtion issues see also INSTALL.

To compile & install FSMDESIGNER4:

- you should give the configure script the base directory for 
  installation using the --prefix=install-dir option.

- Qt4 must be installed. The configure script searches for QT4 using 
  the pkg-config facility. If you installed QT4 yourself (i.e. it is 
  not the standard installation of your distribution), it may be necessary
  to let pkg-info know, where Qt is installed.

- You need to make sure that the QT4 binaries, i.e. moc, uic, rcc, are in your path!

- the configure script needs the "locate" utility to be installed and updatedb must have run

- FSMDESIGNER 4 needs Python in version >=2.4. Only 2.4 is tested. You need the development packets!

- FSMDESIGNER 4 needs Xerces C++ in version >=2.6. Only 2.6 is tested. You need the development packets of your distribution.
  The configure script tries to find 64-bit versions of the library first (i.e. in lib64 sub-dir), if that succeeds it uses these
	otherwise the scipt continues and looks for a library in the lib sub-dir. Dependant on your system settings you
	may want to specify the exact location of the libaries!

- FSMDESIGNER 4 need Swig. Version 1.3.24 has been tested. 
  Note: Configure test currently not the presence of SWIG!
  It is assumed that the swig binary resides in you path (e.g. /usr/bin).

- You need to set the PYTHONPATH variable to point to the lib directory 
  of your installation if you want to use the python scripting 
  functionality of fsmdesigner4. On a OpenSuSE 10.2 x86_64 machine this is for example
	/usr/lib64/python

If you want to start fsmdesigner4 WITHOUT installing it to a directory
within your PATH, use the supplied fsmdesigner.sh shell script.

The following steps are needed then:

- cd to base dir of FSMDESIGNER4 sources
- (if you have a svn checkout, 
   # admin/bootstrap)
- # configure --prefix=/usr/local
- # make
- # make install (note: you need to have write permissions to your
  install directory)
- modify your PATH variable to include the bin dir of your installation, i.e.
  # export PATH=/some/dir/bin:$PATH
- modify your PYTHONPATH variable to include the lib dir of your installation, i.e.
  # export PYTHONPATH=/some/dir/lib:$PYTHONPATH
- start fsmdesigner4:
  # fsmdesigner4
-Enjoy :-)


