maint: don't run help2man on programs not-yet-built.

* Makefile.am (doc/libtool.1, doc/libtoolize.1): Added a
comment about why the dependencies here have to be a mite
bizarre.
(distcheck): Added a workaround for the bug described.

Signed-off-by: Gary V. Vaughan <gary@gnu.org>
diff --git a/ChangeLog b/ChangeLog
index 2f1621d..a9bc65d 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2010-09-01  Gary V. Vaughan  <gary@gnu.org>
+
+	maint: don't run help2man on programs not-yet-built.
+	* Makefile.am (doc/libtool.1, doc/libtoolize.1): Added a
+	comment about why the dependencies here have to be a mite
+	bizarre.
+	(distcheck): Added a workaround for the bug described.
+
 2010-09-26  Gary V. Vaughan  <gary@gnu.org>
 
 	tests: remove unused `aux_dir' variable from `getopt-m4sh.test'.
diff --git a/Makefile.am b/Makefile.am
index f06eb84..0ad4de3 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -394,10 +394,21 @@
 update_mans = \
   PATH=.$(PATH_SEPARATOR)$$PATH; export PATH; \
   $(HELP2MAN) --output='$@'
+
+# It's wrong to make distributed files (e.g. $(libtool_1)) rely on
+# files created in the build tree, so instead we regenerate the
+# manual pages if the sources for the build-tree files we want to
+# run have changed.
 $(libtool_1): $(ltmain_sh)
 	$(update_mans) --help-option=--help-all libtool
 $(libtoolize_1): $(libtoolize_in)
 	$(update_mans) libtoolize
+# That doesn't solve the problem of having `make' try to create
+# manual pages before the commands have been built, for example
+# with automake-1.11.1, `make distcheck' in a freshly checked out
+# and configured tree will fail.  The workaround is to make sure
+# `make check' is always called first:
+distcheck: all
 
 
 ## ------------- ##