The Scope of this Document

The purpose of this document is to give reference information about the argument lists and functionality of the internal KAPPA routines which are contained within KAPLIBS. It does not give a detailed explanation of how these routines should be used within a real application. Developers should usually study examples of existing code within KAPPA for this purpose. The source code for KAPPA is available from the Starlink Software Librarian, ussc@star.rl.ac.uk.

Applications within KAPPA are split up into several groups (called ``monoliths'), with names such as kapview, ndfpack and (rather confusingly but at one time the only KAPPA monolith) kappa. The top-level routines for the applications in monolith xyz are in the tar file $KAPPA_DIR/xyz_sub.tar. Each application may use some application-specific subroutines (i.e. subroutines which are so closely related to the purpose of a single application that they are not deemed as ``generally useful''). These will be denoted by subroutines names with prefix ``KPS1_'' and will be contained within the tar file $KAPPA_DIR/kapsub_sub.tar.