#*****************************************************************************
# 
#			  NCSA HDF version 3.10r2
#				Sept 20, 1990
#
#*****************************************************************************

--------------- Description of HDF source files ----------------

The following is a description of the various subdirectories and files. 

Subdirectories:
     src:            source code
     contrib:        contributions from hdf users outside NCSA
     doc:            documentation
     examples:       examples of hdf programs--good for testing, too
     fptohdf:        files associated with fptohdf utility, for 
                        converting floating point data to hdf formats
     hdfed:          files associated with hdfed, which provides some
                        editing (mainly browsing) capabilities for hdf files
     newsletters:    hdf newsletters
     

src files:    (description of files in source directory)
       CODECHANGES - describes changes since last release
       HINTS - hints on how to port HDF to non-supported machines
       INSTALL - instructions on installing HDF (READ THIS BEFORE CALLING)             df.h - header file included in all HDF source files and user programs 
       dfi.h - internal header file, included automatically by df.h 
       df.c - low-level routines which perform I/O to HDF files etc.
       dfrig.h - header file for the Raster Image Group set
       dfr8.c - routines to implement 8-bit raster image groups
       dfgroup.c - routines to read and write groups (of tag/refs)
       dfcomp.c - routines for data compression
       dfimcomp.c - routines to implement the IMCOMP compression scheme
       dfsd.c - routines to implement the Scientific Data set
       dfsd.h - header file for the Scientific Data set
       dfkit.c - HDF internal utility routines
       dfgr.h - header for general raster
       dfgr.c - routines for general raster
       dfan.h - header for annotations
       dfan.c - routines for annotations
       dfp.c - routines for palette
       df24.c - routines for 24 bit raster
       hdfls.c - source for "hdfls" which lists contents of HDF files
       hdfrseq.c - source for "hdfseq" which displays images in 
               HDF files and "hdfrseq" which produces ICR output for display
               on remote screen
       r8tohdf.c - source for "r8tohdf" which converts raw image,
              palette files to HDF
       hdftor8.c - src for "hdftor8" which extracts raw 8 bit image and
	       palette files from HDF.
       srtohdf.c - src for "srctohdf" which converts sun-raster files to HDF
       Makefile - makefile for the HDF system
       MAKE.*   - make files for individual machines.  Look in the file,
                  towards the top, for machines that each file applies to.

       Files for fortran stubs:
       constants.f - header file that defines important HDF constants.
       dfF.c    - C stubs for fortran interface to df.c routines
       dfr8F.c  - C stubs for fortran interface to dfr8.c routines
       dfsdF.c  - C stubs for fortran interface to dfsd.c routines
       dfanF.c  - C stubs for fortran interface to dfan.c routines
       dfpF.c   - C stubs for fortran interface to dfp.c routines
       df24F.c  - C stubs for fortran interface to df24.c routines
       dfFf.f (l.dfFf.f s.dfFf.f)   - fort stubs for interface to df.c routines
       dfr8Ff.f (l.dfr8Ff.f s.dfr8Ff.f) - fort stubs ... dfr8.c routines
       dfsdFf.f (l.dfsdFf.f s.dfsdFf.f) - fort stubs ... dfsd.c routines
       dfanFf.f (l.dfanFf.f s.dfanFf.f) - fort stubs ... dfan.c routines
       dfpFf.f (l.dfpFf.f s.dfpFf.f)    - fort stubs ... dfp.c routines
       df24Ff.f (l.df24Ff.f s.df24Ff.f) - fort stubs ... df24.c routines

       Files specific to VMS:
       dfivms.h - VMS specific header file
       MAKE.COM - VMS make script
       MAKELIB.COM -VMS make script for library
       MAKEUTILS.COM - VMS make script for utilities
       MAKENOF.COM - VMS make script to exclude FORTRAN calls
       SETUPUTILS.COM - VMS file for initializing utilities
       fixatr/* - files and scripts for makeing fixatr for VMS

       Makefile.hqx - binhexed MPW makefile

doc:
       doc/ascii/NCSA_HDF/*       - ASCII format documentation for HDF
       doc/ascii/HDF_Specs/*      - ASCII format technical specification 
              of HDF
       doc/postscript/NCSA_HDF/*  - postscript format documentation for HDF
       doc/postscript/HDF_Specs/* - postscript format technical 
                                    specification of HDF
       doc/man                    - man files (currently there's only one)
