Describe DOCBOOK_XSL_172, ASCIIDOC_NO_ROFF options in Makefile

jrn · gitster · commit 162213d2329d · 2009-10-09T14:38:14.000-07:00
There is excellent documentation for these options in
Documentation/Makefile, but some users may never find it.

Signed-off-by: Jonathan Nieder &lt;jrnieder@gmail.com&gt;
Signed-off-by: Junio C Hamano &lt;gitster@pobox.com&gt;
diff --git a/Makefile b/Makefile
@@ -153,7 +153,11 @@ all::
 #
 # Define ASCIIDOC8 if you want to format documentation with AsciiDoc 8
 #
-# Define DOCBOOK_XSL_172 if you want to format man pages with DocBook XSL v1.72.
+# Define DOCBOOK_XSL_172 if you want to format man pages with DocBook XSL v1.72
+# (not v1.73 or v1.71).
+#
+# Define ASCIIDOC_NO_ROFF if your DocBook XSL escapes raw roff directives
+# (versions 1.72 and later and 1.68.1 and earlier).
 #
 # Define NO_PERL_MAKEMAKER if you cannot use Makefiles generated by perl's
 # MakeMaker (e.g. using ActiveState under Cygwin).

Original file line number	Diff line number	Diff line change
`@@ -153,7 +153,11 @@ all::`
`153`	`153`	`#`
`154`	`154`	`# Define ASCIIDOC8 if you want to format documentation with AsciiDoc 8`
`155`	`155`	`#`
`156`		`-# Define DOCBOOK_XSL_172 if you want to format man pages with DocBook XSL v1.72.`
	`156`	`+# Define DOCBOOK_XSL_172 if you want to format man pages with DocBook XSL v1.72`
	`157`	`+# (not v1.73 or v1.71).`
	`158`	`+#`
	`159`	`+# Define ASCIIDOC_NO_ROFF if your DocBook XSL escapes raw roff directives`
	`160`	`+# (versions 1.72 and later and 1.68.1 and earlier).`
`157`	`161`	`#`
`158`	`162`	`# Define NO_PERL_MAKEMAKER if you cannot use Makefiles generated by perl's`
`159`	`163`	`# MakeMaker (e.g. using ActiveState under Cygwin).`