Here is a short how-to on this reference SFT version 2 library.

LATEST CODE/DOCUMENTATION VERSION
---------------------------------
May be obtained from CVS using module 'sftlib' from:
:pserver:anonymous@gravity.phys.uwm.edu:2402/usr/local/cvs/lscsoft 
See:
http://www.lsc-group.phys.uwm.edu/daswg/docs/howto/lscsoft-cvs.html
for instructions about accessing CVS using this.


TO BUILD/INSTALL
----------------
If working from CVS, run ./00boot to make a configure script, then
follow instructions below.  Otherwise, unpack the tarball, then:

./configure
make
make install (optional)


SFT SPECIFICATIONS
------------------
See the file: SFT_v2_specification


TO USE
------
Makes a test SFT (called SFT-test)
 ./SFTwrite
You can do this on little-endian and big-endian machines to generate
both flavors.  This produces a set of good and a set of bad SFTs.  The
good SFTs are:
SFT-test[1234567] and SFT-good
and the bad SFTs are
SFT-bad[123456789] and SFT-bad1[0-4]

You can use ./SFTvalidate to see what's wrong with the bad SFTs, for
example ./SFTvalidate SFT-bad3 .


TO MAKE CONCATENATED SFTs
-------------------------
cat SFT-test1 SFT-test2 SFT-test3 > SFT-merged


TO VERIFY THAT A SET OF SFT files IS VALID
-------------------------------------------
./SFTvalidate SFT1 SFT2 ... SFTn
The exit status will be zero if all SFTs are valid.  The exit status
will be non-zero if any of the SFTs was invalid.  grep SFTE
SFTReferenceLibrary.h will show the return values.


TO DUMP THE HEADER INFORMATION FROM A SET OF SFT FILES
------------------------------------------------------
./SFTdumpheader SFT1 SFT2 ... SFTn
The exit status will be zero if all SFTs are valid.  The exit status
will be non-zero if any of the SFTs was invalid.  grep SFTE
SFTReferenceLibrary.h will show the return values.


TO DUMP ALL INFORMATION FROM A SET OF SFT FILES
------------------------------------------------------
./SFTdumpall SFT1 SFT2 ... SFTn
The exit status will be zero if all SFTs are valid.  The exit status
will be non-zero if any of the SFTs was invalid.  grep SFTE
SFTReferenceLibrary.h will show the return values.


LIBRARY TO LINK TO
------------------
cc mycode.c -lSFTReferenceLibrary


