From: Junio C Hamano <gitster@pobox.com>
Date: Mon, 18 Jun 2007 08:43:34 +0000 (-0700)
Subject: INSTALL: explain how to build documentation
X-Git-Tag: v1.5.3-rc0~76
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=a90918e8244d98862d0183de949fe9764c40e4d5;p=git.git

INSTALL: explain how to build documentation

Signed-off-by: Junio C Hamano <gitster@pobox.com>
---

diff --git a/INSTALL b/INSTALL
index 95269cc51..63ba1480a 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