#MRMLIB  -  GENERAL DOCUMENTATION.
 
 
#INTRODUCTION.
 
        "MRMLIB" is a personal collection of subprograms which can
be called by fortran programs and which can also be written in
FORTRAN.  The principal aim in setting up this library has been
to establish a reasonably portable set of subprograms which carry
out operations that would otherwise be continually rewritten, thus
many of the routines in this library perform simple (even trivial)
tasks.  Two strong secondary aims are to establish a standard
set of interfaces which are inherently more portable than the
routines, and to establish proven subprograms for non trivial
operations particularly in the numerical area.
        
        No guarantee as to the correctness or efficiency of any
routine can be given but generally the routines will have been
used to a degree that should allow some confidence in them.
 
        THE LIBRARY IS MAINTAINED BY:
 
        DR MARTIN. R. MANNING
        INSTITUTE OF NUCLEAR SCIENCES
        LOWER HUTT
        NEW ZEALAND.
 
IT IS FREELY AVAILABLE TO ANYONE WHO IS INTERESTED AND COMMENTS
CERTIFICATIONS, COMPLAINTS AND PARTICULARLY CONSTRUCTIVE
CRITICISMS WILL BE WELCOMED.
 
        THE "BASE" FOR THE LIBRARY CONSISTS OF 
 
        1.  GENERAL DOCUMENTATION (THIS DOCUMENT).
 
        2.  A CATALOGUE OF ALL CURRENT SUBPROGRAMS.
 
        3.  FORTRAN IV SOURCES FOR ALL ROUTINES.
 
IN ADDITION TO THIS "BASE" THERE WILL BE
 
        4.  ASSEMBLY LANGUAGE VERSIONS OF SOME ROUTINES FOR
        SOME SYSTEMS.
 
        5.  CATALOGUES OF THOSE ROUTINES AVAILABLE IN
        A GIVEN SYSTEM LIBRARY.  THIS MAY CONTAIN OTHER
        ROUTINES NOT IN "MRMLIB" AS WELL.
 
        6.  SPECIAL REPORTS ON ORIGINAL ALGORITHMS ETC.
 
AND AS DOCUMENTATION OF MANY ALGORITHMS WILL CONTAIN REFERENCES TO
THE GENERAL PUBLISHED LITERATURE, THE FULL DOCUMENTATION OF
"MRMLIB" IS BACKED UP BY STANDARD JOURNALS, REPORTS ETC.
 
        The base for "mrmlib" as described above is all kept on
computer readable media and will be accessible through standard
support programs such as editors etc. on several systems.  In
addition special programs may be made available to allow easy
user access to sources and documentation.  To aid this aspect
of "mrmlib" the documentation files (including source files ) are 
formatted in such a way as to facilitate context editing etc.
 
        
#GENERAL DOCUMENTATION.
 
        This document is intended to describe the general
features of the library and standard conventions for some
groups of subprograms.  The subprograms are often conveniently
grouped into "packages" for this purpose and a set of conventions
given for the package.  These may include such things as common
blocks, regular features of parameter lists, data storage
conventions etc.