The files in this directory contain some m-files that make up the 
complementarity toolbox for MATLAB.

However, the files in this directory have been superceded by newer versions of
the codes.  

To use PATH from MATLAB, see
    ftp://ftp.cs.wisc.edu/math-prog/solvers/path/matlab

   pathmcp.m
      an m-file that executes the PATH solver (requires the mcppath mex files
      in addition, and a user supplied function and Jacobian evaluator.
   pathlcp.m
      an m-file that solves LCP's (M,q) (uses lcppath.*)
   qp_lcp.m
      an m-file that solves QP's using PATH (uses lcppath.*)

(For all these interfaces you need to get the relevant mex files 
    mcppath.* or lcppath.* for your machine type.)

The problems in MCPLIB are now accessible using new tools.  All of
these tools are available at:
    http://www.gams.com/mpec/matlab.htm 

Remaining files of use in this directory are:
   lemke.m 
      an implementation of Lemke's pivotal code for LCP.
   lcp3.m
      a simple linear example of the input that any nonlinear complementarity
      code contained in this toolbox should use.
   cpfunjac.m 
      an example of how to access the MCPLIB problems and solve them using
      the complementarity codes in the toolbox.  
   cpstart.m
      an m-file to extract any starting point for the MCPLIB problems.

******** For use under Version 4, go into the Version4 subdirectory:
NOTE: THIS IS NO LONGER MAINTAINED
The remainder of the files for this toolbox are machine specific and
can be found in the machine specific directories below.

Included in these directories are:
   pathmex.mex*
   mexfiles.*
   gamsmat.*
   mcplib.*
where the * represents a machine specific compression format.

These files contain the following:
  pathmex.mex*
     A mex file interface to the PATH solver.  Use in conjunction with
     pathsol.m
  mexfiles
     cpfun.mex
     cpjac.mex
     cptype.mex
     cpsetup.mex
  mcplib
      This contains binary files incorporating all the information 
      required for all the problems in MCPLIB.  These files can be
      accessed by the above mex files without use of GAMS.
      For documentation, the gams source files can be found elsewhere
      on this archive.
  gamsmat
      This contains binary files for all the MCP and MPSGE problems
      found in the GAMS library of test problems.  Again, they can be
      accessed without use of GAMS.

Michael Ferris, April 2, 1998.