From: Philippe Proulx <eeppeliteloop@gmail.com>
Date: Tue, 1 Sep 2015 14:58:42 +0000 (-0400)
Subject: doc/man: add XSL files for man pages
X-Git-Tag: v2.8.0-rc1~58
X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=commitdiff_plain;h=b1cb4eb6fa8d90cb9fb631d7f0153901724aecf9;hp=f95ec87d0f3f4a6c8119e95394bbb5b3aed3a651

doc/man: add XSL files for man pages

Those XSL files, some of them inspired by Git documentation's own
XSL files, manipulate the intermediate DocBook XML file to
fine-tune the man pages rendering.

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>
Signed-off-by: Jérémie Galarneau <jeremie.galarneau@efficios.com>
---

diff --git a/doc/man/xsl/manpage-base.xsl b/doc/man/xsl/manpage-base.xsl
new file mode 100644
index 000000000..2f7a5d7f3
--- /dev/null
+++ b/doc/man/xsl/manpage-base.xsl
@@ -0,0 +1,17 @@
+<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:value-of select="."/>
+        <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:value-of select="."/>
+        <xsl:text>br&#10;</xsl:text>
+   </xsl:template>
+</xsl:stylesheet>
diff --git a/doc/man/xsl/manpage-bold-literal.xsl b/doc/man/xsl/manpage-bold-literal.xsl
new file mode 100644
index 000000000..c0e0900aa
--- /dev/null
+++ b/doc/man/xsl/manpage-bold-literal.xsl
@@ -0,0 +1,7 @@
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+    <xsl:template match="literal">
+        <xsl:text>\fB</xsl:text>
+        <xsl:value-of select="." />
+        <xsl:text>\fR</xsl:text>
+    </xsl:template>
+</xsl:stylesheet>
diff --git a/doc/man/xsl/manpage-ulinks.xsl b/doc/man/xsl/manpage-ulinks.xsl
new file mode 100644
index 000000000..5e4b79463
--- /dev/null
+++ b/doc/man/xsl/manpage-ulinks.xsl
@@ -0,0 +1,5 @@
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+    <xsl:template match="ulink">
+        <xsl:apply-templates/>
+    </xsl:template>
+</xsl:stylesheet>
diff --git a/doc/man/xsl/manpage.xsl b/doc/man/xsl/manpage.xsl
new file mode 100644
index 000000000..50db18966
--- /dev/null
+++ b/doc/man/xsl/manpage.xsl
@@ -0,0 +1,8 @@
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+    <xsl:import href="manpage-base.xsl" />
+    <xsl:import href="manpage-bold-literal.xsl" />
+    <xsl:import href="manpage-ulinks.xsl" />
+
+    <!-- disable end notes -->
+    <xsl:param name="man.endnotes.are.numbered">0</xsl:param>
+</xsl:stylesheet>