\section{For users}\label{index_user_sec}
\subsection{Installation}\label{index_install_sec}
Copy to a suitable place such as {\tt $\sim$/lib} or make sure it is on your {\tt \$LIBDIRPATH}. If you use {\tt Archive} to extract it from the downloaded archive then make sure you rename it to {\tt ROX-CLib}.

Compile using {\tt ROX-CLib/App\-Run --compile} or running ROX-CLib from the filer.

You will need \begin{itemize}
\item GTK+ 2.x \item libxml 2.4.x  \item GNU {\tt make}. \end{itemize}
Linux users should already have GNU make installed {\tt /usr/bin}. Other OS's may require you use a different directory ({\tt /usr/bin/local}) or program name ({\tt gmake}). Set the environment variable MAKE to the correct value before compiling, e.g. \small\begin{alltt}
\$ MAKE=gmake ROX-CLib/AppRun --compile
\end{alltt}
\normalsize 
\section{For Programmers}\label{index_prog_sec}
\subsection{Compiling and linking against the library}\label{index_lib_sec}
Compile the library first as above.

Copy the {\tt libdir} script from {\tt ROX-CLib/{\em \$PLATFORM\/}/bin/libdir} into your app dir.

Add the output of \small\begin{alltt}   ROX-CLib --cflags\end{alltt}
\normalsize 
 to your compile line, e.g. \small\begin{alltt}   ROX\_CLIB="`\$APP\_DIR/libdir ROX-CLib`/AppRun"\end{alltt}
\normalsize 
 \small\begin{alltt}   gcc `\$ROX\_CLIB --cflags` -c main.c \end{alltt}
\normalsize 


You should include the main file: \small\begin{alltt}
   \# include <rox/rox.h>
\end{alltt}
\normalsize 
 and any of the others you need.

Add the output of \small\begin{alltt}   ROX-CLib --cflags
   ROX-CLib --libs\end{alltt}
\normalsize 
 to your link line, e.g. \small\begin{alltt}   ROX\_CLIB="`\$APP\_DIR/libdir ROX-CLib`/AppRun"\end{alltt}
\normalsize 
 \small\begin{alltt}   gcc `\$ROX\_CLIB --cflags` -o main main.o `\$ROX\_CLIB --libs`\end{alltt}
\normalsize 


If you are using other libraries in conjunction with pkg-config you can use the alternative: \small\begin{alltt}\$ROX\_CLIB --pkg-config --cflags ROX-CLib {\em other-pkg\/}\end{alltt}
\normalsize 


If you are using autoconf and building a ROX program then: \begin{itemize}
\item In src/configure.in add: \small\begin{alltt}ROX\_CLIB(2, 0, 0)\end{alltt}
\normalsize 
 \item Copy ROX-CLib/Help/rox-clib.m4 to your programs src directory then execute \small\begin{alltt}aclocal -I .\end{alltt}
\normalsize 


\item In src/Makefile.in add: \small\begin{alltt}  ROX\_CLIB = @ROX\_CLIB\_PATH@/AppRun\end{alltt}
\normalsize 
 and to CFLAGS add: {\tt `\$\{ROX\_\-CLIB\} --cflags`} and to LDFLAGS add: {\tt `\$\{ROX\_\-CLIB\} --libs`}  \item In App\-Run (and Applet\-Run if it is an applet) ensure you have: \small\begin{alltt}
   APP\_DIR=`dirname \$0`
   APP\_DIR=`cd \$APP\_DIR;pwd`; export APP\_DIR
   ROX\_CLIB=`\$APP\_DIR/libdir ROX-CLib` export ROX\_CLIB
   if [ -z "$LD\_LIBRARY\_PATH" ]; then
       LD\_LIBRARY\_PATH=`"\$ROX\_CLIB/AppRun" --runtime`
   else
       LD\_LIBRARY\_PATH=`"\$ROX\_CLIB/AppRun" --runtime`:\$LD\_LIBRARY\_PATH
   fi
   export LD\_LIBRARY\_PATH
\end{alltt}
\normalsize 
  \end{itemize}
