Linda library
=============

Masatake YAMATO
2 Aug 2002

INTRO
-----

This library is revised version of Wong Weng Fai's pthread based c-linda
parallel programming system. About the original version, read README.orig
file.

I revised folowing points:
(1) New linda becomes a real library.
    You can use linda functions in your program with
    passing -linda to your C compiler.
    New linda is built as both shared and static library with using libtool.

(2) "linda_" is given as a prefix for the name of all linda functions.
    The symbol name conflicts among your program and linda library 
    can be avoid. 

(3) Allocated datum (including tuples) are freed.
    Original linda is not freed some datum.

(4) Functions getting tuple with timeout are added.
    See linda_inp_timed and linda_rdp_timed in linda.h.

(5) PkgConfig is introduced.
    If you use GNU autotools, it is much easier to use linda than 
    before.

(6) New linda is based on glib2.0.
    New linda uses glib2.0, the widly used sophisticated C library.
    New linda also uses gthread instead of pthread.

REQUIREMENT
-----------
Glib-2.0 or higher is required to build linda.
See INSTALL.

HOW TO USE IT
-------------
configure.in of your program:
PKG_CHECK_MODULES(LINDA,    
                 [linda] >= 0.0.0,,
                 AC_MSG_ERROR([linda is required to build YOURPROGRAM]))
AC_SUBST(LINDA_CFLAGS)
AC_SUBST(LINDA_LIBS)

*.c or *.h of your program:
#include <linda.h>

Makefile.am of your program:
CFLAGS = -g $(LINDA_CFLAGS)
yourprogram_LDADD = $(LINDA_LIBS)

TOOD
----
- Support %* and ?* that match any data type.
- Support %S and ?S that copies a string without new memory allocation
  (just using a buffer).

BUGS
----
Many of original codes are reorganized by Masatake YAMATO<jet@gyve.org>.
Please, report me bugs if you found.
