summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSean Estabrooks <seanlkml@sympatico.ca>2006-04-28 13:15:06 (GMT)
committerJunio C Hamano <junkio@cox.net>2006-04-28 21:31:51 (GMT)
commit776e994af5b85d77424581bda37fb615897063cc (patch)
tree8463500e920d45279107b2180d190c74dea78e75
parent48aeecdcc14684111ddb8ac0ec3bfdc5245ee75e (diff)
downloadgit-776e994af5b85d77424581bda37fb615897063cc.zip
git-776e994af5b85d77424581bda37fb615897063cc.tar.gz
git-776e994af5b85d77424581bda37fb615897063cc.tar.bz2
Properly render asciidoc "callouts" in git man pages.
Adds an xsl fragment to render docbook callouts when converting to man page format. Update the Makefile to have "xmlto" use it when generating man pages. Signed-off-by: Sean Estabrooks <seanlkml@sympatico.ca>
-rw-r--r--Documentation/Makefile2
-rw-r--r--Documentation/callouts.xsl16
2 files changed, 17 insertions, 1 deletions
diff --git a/Documentation/Makefile b/Documentation/Makefile
index f4cbf7e..c1af22c 100644
--- a/Documentation/Makefile
+++ b/Documentation/Makefile
@@ -79,7 +79,7 @@ clean:
asciidoc -b xhtml11 -d manpage -f asciidoc.conf $<
%.1 %.7 : %.xml
- xmlto man $<
+ xmlto -m callouts.xsl man $<
%.xml : %.txt
asciidoc -b docbook -d manpage -f asciidoc.conf $<
diff --git a/Documentation/callouts.xsl b/Documentation/callouts.xsl
new file mode 100644
index 0000000..ad03755
--- /dev/null
+++ b/Documentation/callouts.xsl
@@ -0,0 +1,16 @@
+<!-- callout.xsl: converts asciidoc callouts to man page format -->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+<xsl:template match="co">
+ <xsl:value-of select="concat('\fB(',substring-after(@id,'-'),')\fR')"/>
+</xsl:template>
+<xsl:template match="calloutlist">
+ <xsl:text>.sp&#10;</xsl:text>
+ <xsl:apply-templates/>
+ <xsl:text>&#10;</xsl:text>
+</xsl:template>
+<xsl:template match="callout">
+ <xsl:value-of select="concat('\fB',substring-after(@arearefs,'-'),'. \fR')"/>
+ <xsl:apply-templates/>
+ <xsl:text>.br&#10;</xsl:text>
+</xsl:template>
+</xsl:stylesheet>