INSTALL: add warning on docbook-xsl 1.72 and 1.73
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Junio C Hamano committed
Aug 3, 2007 at 20:19 UTC
2ec39edad9c3be74b5fed5ab5c122493e6a53c66
2 files changed
+25
INSTALL
+4
@@ -116,3 +116,7 @@ Issues of note:
116
would instead give you a copy of what you see at:
117
118
http://www.kernel.org/pub/software/scm/git/docs/
119
+
120
+ It has been reported that docbook-xsl version 1.72 and 1.73 are
121
+ buggy; 1.72 misformats manual pages for callouts, and 1.73 needs
122
+ the patch in contrib/patches/docbook-xsl-manpages-charmap.patch
contrib/patches/docbook-xsl-manpages-charmap.patch
new
+21
@@ -0,0 +1,21 @@
1
+From: Ismail Dönmez <ismail@pardus.org.tr>
2
+
3
+Trying to build the documentation with docbook-xsl 1.73 may result in
4
+the following error. This patch fixes it.
5
+
6
+$ xmlto -m callouts.xsl man git-add.xml
7
+runtime error: file
8
+file:///usr/share/sgml/docbook/xsl-stylesheets-1.73.0/manpages/other.xsl line
9
+129 element call-template
10
+The called template 'read-character-map' was not found.
11
+
12
+--- docbook-xsl-1.73.0/manpages/docbook.xsl.manpages-charmap 2007-07-23 16:24:23.000000000 +0100
13
++++ docbook-xsl-1.73.0/manpages/docbook.xsl 2007-07-23 16:25:16.000000000 +0100
14
+@@ -37,6 +37,7 @@
15
+ <xsl:include href="lists.xsl"/>
16
+ <xsl:include href="endnotes.xsl"/>
17
+ <xsl:include href="table.xsl"/>
18
++ <xsl:include href="../common/charmap.xsl"/>
19
+
20
+ <!-- * we rename the following just to avoid using params with "man" -->
21
+ <!-- * prefixes in the table.xsl stylesheet (because that stylesheet -->