HDF5 HL_REGION version 1.1.3 released on Tue Dec  9 13:21:10 CST 2014
# 
# 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

CMAKE INSTALLATION:
       -- See Using_CMake.txt --


AUTOTOOLS INSTALLATION:

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

 - make install and make uninstall will by default install/uninstall the 
   installation files in the HDF5_INSTALL_DIR lib directory. This can be
   overridden by setting 'prefix=' in the "make install" command,

          make install prefix=<path to install directory>
          make uninstall prefix=<path to install directory>

   to the directory in which to place the files.

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

 - make enable-fortran=yes
        * 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).

          *******************************************************************
          **                        I M P O R T A N T                      **
          ** (1) Fortran compiler must be F2003 standard compliant and     **
	  **     have the ISO_C_BINDINGS module                            **
          ** (2) HDF5 library needs to be built with --enable-fortran2003  **
	  **                                                               **
          *******************************************************************

        * compiles C and Fortran examples
        * compiles C and Fortran tests

	NOTE: If enable-fortran is present then Fortran will always be compiled,
        regardless of the value set for enable-fortran (i.e its value is ignored).

 - make install (with optional prefix=)
        * 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 (with optional prefix=)
        * 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' located in the main directory and the 
          fortran sub-directory (assuming Fortran was enabled).

 - make clean (with optional prefix=)
        * 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 

