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!

- FSMDESIGNER 4 needs Python in version >=2.4. Only 2.4 is tested. You need the development packets! If the
  configure script complains about python chances are that you either have the development package not
	installed or the python binaries (including python-config) are not in your $PATH.

- 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 :-)