HDF5 HL_REGION version 1.1.1 released on Tue Dec 20 14:46:17 CST 2011
# 
# Copyright by The HDF Group.
# All rights reserved.
#
# This file is part of the hl_region High-Level HDF5 APIs.  The full copyright 
# notice, including terms governing use, modification, and redistribution, 
# is contained in the file COPYING, which can be found at the root of the
# source code distribution tree and in the documentation directory (doc/html/).  
# If you do not have access to this file, you may request a copy of 
# "the hl_region High-Level HDF5 APIs copyright and license statement" from 
# help@hdfgroup.org.
# 
#############################################################################

STRUCTURE:

  src      - contains the source files (created library is stored here)
  examples - contains the examples
  test     - contains tests for the functions
  fortran  - contains:
               src - contains the source files
               examples - contains Fortran examples
               test - contains Fortran tests

INSTALLATION:

 - The environment variable HDF5_INSTALL_DIR must be set  
   to where the hdf5 library is installed.

 - make install and make clean will by default install the 
   installation files in the HDF5_INSTALL_DIR. This can be
   overridden by setting PREFIX= in the make command to the directory
   in which to place the files. Used for both install and clean make 
   commands.

 - make
        * compiles the C library (libhdf5_hl_region.a) in src
        * compiles C examples
        * compiles C tests

 - make -f Makefile-F03
        * compiles the C library (libhdf5_hl_region.a) in src
        * if h5fc is found then the Fortran wrappers, tests, and examples
            will also be compiled (libhdf5_hl_region_fortran.a).  
          IMPORTANT: Fortran compiler must have the ISO_C_BINDINGS module
        * compiles C and Fortran examples
        * compiles C and Fortran tests

 - make install
        * installs libhdf5_hl_region.a and, if present, libhdf5_hl_region_fortran.a
          to the lib directory in the hdf5 install tree; installs hl_region* header 
          files to the include directory in the hdf5 install tree. If Fortran is enabled
          then it will also install the hl_region modules in the include directory.

 - make uninstall
        * removes libhdf5_hl_region.a and, if present, libhdf5_hl_region_fortran.a
          from the lib directory in the hdf5 install tree; removes hl_region* header 
          files from the include directory in the hdf5 install tree. If Fortran is enabled
          then it will also remove the hl_region modules in the include directory.


 - make tests
        * runs the tests in 'test' and 'examples' directories

 - make clean
        * restores the directories to a cleaned state
 
USAGE:

  To compile a program using the library, example:

  h5cc ex_regref_read.c -L<path to libhdf5_hl_region*> -lhdf5_hl_region
  h5fc ex_regref_read.f90 -L<path to libhdf5_hl_region*> -lhdf5_hl_region_fortran -lhdf5_hl_region 

