docs: generate links from plain text documentation

There are two forms used throughout libvirt code comments, which
are both supported by this patch.

* plain links like e.g. http://www.libvirt.org/
* links enclosed in <> characters, e.g. <http://www.libvirt.org/>

Signed-off-by: Claudio Bley <cbley@av-test.de>
This commit is contained in:
Claudio Bley 2013-01-14 13:37:02 +01:00
parent 52dbeac8e7
commit 5eb3dff5b6

View File

@ -129,6 +129,19 @@
<a href="libvirt-{$ref/@file}.html#{$ref/@name}"><xsl:value-of select="$stem"/></a>
<xsl:value-of select="substring-after($token, $stem)"/>
</xsl:when>
<xsl:when test="starts-with($token, 'http://')">
<a href="{$token}">
<xsl:value-of select="$token"/>
</a>
</xsl:when>
<xsl:when test="starts-with($token, '&lt;http://') and contains($token, '&gt;')">
<xsl:variable name="link"
select="substring(substring-before($token, '&gt;'), 2)"/>
<a href="{$link}">
<xsl:value-of select="$link"/>
</a>
<xsl:value-of select="substring-after($token, '&gt;')"/>
</xsl:when>
<xsl:otherwise>
<xsl:value-of select="$token"/>
</xsl:otherwise>
@ -690,7 +703,11 @@
<h2 style="font-weight:bold;color:red;text-align:center">This module is deprecated</h2>
</xsl:if>
<xsl:if test="description">
<p><xsl:value-of select="description"/></p>
<p>
<xsl:call-template name="dumptext">
<xsl:with-param name="text" select="description"/>
</xsl:call-template>
</p>
</xsl:if>
</xsl:template>