$Id: README,v 1.7 2004/05/13 07:19:10 ianmacd Exp $

Ruby/CorporateTime
------------------

CorporateTime is a calendar server system produced by Steltor. Information on
the product can be found at:

   http://www.steltor.com/documentation/

Ruby/CorporateTime is a Ruby language extension that serves as a wrapper to
the CorporateTime Calendar API (CAPI). Its purpose is to allow interaction
with CorporateTime servers via the Ruby programming language.

In order to use this software, you should have the CAPI libraries installed on
your computer. These can be obtained from Oracle. To build from source, you'll
also need the ctapi.h header file, once again available from Oracle.

Ruby/CorporateTime has been verified to work with versions 2.0 and 2.5.1 of
the CAPI libraries, and with Steltor CorporateTime server 5.2 and 5.4, plus
Oracle CorporateTime (standalone) 9.0.4.2. Both the client and the server were
running Linux in these tests.

I have tried to use Ruby/CorporateTime with version 2.5 of the CAPI libraries
in combination with a server running version 5.4 of CorporateTime, but a
segmentation fault occurs when calling CAPI_Logon().

In fact, the same thing occurs when I compile and run one of the sample
programs that comes with the CAPI 2.5 archive, so I'm not convinced that
Ruby/CorporateTime is at fault here. I recommend that you upgrade to version
2.5.1 of the CAPI if this is a problem.

Please read the INSTALL file for information on how to install this software.
