* stepmake/stepmake/*:

[lilypond.git] / stepmake / stepmake / help2man-rules.make

diff --git a/stepmake/stepmake/help2man-rules.make b/stepmake/stepmake/help2man-rules.make
index b2f86ea8fc2dddebf5e412ed36474084bbffe0e9..51073c20b1e183aad51a215d54a13c73fa053159 100644 (file)
--- a/stepmake/stepmake/help2man-rules.make
+++ b/stepmake/stepmake/help2man-rules.make
@@ -1,15 +1,35 @@
-# ugh. 
-# Man-page:
+# We must invoke the generated $(outdir)/help2man script instead of
+# the help2man.pl source, which means that the buildscripts directory
+# must be built first.
+#
+# From the perlrun man-page:
+#
 #      If the #! line does not contain the word "perl", the
 #       program named after the #! is executed instead of the Perl
 #       interpreter.  This is slightly bizarre, but it helps
-# Indeed it is. Perl sucks.
 #
+# Indeed it is.  Perl sucks.
+#
+# Two screenfulls explaining that the otherwise standard #! is broken
+# for perl, and arguing that this broken magic is better in some
+# cases.  Four more explaining what a line comment is, and that it may
+# be parsed, same here.
+
+HELP2MAN_COMMAND = $(PERL) $(top-build-dir)/buildscripts/$(outbase)/help2man $< > $@
+
+ifeq ($(strip $(CROSS)),no)
 $(outdir)/%.1: $(outdir)/%
-       $(PERL) $(depth)/buildscripts/$(outdir)/help2man $< > $@ || \
-       (echo ""; echo "Apparently the man pages failed to build. This is";\
-       echo "no problem, since they don't contain any information anyway.";\
-       echo "Please run make again, and be prepared for NO manual pages.")
+       $(HELP2MAN_COMMAND)
+else
+# When cross building, some manpages will not build because the
+# executable does not run.  We assume the manpages to be generated
+# during a previous compile for the build host, with config=for-build,
+# in the directory $(outdir)-for-build.
+$(outdir)/%.1: $(outdir:%=%-for-build)/%.1
+       cp $< $@
+endif
 
+ifneq ($(outdir),./out)
 $(outdir)/%.1: out/%.1
        cp $< $@
+endif