[svn-r13379] Added 'make help' target. This actually runs a script, bin/makehelp (formatting

the output in the makefile was pretty hard). Tested that make still works on kagiso; no code changes at all.
2025-04-12 17:31:09 +08:00 · 2007-02-23 14:14:11 -05:00 · 2007-02-23 14:14:11 -05:00 · 0d86163705
commit 0d86163705
parent 182c05cb95
43 changed files with 232 additions and 40 deletions
--- a/1
+++ b/1
@ -57,6 +57,7 @@
 ./bin/locate_sw
 ./bin/ltmain.sh
 ./bin/make_err
+./bin/makehelp
 ./bin/missing
 ./bin/mkdirs
 ./bin/mkinstalldirs
--- a/Makefile.in
+++ b/Makefile.in
@ -791,7 +791,10 @@ uninstall-info: uninstall-info-recursive
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # Define rules for lib, progs, check, and tests.
 # These simply involve recursing into subdirectories.
--- a/bin/makehelp
+++ b/bin/makehelp
@ -0,0 +1,65 @@
+cat << EOF
+Help for HDF5 Makefiles
+For help with the make utility itself, try 'man make'.
+
+HDF5 makefiles are used to build, test, and install HDF5.  The exact
+behavior and output will depend on your system's version of make, compiler,
+etc.
+
+Usage: make [make options] [TARGET]
+
+Targets:
+make help:		print this help message
+
+make, make all:         (default if no target is specified)
+                        builds all libraries, tools, and tests
+make lib:               builds libraries only
+make progs:             builds libraries and programs
+make tests:             builds libraries, programs, and tests.
+                        Essentially the same as 'make all'.
+make check, make tests,
+make _test, make test:  Run HDF5's test suite.
+                        Make will exit with a failure if any tests fail.
+
+make install:           install HDF5 libraries, include files, and tools
+make install-examples:  installs example source files
+make install-all:       runs both make-install and make install-examples
+make check-install:     test building examples with installed HDF5 library
+make uninstall:         remove installed files
+make install-examples:  removes example source files
+make uninstall-all:     removes both installed libraries and examples
+
+make check-clean:       remove files generated by running tests
+                        (allows tests to be re-run)
+make mostlyclean:       remove intermediate files (*.o files).
+                        Doesn't clean libraries or executables.
+make clean:             remove all files generated by make or make check
+make distclean:         remove all files generated by make, make check, or
+                        configure
+
+make check-p:           Only run parallel tests
+make check-s:           Only run serial tests
+make check-vfd:         Run tests with each virtual file driver
+
+HDF5 uses Automake, so any standard Automake targets not listed here
+should also work.
+
+Configure options that affect Makefile behavior:
+        --enable-fortran, --enable-cxx, --enable-parallel, and --disable-hl
+enable or disable various interfaces.  Make will only recurse into these
+directories if they are specified at configure time.
+        --prefix=[path], --libdir=[path], --includedir=[path], etc. can be used
+to change the directory into which make install puts files.
+        --enable-build-all causes make to build some files that are only
+needed by developers (test file generation programs).
+
+Environment variables that affect Makefile behavior:
+        Make will honor environment variables like CFLAGS that are used when building and linking.
+        The variable HDF5TestExpress can be used to control the running time
+of the tests.  HDF5TestExpress = 0 is a full run of the tests while
+to run make check.  1 and 2 are intermediate values.  The default value is 1.
+
+Available command-line options for make depend on the version of make installed
+on your system.  Try 'man make'.
+
+EOF
--- a/c++/Makefile.in
+++ b/c++/Makefile.in
@ -648,7 +648,10 @@ uninstall-info: uninstall-info-recursive
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # Install examples
 install-examples uninstall-examples:
--- a/c++/examples/Makefile.in
+++ b/c++/examples/Makefile.in
@ -522,7 +522,10 @@ uninstall-am: uninstall-info-am uninstall-local
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # Some of the examples depend on files created by running other examples
 readdata.chkexe_: create.chkexe_
--- a/c++/src/Makefile.in
+++ b/c++/src/Makefile.in
@ -743,7 +743,10 @@ uninstall-am: uninstall-binSCRIPTS uninstall-includeHEADERS \
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # Some C++ compilers/linkers (PGI?) create a directory named "ii_files" that
 # holds *.ii files, which are template entity instantiations.
