INTRODUCTION

     This is a public beta version of Para.  Para is an intermediate
     representation for UML diagrams.  Currently, a subset of class diagrams
     and state diagrams is supported.  Para parses an XMI (XML Metadata
     Interchange) file generated from a UML tool, such as ArgoUML
     (http://www.tigris.org) and generates a Para representation.  It requires
     the Xerces-C library from the Apache group (http://xml.apache.org). 
     Currently, UML specification 1.3 is supported.

INSTALLATION

     In order to use the Para API, you first need to download the Xerces-C
     library and install it.  Once, it is installed, edit Makefile.  Modify
     INCLUDE and LIB_OPT, so that they point to the appropriate directory in
     the Xerces-C hierarchy.  At this time, the API was tested with the 
     XerceS-c version 1.3 and 1.4 on Sparc/Solaris.

     There may be a problem with a binary distribution of the Xerces-C library.
     When the Para API is complied with the binary distribution, the linker
     may complain that some symbols are not defined.  Compiling the source
     distribution with "-psolaris -cgcc -xg++" seems to work.

API
     Manuals are provided for each class used in the API.  Para class is the
     interface for Para, and programmers are expected to access the Para
     data strucuture through this class.  Calling the parse method of Para
     class creates the para representation.  Once this is done, get methods
     of other classes will allow access to information stored in the data
     structure.  Set methods in classes are provided for Para to construct
     the data structure, so programmer will not need to use these methods.
     A pretty printer called ppr is provided to print out the representation.
     For the data format (EBNF), please refer to para(5).


SAMPLES
     ParaGen is a Para GENerator.  It parses an XMI file passed to the program
     as a command-line parameter and printes out its Para representation to
     the standard output.  For details, please refer to paragen(1).

     Para2SMV is a translator that convert a Para representation to an SMV
     representation.  The current version of Para2SMV reads a Para
     representation from a file and output an SMV representation to the
     standard output.  For details, please refer to para2smv(1).
  

The current version supports the following public methods:

     parse:  creates a data structure to hold the xmi information
     ppr:  outputs Para (ParaGen)
     getClass:  retrieves class information
     getConstraint: retrieves constraints (currently only OCL is supported)
     getAssociaiton: retrieves association information among classes
     getDependency: retrieves dependency informaiton among classes
     getGeneralization: retrieves generalization information among classes
