SciDAC Level 2 Data Parallel "QDP" Library for C
Version 1.0
Feb. 3, 2003

This is an implementation of QDP in C that can either be used on it's own or
in combination with the MILC code.  It requires the necessary QLA libraries
for all math operations and can use either MPI or QMP for communications.

Note this release requires QLA version 1.1.
The QMP compatible library requires an updated QMP that hasn't been released
yet.  It should work once it is released, but this hasn't been tested.
The MPI compatible library should work fine with any relatively recent
version of MPI.

See the file BUILDING for compiling instructions.

The file layout is:

  BUILDING		building instructions

  Makefile		the top level makefile
			shouldn't need to edit

  Makefile.inc		set compiler flags and library paths
			this should be edited before compiling

  README		this file

  doc/			documentation directory
			in this directory type 'make ps' to make postscript
			users guide or 'make html' to make html version

  generate/		contains code and scripts to generate the C source

  include/		this directory will contain the headers after building

  lib/			finished libraries go here

  src/			C source for library

  src/qdp_common	precision and color independent routines
			this source is not generated by the scripts

  src/qdp_int		C source for specific precision and color libraries
  src/qdp_f		the code and directories are generated by scripts
  src/qdp_f3		in the generate directory
  ...

  test/			some simple test programs
			this is not (yet) an extensive test suite


bugs and other comments should be sent to:
James C. Osborn
University of Utah
osborn@physics.utah.edu