Adding code to datacondAPI CVS (for LDAS version 0.0.17)
--------------------------------------------------------

1. Get LDAS distribution and unpack it
---------------------------------------

2. Build and install LDAS
-------------------------
In procees of building of LDAS code the directory subtree SunOS-sun4u
(or similar) is created by script 'build-ldas' in LDAS building
directory: 

ldas-0.0.17/SunOS-sun4u/

3. Adding new code
-------------------
Copy new *.cc and *.hh files (for example, TypeConversion.cc and
TypeConversion.hh ) to the subdirectory ldas-0.0.17/api/datacondAPI/so/src

Edit file ldas-0.0.17/api/datacondAPI/so/src/Makefile.am.
Add new source and header file names to lists of files assigned
to the variables CALL_CHAIN_SRCS and CALL_CHAIN_HDRS respectively.

Run command 'make' from directory ldas-0.0.17/SunOS-sun4u/api/datacondAPI .

4. Adding test program
------------------------
Copy test source files (tTypeConversion.cc, for example) to the subdirectory 
ldas-0.0.17/api/datacondAPI/so/test

Edit file ldas-0.0.17/api/datacondAPI/so/test/Makefile.am.
Add new source files to the list of files assigned to the
varibale TESTS.

Add lines:

tTypeConversion_SOURCES = \
        tTypeConversion.cc

to the appropriate section of file ldas-0.0.17/api/datacondAPI/so/test/Makefile.am

If there are other files required for tests then copy those files to
the directory ldas-0.0.17/api/datacondAPI/so/test and add names to the 
list assigned to variable EXTRA_DIST (in the same file Makefile.am).

5. Checking added code
----------------------
Run command 'make check "LIBS=-lpthread -lsocket -lposix4" '
 from directory ldas-0.0.17/SunOS-sun4u/api/datacondAPI

or '-lposix4' must be added to the end of line 301 in file 
ldas-0.0.17/SunOS-sun4u/api/datacondAPI/so/test/Makefile
after make stops due to error.

LIBS = -lpthread -lsocket -lposix4

Run command 'make check' again from directory ldas-0.0.17/SunOS-sun4u/api/datacondAPI

If 'make' messages look like:
...
PASS: tTypeConversion
...

then your code added successfully.

------------------------------------------------------------------------------
June 4, 2001

A.Sazonov (sazonov@phys.ufl.edu)