HDF5 HL_REGION version 1.1.5 released on Tue Jul 19 09:35:59 CDT 2016
# 
# 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  for HDF5, version 1.8           **
          **         --enable-fortran      for HDF5, version 1.10          **
	  **                                                               **
          *******************************************************************

        * 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 

RELEASE PROCEDURE (for developer’s only):

  Linux
  ------
  (1) Run the script ‘bin/vers’ , e.g. —  ./bin/vers -s 1.1.4 VERSION
         -This will update the version number found in any of the source files.

  (2) Check the code into svn, e.g. — svn commit -m “updated the version from 1.1.3 to 1.1.4”

  (3) Update the Release.txt file.

  (4) Tag the svn trunk for the release, e.g. — svn copy . https://svn.hdfgroup.org/HL_NPOESS/tags/hdf5_hl_region-1_1_4

  (5) Run ./bin/release to obtain the source tar file and Check-sum.

  (6) Obtain the pre-built binaries from the daily tests.

  Windows
  --------
  (1) Enable "Release" configuration in WDTP.

  (2) Provide release zipfile to WDTP.

  (3) The WDTP will configure, build, test and package the binary.

  (4) WDTP will deposit the binary into the projects release location.

Release by updating the HDF webpage.



