From a90918e8244d98862d0183de949fe9764c40e4d5 Mon Sep 17 00:00:00 2001 From: Junio C Hamano Date: Mon, 18 Jun 2007 01:43:34 -0700 Subject: INSTALL: explain how to build documentation Signed-off-by: Junio C Hamano --- INSTALL | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) (limited to 'INSTALL') diff --git a/INSTALL b/INSTALL index 95269cc513..63ba1480a6 100644 --- a/INSTALL +++ b/INSTALL @@ -89,10 +89,16 @@ Issues of note: will include them. Note that config.mak is not distributed; the name is reserved for local settings. - - To build and install documentation suite, you need to have the - asciidoc/xmlto toolchain. Alternatively, pre-formatted - documentation are available in "html" and "man" branches of the git - repository itself. For example, you could: + - To build and install documentation suite, you need to have + the asciidoc/xmlto toolchain. Because not many people are + inclined to install the tools, the default build target + ("make all") does _not_ build them. The documentation is + written for AsciiDoc 7, but "make ASCIIDOC8=YesPlease doc" + will let you format with AsciiDoc 8. + + Alternatively, pre-formatted documentation are available in + "html" and "man" branches of the git repository itself. For + example, you could: $ mkdir manual && cd manual $ git init -- cgit v1.2.1