                         NCSA HDF Version 3.2r2
                               Oct. 1992

This directoy contains HDF3.2 backward compatibility test suite programs.  
There is an HDF file,  two programs and a makefile in this directory.

The HDF file bctest.hdf contains three SDSs. The first SDS was written
by a C program using HDF3.2r2, the second by a Fortran program using
HDF3.2r2 and the third by a Fortran program using HDF3.1r5.


Programs:
1. rs3.c -- A C program that uses HDF3.2 to read in the three SDS's from 
         bctest.hdf. For each SDS read, rs3.c uses DFSDpre32() to test 
         if the SDS was written by HDF3.1r5. If it is the case, rs3.c 
         then reads all dimension-related information, such as dimensiom
         scales and dimension-label etc., in a reversed order; and it calls
         transar() to transpose the data array read by DFSDgetdata() and
         reverse the dimension sizes at the same time.
         Fianlly, rs3 tests the correctness of each data item and print out 
         the contents of the SDS's, together with the original dataset and 
         dimension-related information.

2. rs3f.f -- A Fortran program that user HDF3.2 to read in the three 
         SDS's from file bctest.hdf and print out the contents of the 
         SDS's, together with the original dataset and dimension-related 
         information.

Makefile is the makefile for backward compatibility test.

transar() in a general utility function contained in transarray.c, which is on
the ftp server in subdirectory:

	ftp/HDF/contrib/NCSA

For users' convenience, a copy of transarray.c is included in this directory.
rs3.c is an example for how to call DFKNTsize() and transar().