--- a/c++/test/Makefile.in
+++ b/c++/test/Makefile.in
@ -642,7 +642,10 @@ uninstall-am: uninstall-info-am
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # Some C++ compilers/linkers (PGI?) create a directory named "ii_files" that
 # holds *.ii files, which are template entity instantiations.
--- a/config/commence.am
+++ b/config/commence.am
@ -96,5 +96,8 @@ CHECK_CLEANFILES=*.chkexe *.chklog *.clog
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

--- a/examples/Makefile.in
+++ b/examples/Makefile.in
@ -532,7 +532,10 @@ uninstall-am: uninstall-info-am uninstall-local
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # How to build examples, using installed version of h5cc
@BUILD_PARALLEL_CONDITIONAL_TRUE@$(EXTRA_PROG): $(H5CC_PP)
--- a/fortran/Makefile.in
+++ b/fortran/Makefile.in
@ -657,7 +657,10 @@ uninstall-info: uninstall-info-recursive
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # Install examples
 install-examples uninstall-examples:
--- a/fortran/examples/Makefile.in
+++ b/fortran/examples/Makefile.in
@ -533,7 +533,10 @@ uninstall-am: uninstall-info-am uninstall-local
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # Some examples depend on files created by other examples.
 grpdsetexample.chkexe_: grpsexample.chkexe_
--- a/fortran/src/Makefile.in
+++ b/fortran/src/Makefile.in
@ -807,7 +807,10 @@ uninstall-am: uninstall-info-am uninstall-libLTLIBRARIES \
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # Fortran module files can have different extensions and different names
 # (e.g., different capitalizations) on different platforms.  Write rules
--- a/fortran/test/Makefile.in
+++ b/fortran/test/Makefile.in
@ -810,7 +810,10 @@ uninstall-am: uninstall-info-am
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # fflush2 depends on files created by fflush1
 fflush2.chkexe_: fflush1.chkexe_
--- a/fortran/testpar/Makefile.in
+++ b/fortran/testpar/Makefile.in
@ -608,7 +608,10 @@ uninstall-am: uninstall-info-am
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # lib/progs/tests targets recurse into subdirectories. build-* targets
 # build files in this directory.
--- a/hl/Makefile.in
+++ b/hl/Makefile.in
@ -654,7 +654,10 @@ uninstall-info: uninstall-info-recursive
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # Install examples
 install-examples uninstall-examples:
--- a/hl/c++/Makefile.in
+++ b/hl/c++/Makefile.in
@ -648,7 +648,10 @@ uninstall-info: uninstall-info-recursive
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # Install examples
 install-examples uninstall-examples:
--- a/hl/c++/examples/Makefile.in
+++ b/hl/c++/examples/Makefile.in
@ -520,7 +520,10 @@ uninstall-am: uninstall-info-am uninstall-local
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # How to build programs using h5c++
 $(EXTRA_PROG): $(H5CPP)
--- a/hl/c++/src/Makefile.in
+++ b/hl/c++/src/Makefile.in
@ -665,7 +665,10 @@ uninstall-am: uninstall-includeHEADERS uninstall-info-am \
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # lib/progs/tests targets recurse into subdirectories. build-* targets
 # build files in this directory.
--- a/hl/c++/test/Makefile.in
+++ b/hl/c++/test/Makefile.in
@ -616,7 +616,10 @@ uninstall-am: uninstall-info-am
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # lib/progs/tests targets recurse into subdirectories. build-* targets
 # build files in this directory.
--- a/hl/examples/Makefile.in
+++ b/hl/examples/Makefile.in
@ -527,7 +527,10 @@ uninstall-am: uninstall-info-am uninstall-local
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # Additional dependencies for each program are listed below.
@BUILD_PARALLEL_CONDITIONAL_TRUE@$(EXTRA_PROG): $(H5CC_PP)
--- a/hl/fortran/Makefile.in
+++ b/hl/fortran/Makefile.in
@ -652,7 +652,10 @@ uninstall-info: uninstall-info-recursive
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # Install examples
 install-examples uninstall-examples:
