summaryrefslogtreecommitdiffstats
path: root/HDF5Examples/Using_Autotools.txt
diff options
context:
space:
mode:
Diffstat (limited to 'HDF5Examples/Using_Autotools.txt')
-rw-r--r--HDF5Examples/Using_Autotools.txt46
1 files changed, 46 insertions, 0 deletions
diff --git a/HDF5Examples/Using_Autotools.txt b/HDF5Examples/Using_Autotools.txt
new file mode 100644
index 0000000..83c47d5
--- /dev/null
+++ b/HDF5Examples/Using_Autotools.txt
@@ -0,0 +1,46 @@
+Example programs for HDF5
+
+See the Using_CMake.txt file for instructions on building Examples with CMake.
+
+autotools method
+============================
+To build all examples type:
+./configure
+make
+
+To test all the example programs type:
+make check
+
+Some notes:
+
+- This package uses h5cc (and h5fc) to compile the examples.
+
+- This package is not meant to be installed, `make install' will do
+nothing.
+
+- This package supports VPATH builds (run configure from a different
+directory), but will not automatically copy the data files a few
+examples need to run (*.h5) to the build directory. This must be done
+manually if you wish to run these examples from the build directory.
+`make check' is supported with VPATH - examples do not need to be
+manually copied for `make check' to work.
+
+- To build only 1.6 examples, set environmental variable `H5EX_16' to
+anything but null before running configure. Similarly to build only 1.8
+examples, set `H5EX_18', and to build only 1.10 examples, set `H5EX_110'.
+These variables can be set temporarily in the call to configure, e.g.
+`./configure H5EX_16=1'. Alternatively you can 'make' in a subdirectory
+to only build examples under that directory.
+
+- Similarly examples can be built only for specified classes by setting:
+ H5EX_G for groups
+ H5EX_D for datasets
+ H5EX_T for datatypes
+
+- This package requires HDF5 Library version 1.8 or later. If the
+default h5cc is not the correct version, you must set CC to the path to
+the correct h5cc. Compiling only 1.6 examples with a 1.6 library
+should work, but make check may fail.
+
+- This package links dynamically with the hdf5 library by default. To link
+statically use the --disable-shared option with configure.