[svn-r2625] Purpose:

    Bug fix and feature
Description:
    It could not find a working h5dump to process the hdf5 files.
    This could be because h5dump is not installed in $PATH or
    a disfunctional one is found. (E.g. arabica:/usr/sdt/bin/h5dump
    does not work.)
    Setting it to ./h5dump or $PWD/h5dump does not work because
    when h5dump is used, it has "cd testfiles", a different place.
Solution:
    Set H5DUMP with the current absolute path (used `pwd` instead
    of $PWD which is sometimes not set for whatever reason.)
    Also add a feature to allow H5DUMP to be set to a different
    value by hand.  For example, if the h5dump just built is not
    working correctly, one can do "H5DUMP=/usr/local/bin/h5dump make check"
    to bypass the broken h5dump.
Platforms tested:
    arabica

1 files changed, 14 insertions, 1 deletions

diff --git a/tools/testh4toh5 b/tools/testh4toh5
index 261c609..848d02a 100644
--- a/tools/testh4toh5
+++ b/tools/testh4toh5
@@ -1,4 +1,16 @@
 #!/bin/sh
+# Test script for the h4toh5 tests.
+# Using the h4toh5 convert to convert a pre-created hdf file to
+# an hdf5 file (output file), then compare it with a pre-created
+# corresponding hdf5 file (expected file).
+# If the same, that particular test passes.
+# If not the same, the output file and expected file are processed
+# by the h5dump tool to see if they produce the same results.
+# If the same, the test passes.
+# If not, show the difference of the two results and report the test failed.
+#
+# h5dump is default to use the one just built.  It can be overridden
+# by setting $H5DUMP to a different value such as /usr/local/bin/h5dump.
 
 h4toh5=./h4toh5		# a relative name
 cmp='cmp -s'
@@ -6,7 +18,8 @@ diff='diff -c'
 
 RM='rm -f'
 SED='sed '
-H5DUMP='h5dump'	# Use the h5dumper in the same tools directory
+H5DUMP=${H5DUMP:-`pwd`/'h5dump'}	# Default to use the h5dumper
+					# in the same tools directory
 
 # Verify if $H5DUMP is a valid command.
 tmpfile=/tmp/testh4toh5.$$