--- a/hl/fortran/examples/Makefile.in
+++ b/hl/fortran/examples/Makefile.in
@ -526,7 +526,10 @@ uninstall-am: uninstall-info-am uninstall-local
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # Tell automake how to build examples using h5fc
@BUILD_PARALLEL_CONDITIONAL_TRUE@$(EXTRA_PROG): $(H5FC_PP)
--- a/hl/fortran/src/Makefile.in
+++ b/hl/fortran/src/Makefile.in
@ -668,7 +668,10 @@ uninstall-am: uninstall-info-am uninstall-libLTLIBRARIES \
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # Fortran module files can have different extensions and different names
 # (e.g., different capitalizations) on different platforms.  Write rules
--- a/hl/fortran/test/Makefile.in
+++ b/hl/fortran/test/Makefile.in
@ -618,7 +618,10 @@ uninstall-am: uninstall-info-am
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # lib/progs/tests targets recurse into subdirectories. build-* targets
 # build files in this directory.
--- a/hl/src/Makefile.in
+++ b/hl/src/Makefile.in
@ -666,7 +666,10 @@ uninstall-am: uninstall-includeHEADERS uninstall-info-am \
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # lib/progs/tests targets recurse into subdirectories. build-* targets
 # build files in this directory.
--- a/hl/test/Makefile.in
+++ b/hl/test/Makefile.in
@ -656,7 +656,10 @@ uninstall-am: uninstall-info-am
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # lib/progs/tests targets recurse into subdirectories. build-* targets
 # build files in this directory.
--- a/hl/tools/Makefile.in
+++ b/hl/tools/Makefile.in
@ -650,7 +650,10 @@ uninstall-info: uninstall-info-recursive
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # lib/progs/tests targets recurse into subdirectories. build-* targets
 # build files in this directory.
--- a/hl/tools/gif2h5/Makefile.in
+++ b/hl/tools/gif2h5/Makefile.in
@ -653,7 +653,10 @@ uninstall-am: uninstall-binPROGRAMS uninstall-info-am
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # lib/progs/tests targets recurse into subdirectories. build-* targets
 # build files in this directory.
--- a/perform/Makefile.in
+++ b/perform/Makefile.in
@ -699,7 +699,10 @@ uninstall-am: uninstall-info-am
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # lib/progs/tests targets recurse into subdirectories. build-* targets
 # build files in this directory.
