Junio C Hamano wrote:
> If all-caps INSTALL and README are not discoverable, there is not much
> hope that anything can be made more discoverable, is there?
I dunno. Something like the following could work, but I don't think
it's worth it.
diff --git a/Documentation/Makefile b/Documentation/Makefile
index 36989b7..9217c05 100644
--- a/Documentation/Makefile
+++ b/Documentation/Makefile
@@ -161,7 +161,22 @@ html: $(DOC_HTML)
$(DOC_HTML) $(DOC_MAN1) $(DOC_MAN5) $(DOC_MAN7): asciidoc.conf
-man: man1 man5 man7
+man_toolchain_test:
+ @$(ASCIIDOC) --version >/dev/null && \
+ xmlto --version >/dev/null || \
+ { \
+ printf '%s\n' \
+ '' \
+ 'Building the manpages requires asciidoc and xmlto.' \
+ 'Alternatively, pre-formatted documentation is' \
+ 'available in the "man" branch of the git repository itself.' \
+ 'See the INSTALL file for details.' \
+ '' && \
+ false; \
+ }
+.PHONY: man_toolchain_chest
+
+man: man_toolchain_test man1 man5 man7
man1: $(DOC_MAN1)
man5: $(DOC_MAN5)
man7: $(DOC_MAN7)
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html