---

Instructions for mod_cas developers

Documentation

All functions and variables are commented using doxygen syntax. To generate the documentation, simply run `make doc' in the mod_cas directory; this creates an `html' directory which contains the HTML formatted documentation.

Note:

The graphviz package is needed to get include dependency graphes (see below for graphviz installation).

Graphviz installation

A binary package is available at http://www.research.att.com/sw/tools/graphviz for RedHat 7.2 but installation fails on RedHat 9 (libpng.so.2 is required and RedHat 9 is shipped with version 3).

Note:

This package may work on RedHat 7.3 and/or 8.0 (not tested).

As source package graphviz-1.9.0.src.rpm does not compile on RedHat 9, a snap shot may be needed (1.9.20030623.015-0 for instance)).

From RPM binaries (RedHat 9)

Simply download the package and install it:

% cd /usr/src/redhat/RPMS/i386
% mv /tmp/graphviz-1.9.20030623.0415-0.i386.rpm .
% rpm -ih graphviz-1.9.20030623.0415-0.i386.rpm

From RPM sources

Get the source RPM graphviz-1.9.20030623.0415-0.src.rpm from http://www.research.att.com/tools/graphviz, install it, build the binary packages and install them:

% cd /usr/src/redhat/SRPMS
% mv /tmp/graphviz-1.9.20030623.0415-0.src.rpm .
% rpm -ih graphviz-1.9.20030623.0415-0.src.rpm
% rpmbuild -bb ../SPECS/graphviz.spec
% rpm -ih ../RPMS/i386/graphviz-1.9.20030623.0415-0.i386.rpm

Note:

XFree86-devel is needed to build the binary packages.

Naming Conventions

all public (non-static) functions are prefixed by `cas_' to prevent from conflicts with other modules.

---