--- a/src/H5A.c
+++ b/src/H5A.c
@ -231,6 +231,8 @@ H5Acreate2(hid_t loc_id, const char *obj_name, const char *attr_name,
    hid_t		ret_value;              /* Return value */

    FUNC_ENTER_API(H5Acreate2, FAIL)
+    H5TRACE8("i", "issiiiii", loc_id, obj_name, attr_name, type_id, space_id,
+             acpl_id, aapl_id, lapl_id);

    /* check arguments */
    if(H5I_ATTR == H5I_get_type(loc_id))
@ -449,6 +451,7 @@ H5Aopen(hid_t loc_id, const char *obj_name, const char *attr_name,
    hid_t		ret_value;

    FUNC_ENTER_API(H5Aopen, FAIL)
+    H5TRACE5("i", "issii", loc_id, obj_name, attr_name, aapl_id, lapl_id);

    /* check arguments */
    if(H5I_ATTR == H5I_get_type(loc_id))
@ -516,6 +519,8 @@ H5Aopen_by_idx(hid_t loc_id, const char *obj_name, H5_index_t idx_type,
    hid_t	ret_value;      /* Return value */

    FUNC_ENTER_API(H5Aopen_by_idx, FAIL)
+    H5TRACE7("i", "isIiIohii", loc_id, obj_name, idx_type, order, n, aapl_id,
+             lapl_id);

    /* check arguments */
    if(H5I_ATTR == H5I_get_type(loc_id))
@ -1617,6 +1622,7 @@ H5Arename2(hid_t loc_id, const char *obj_name, const char *old_attr_name,
    herr_t	ret_value = SUCCEED;    /* Return value */

    FUNC_ENTER_API(H5Arename2, FAIL)
+    H5TRACE5("e", "isssi", loc_id, obj_name, old_attr_name, new_attr_name, lapl_id);

    /* check arguments */
    if(H5I_ATTR == H5I_get_type(loc_id))
--- a/src/Makefile.in
+++ b/src/Makefile.in
@ -1027,7 +1027,10 @@ uninstall-am: uninstall-includeHEADERS uninstall-info-am \
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # Copyright by The HDF Group.
 # Copyright by the Board of Trustees of the University of Illinois.
--- a/test/Makefile.in
+++ b/test/Makefile.in
@ -1206,7 +1206,10 @@ uninstall-am: uninstall-info-am
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # Additional target for running timing test
 timings _timings: testmeta
--- a/testpar/Makefile.in
+++ b/testpar/Makefile.in
@ -675,7 +675,10 @@ uninstall-am: uninstall-info-am
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # lib/progs/tests targets recurse into subdirectories. build-* targets
 # build files in this directory.
--- a/tools/Makefile.in
+++ b/tools/Makefile.in
@ -650,7 +650,10 @@ uninstall-info: uninstall-info-recursive
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # lib/progs/tests targets recurse into subdirectories. build-* targets
 # build files in this directory.
--- a/tools/h5copy/Makefile.in
+++ b/tools/h5copy/Makefile.in
@ -660,7 +660,10 @@ uninstall-am: uninstall-binPROGRAMS uninstall-info-am
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # lib/progs/tests targets recurse into subdirectories. build-* targets
 # build files in this directory.
--- a/tools/h5diff/Makefile.in
+++ b/tools/h5diff/Makefile.in
@ -684,7 +684,10 @@ uninstall-am: uninstall-binPROGRAMS uninstall-info-am
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # lib/progs/tests targets recurse into subdirectories. build-* targets
 # build files in this directory.
--- a/tools/h5dump/Makefile.in
+++ b/tools/h5dump/Makefile.in
@ -675,7 +675,10 @@ uninstall-am: uninstall-binPROGRAMS uninstall-info-am
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # lib/progs/tests targets recurse into subdirectories. build-* targets
 # build files in this directory.
--- a/tools/h5import/Makefile.in
+++ b/tools/h5import/Makefile.in
@ -657,7 +657,10 @@ uninstall-am: uninstall-binPROGRAMS uninstall-info-am
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # lib/progs/tests targets recurse into subdirectories. build-* targets
 # build files in this directory.
--- a/tools/h5jam/Makefile.in
+++ b/tools/h5jam/Makefile.in
@ -684,7 +684,10 @@ uninstall-am: uninstall-binPROGRAMS uninstall-info-am
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # lib/progs/tests targets recurse into subdirectories. build-* targets
 # build files in this directory.
--- a/tools/h5ls/Makefile.in
+++ b/tools/h5ls/Makefile.in
@ -637,7 +637,10 @@ uninstall-am: uninstall-binPROGRAMS uninstall-info-am
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # lib/progs/tests targets recurse into subdirectories. build-* targets
 # build files in this directory.
--- a/tools/h5repack/Makefile.in
+++ b/tools/h5repack/Makefile.in
@ -708,7 +708,10 @@ uninstall-am: uninstall-binPROGRAMS uninstall-info-am
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # lib/progs/tests targets recurse into subdirectories. build-* targets
 # build files in this directory.
--- a/tools/lib/Makefile.in
+++ b/tools/lib/Makefile.in
@ -647,7 +647,10 @@ uninstall-am: uninstall-info-am
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 # lib/progs/tests targets recurse into subdirectories. build-* targets
 # build files in this directory.
--- a/tools/misc/Makefile.in
+++ b/tools/misc/Makefile.in
@ -744,7 +744,10 @@ uninstall-am: uninstall-binPROGRAMS uninstall-binSCRIPTS \
 # exists.
 .PHONY: build-check-clean build-check-p build-check-s build-lib build-progs \
        build-tests check-clean check-install check-p check-s check-vfd \
-        install-doc lib progs tests uninstall-doc _exec_check-s _test
+        install-doc lib progs tests uninstall-doc _exec_check-s _test help
+
+help:
+	@$(top_srcdir)/bin/makehelp

 install-exec-local:
 	@$(INSTALL) h5cc $(bindir)/$(H5CC_NAME)