source: Sophya/trunk/SophyaExt/JThreadsC++/README@ 3359

The JThreads/C++ is a C++ class library implementing
multi-threading with Java look & feel, developped by:

                Object-Oriented Concepts, Inc.
                44 Manning Road
                Billerica, MA 01821
               ( http://www.ooc.com/ )

(See the licence agreement in JTCSrc/LICENCE)

The source code here corresponds to version 1.0.10 and
has been downloaded from the OOC web site (May 2000).
A specific makefile (Makefile) has been written, with 
support for DEC/Compaq TruUnix64, cxx, Linux and g++, 
as well as SGI IRIX-64 (and SGI-CC) and KCC.

Note: The static library which is build (libJTC.a) 
by the present version of the Makefile may not 
work for all compilers.

The config file (JTC/Config.h) has been modified to 
provide multiple platform / multiple compiler support
using switches (#ifdef) in a single file.

***********************************************
***** Building and installing the library *****
***********************************************

1) Select the compiler through the environment variable 
SOPHYACXX
2) Build the libray (make in JTCSrc)
3) Define the path for installation through the 
JTCBASEREP environment variable
4) Install (make install in JTCSrc)
5) Try to build and test the example programs
(make in Examples/) - The LD_LIBRARY_PATH should
contain $JTCBASEREP/`uname`-$SOPHYACXX/ShLibs
6) The use of GNU make is mandatory

The example below shows the installation and building
for a Dec/Compaq machine, with the native cxx compiler,
using c-shell commands. (uname = OSF1)

Cmd> setenv SOPHYACXX cxx
Cmd> setenv JTCBASEREP /usr/local/
Cmd> cd JTCSrc
# GNU make program should be used
Cmd> make
# Create the Objs directory for .o .a .so files
Cmd> make install
# Creates /usr/local/Include/JTC for include files
#         /usr/local/OSF1-cxx/Libs    (libJTC.a)
#         /usr/local/OSF1-cxx/ShLibs  (libJTC.so)
# Copies .h files and .a .so libraries

# make clean can be used to remove the Objs directory
# (Use make clean before building a new version)
Cmd> make clean

Build and run the example programs :
Cmd> cd ../Examples
Cmd> make 
Cmd> setenv LD_LIBRARY_PATH ${LD_LIBRARY_PATH}:${JTCBASEREP}/OSF1-cxx/ShLibs
Cmd> ./diner or ./hello ...