ROX-CLib
========

A library for ROX applications written in C.

This is version 2.0, for use with GTK+ 2.x.

Installation
------------

Copy to a suitable place such as ~/lib or make sure it is on 
your $LIBDIRPATH.  It must be called ROX-CLib, otherwise other 
programs can't find it.

Compile using ROX-CLib/AppRun --compile

Compiling and linking against the library
-----------------------------------------

Add the output of
   rox_run ROX-CLib --cflags
to your compile line, e.g.
   gcc `rox_run ROX-CLib --cflags` -c main.c 

Add the output of
   rox_run ROX-CLib --cflags
   rox_run ROX-CLib --libs
to your link line, e.g.
   gcc `rox_run ROX-CLib --cflags` -o main main.o `rox_run ROX-CLib --libs`

If you are using autoconf and building a ROX program then:
In src/configure.in add:
  if test -z "$ROX_RUN"; then
    AC_CHECK_PROG(ROX_RUN, rox_run, rox_run, "$APP_DIR/rox_run")
  fi
  AC_SUBST(ROX_RUN)

In src/Makefile.in add:
  ROX_CLIB = @ROX_RUN@ ROX-CLib
and to CFLAGS add: `${ROX_CLIB} --cflags`
and to LDFLAGS add: `${ROX_CLIB} --libs`

In AppRun and AppletRun ensure you have:
  APP_DIR=`cd $APP_DIR;pwd`; export APP_DIR

Finally put rox_run in the ROX app dir.

Brief listing of functions
--------------------------

See ROX-CLib/Help/rox-clib.html
