summaryrefslogtreecommitdiffstatshomepage
path: root/3rdparty/asio/src/doc/tutorial.xsl
diff options
context:
space:
mode:
Diffstat (limited to '3rdparty/asio/src/doc/tutorial.xsl')
-rw-r--r--3rdparty/asio/src/doc/tutorial.xsl437
1 files changed, 437 insertions, 0 deletions
diff --git a/3rdparty/asio/src/doc/tutorial.xsl b/3rdparty/asio/src/doc/tutorial.xsl
new file mode 100644
index 00000000000..da9be491d53
--- /dev/null
+++ b/3rdparty/asio/src/doc/tutorial.xsl
@@ -0,0 +1,437 @@
+<?xml version="1.0" encoding="utf-8"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+
+<!--
+ Copyright (c) 2003-2016 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+-->
+
+<xsl:output method="text"/>
+<xsl:strip-space elements="*"/>
+
+
+<xsl:variable name="newline">
+<xsl:text>
+</xsl:text>
+</xsl:variable>
+
+
+<xsl:template match="/doxygen">
+<xsl:text>[/
+ / Copyright (c) 2003-2016 Christopher M. Kohlhoff (chris at kohlhoff dot com)
+ /
+ / Distributed under the Boost Software License, Version 1.0. (See accompanying
+ / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ /]
+
+[section:tutorial Tutorial]
+
+</xsl:text>
+
+ <xsl:for-each select="compounddef[@kind = 'page' and @id = 'indexpage']">
+ <xsl:apply-templates select="detaileddescription"/>
+ </xsl:for-each>
+
+ <xsl:for-each select="
+ compounddef[
+ @kind = 'page' and
+ @id != 'indexpage' and
+ not(contains(@id, 'src'))]">
+ <xsl:text>[section:</xsl:text>
+ <xsl:value-of select="concat(@id, ' ', title)"/>
+ <xsl:text>]</xsl:text>
+ <xsl:value-of select="$newline"/>
+ <xsl:value-of select="$newline"/>
+ <xsl:apply-templates select="detaileddescription"/>
+ <xsl:variable name="srcid" select="concat(@id, 'src')"/>
+ <xsl:if test="count(/doxygen/compounddef[@id = $srcid]) &gt; 0">
+ <xsl:value-of select="$newline"/>
+ <xsl:value-of select="$newline"/>
+ <xsl:text>[section:src </xsl:text>
+ <xsl:value-of select="/doxygen/compounddef[@id = $srcid]/title"/>
+ <xsl:text>]</xsl:text>
+ <xsl:value-of select="$newline"/>
+ <xsl:value-of select="$newline"/>
+ <xsl:apply-templates select="/doxygen/compounddef[@id = $srcid]/detaileddescription"/>
+ <xsl:text>[endsect]</xsl:text>
+ <xsl:value-of select="$newline"/>
+ <xsl:value-of select="$newline"/>
+ </xsl:if>
+ <xsl:text>[endsect]</xsl:text>
+ <xsl:value-of select="$newline"/>
+ <xsl:value-of select="$newline"/>
+ </xsl:for-each>
+
+ <xsl:value-of select="$newline"/>
+ <xsl:text>[endsect]</xsl:text>
+
+</xsl:template>
+
+
+<!--========== Utilities ==========-->
+
+<xsl:template name="strip-asio-ns">
+ <xsl:param name="name"/>
+ <xsl:choose>
+ <xsl:when test="contains($name, 'boost::system::is_error_code_enum')">
+ <xsl:value-of select="$name"/>
+ </xsl:when>
+ <xsl:when test="contains($name, 'asio::')">
+ <xsl:value-of select="substring-after($name, 'asio::')"/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:value-of select="$name"/>
+ </xsl:otherwise>
+ </xsl:choose>
+</xsl:template>
+
+
+<xsl:template name="make-id">
+ <xsl:param name="name"/>
+ <xsl:choose>
+ <xsl:when test="contains($name, '::')">
+ <xsl:call-template name="make-id">
+ <xsl:with-param name="name"
+ select="concat(substring-before($name, '::'), '__', substring-after($name, '::'))"/>
+ </xsl:call-template>
+ </xsl:when>
+ <xsl:when test="contains($name, '=')">
+ <xsl:call-template name="make-id">
+ <xsl:with-param name="name"
+ select="concat(substring-before($name, '='), '_eq_', substring-after($name, '='))"/>
+ </xsl:call-template>
+ </xsl:when>
+ <xsl:when test="contains($name, '!')">
+ <xsl:call-template name="make-id">
+ <xsl:with-param name="name"
+ select="concat(substring-before($name, '!'), '_not_', substring-after($name, '!'))"/>
+ </xsl:call-template>
+ </xsl:when>
+ <xsl:when test="contains($name, '&lt;')">
+ <xsl:call-template name="make-id">
+ <xsl:with-param name="name"
+ select="concat(substring-before($name, '&lt;'), '_lt_', substring-after($name, '&lt;'))"/>
+ </xsl:call-template>
+ </xsl:when>
+ <xsl:when test="contains($name, '&gt;')">
+ <xsl:call-template name="make-id">
+ <xsl:with-param name="name"
+ select="concat(substring-before($name, '&gt;'), '_gt_', substring-after($name, '&gt;'))"/>
+ </xsl:call-template>
+ </xsl:when>
+ <xsl:when test="contains($name, '+')">
+ <xsl:call-template name="make-id">
+ <xsl:with-param name="name"
+ select="concat(substring-before($name, '+'), '_plus_', substring-after($name, '+'))"/>
+ </xsl:call-template>
+ </xsl:when>
+ <xsl:when test="contains($name, '~')">
+ <xsl:call-template name="make-id">
+ <xsl:with-param name="name"
+ select="concat(substring-before($name, '~'), '_', substring-after($name, '~'))"/>
+ </xsl:call-template>
+ </xsl:when>
+ <xsl:when test="contains($name, ' ')">
+ <xsl:call-template name="make-id">
+ <xsl:with-param name="name"
+ select="concat(substring-before($name, ' '), '_', substring-after($name, ' '))"/>
+ </xsl:call-template>
+ </xsl:when>
+ <xsl:when test="contains($name, 'boost__posix_time__ptime')">
+ <xsl:call-template name="make-id">
+ <xsl:with-param name="name"
+ select="concat(substring-before($name, 'boost__posix_time__ptime'), 'ptime', substring-after($name, 'boost__posix_time__ptime'))"/>
+ </xsl:call-template>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:value-of select="$name"/>
+ </xsl:otherwise>
+ </xsl:choose>
+</xsl:template>
+
+
+<xsl:template name="replace-scope-marker">
+ <xsl:param name="text"/>
+ <xsl:choose>
+ <xsl:when test="contains($text, '_1_1')">
+ <xsl:call-template name="replace-scope-marker">
+ <xsl:with-param name="text"
+ select="concat(substring-before($text, '_1_1'), '::', substring-after($text, '_1_1'))"/>
+ </xsl:call-template>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:value-of select="$text"/>
+ </xsl:otherwise>
+ </xsl:choose>
+</xsl:template>
+
+
+<xsl:template name="refid-to-anchor">
+ <xsl:param name="text"/>
+ <xsl:variable name="scoped-text">
+ <xsl:call-template name="replace-scope-marker">
+ <xsl:with-param name="text" select="$text"/>
+ </xsl:call-template>
+ </xsl:variable>
+ <xsl:value-of select="substring-after($scoped-text, '_1')"/>
+</xsl:template>
+
+
+<!--========== Markup ==========-->
+
+<xsl:template match="para">
+ <xsl:apply-templates/>
+ <xsl:value-of select="$newline"/>
+ <xsl:value-of select="$newline"/>
+</xsl:template>
+
+
+<xsl:template match="title">
+ <xsl:variable name="title">
+ <xsl:value-of select="."/>
+ </xsl:variable>
+ <xsl:if test="string-length($title) > 0">
+ <xsl:text>[heading </xsl:text>
+ <xsl:value-of select="."/>
+ <xsl:text>]</xsl:text>
+ <xsl:value-of select="$newline"/>
+ <xsl:value-of select="$newline"/>
+ </xsl:if>
+</xsl:template>
+
+
+<xsl:template match="programlisting">
+ <xsl:value-of select="$newline"/>
+ <xsl:apply-templates/>
+ <xsl:value-of select="$newline"/>
+</xsl:template>
+
+
+<xsl:template match="codeline">
+ <xsl:if test="string-length(.) &gt; 0">
+ <xsl:text> ``''''''``</xsl:text>
+ </xsl:if>
+ <xsl:apply-templates mode="codeline"/>
+ <xsl:value-of select="$newline"/>
+</xsl:template>
+
+
+<xsl:template match="sp">
+ <xsl:text> </xsl:text>
+</xsl:template>
+
+
+<xsl:template match="sp" mode="codeline">
+ <xsl:text> </xsl:text>
+</xsl:template>
+
+
+<xsl:template match="linebreak">
+ <xsl:value-of select="$newline"/>
+ <xsl:value-of select="$newline"/>
+</xsl:template>
+
+
+<xsl:template match="listitem">
+ <xsl:text>* </xsl:text>
+ <xsl:apply-templates/>
+ <xsl:value-of select="$newline"/>
+</xsl:template>
+
+
+<xsl:template match="emphasis">
+ <xsl:text>[*</xsl:text>
+ <xsl:value-of select="."/>
+ <xsl:text>]</xsl:text>
+</xsl:template>
+
+
+<xsl:template match="computeroutput">
+ <xsl:text>`</xsl:text>
+ <xsl:value-of select="."/>
+ <xsl:text>`</xsl:text>
+</xsl:template>
+
+
+<xsl:template match="text()">
+ <xsl:variable name="text" select="."/>
+ <xsl:variable name="starts-with-whitespace" select="
+ starts-with($text, ' ') or starts-with($text, $newline)"/>
+ <xsl:variable name="preceding-node-name">
+ <xsl:for-each select="preceding-sibling::*">
+ <xsl:if test="position() = last()">
+ <xsl:value-of select="local-name()"/>
+ </xsl:if>
+ </xsl:for-each>
+ </xsl:variable>
+ <xsl:variable name="after-newline" select="
+ $preceding-node-name = 'programlisting' or
+ $preceding-node-name = 'linebreak'"/>
+ <xsl:choose>
+ <xsl:when test="$starts-with-whitespace and $after-newline">
+ <xsl:call-template name="escape-text">
+ <xsl:with-param name="text">
+ <xsl:call-template name="strip-leading-whitespace">
+ <xsl:with-param name="text" select="$text"/>
+ </xsl:call-template>
+ </xsl:with-param>
+ </xsl:call-template>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:call-template name="escape-text">
+ <xsl:with-param name="text" select="$text"/>
+ </xsl:call-template>
+ </xsl:otherwise>
+ </xsl:choose>
+</xsl:template>
+
+
+<xsl:template name="strip-leading-whitespace">
+ <xsl:param name="text"/>
+ <xsl:choose>
+ <xsl:when test="starts-with($text, ' ')">
+ <xsl:call-template name="strip-leading-whitespace">
+ <xsl:with-param name="text" select="substring($text, 2)"/>
+ </xsl:call-template>
+ </xsl:when>
+ <xsl:when test="starts-with($text, $newline)">
+ <xsl:call-template name="strip-leading-whitespace">
+ <xsl:with-param name="text" select="substring($text, 2)"/>
+ </xsl:call-template>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:value-of select="$text"/>
+ </xsl:otherwise>
+ </xsl:choose>
+</xsl:template>
+
+
+<xsl:template name="escape-text">
+ <xsl:param name="text"/>
+ <xsl:choose>
+ <xsl:when test="contains($text, '_')">
+ <xsl:value-of select="substring-before($text, '_')"/>
+ <xsl:text>\_</xsl:text>
+ <xsl:call-template name="escape-text">
+ <xsl:with-param name="text" select="substring-after($text, '_')"/>
+ </xsl:call-template>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:value-of select="$text"/>
+ </xsl:otherwise>
+ </xsl:choose>
+</xsl:template>
+
+
+<xsl:template match="ref[@kindref='compound']">
+ <xsl:variable name="name">
+ <xsl:value-of select="."/>
+ </xsl:variable>
+ <xsl:variable name="refid">
+ <xsl:value-of select="@refid"/>
+ </xsl:variable>
+ <xsl:choose>
+ <xsl:when test="count(/doxygen/compounddef[@id=$refid]) &gt; 0">
+ <xsl:text>[link asio.tutorial.</xsl:text>
+ <xsl:choose>
+ <xsl:when test="contains($refid, 'src')">
+ <xsl:value-of select="substring-before($refid, 'src')"/>
+ <xsl:text>.src</xsl:text>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:value-of select="$refid"/>
+ </xsl:otherwise>
+ </xsl:choose>
+ <xsl:value-of select="concat(' ', .)"/>
+ <xsl:text>]</xsl:text>
+ </xsl:when>
+ <xsl:when test="contains($name, 'asio::')">
+ <xsl:variable name="ref-name">
+ <xsl:call-template name="strip-asio-ns">
+ <xsl:with-param name="name" select="$name"/>
+ </xsl:call-template>
+ </xsl:variable>
+ <xsl:variable name="ref-id">
+ <xsl:call-template name="make-id">
+ <xsl:with-param name="name" select="$ref-name"/>
+ </xsl:call-template>
+ </xsl:variable>
+[link asio.reference.<xsl:value-of select="$ref-id"/><xsl:text> </xsl:text><xsl:value-of
+ select="$ref-name"/>]</xsl:when>
+ <xsl:otherwise>
+ <xsl:apply-templates/>
+ </xsl:otherwise>
+ </xsl:choose>
+</xsl:template>
+
+
+<xsl:template match="ref[@kindref='member']">
+ <xsl:variable name="refid">
+ <xsl:value-of select="@refid"/>
+ </xsl:variable>
+ <xsl:variable name="text">
+ <xsl:call-template name="strip-asio-ns">
+ <xsl:with-param name="name" select="."/>
+ </xsl:call-template>
+ </xsl:variable>
+ <xsl:choose>
+ <xsl:when test="$refid='index_1index'">
+ <xsl:text>[link asio.tutorial </xsl:text>
+ <xsl:value-of select="$text"/>
+ <xsl:text>]</xsl:text>
+ </xsl:when>
+ <xsl:when test="@external='reference.tags'">
+ <xsl:variable name="anchor">
+ <xsl:call-template name="refid-to-anchor">
+ <xsl:with-param name="text" select="$refid"/>
+ </xsl:call-template>
+ </xsl:variable>
+ <xsl:choose>
+ <xsl:when test="count(document('reference.tags')/tagfile/compound[@kind='class']/member[anchor=$anchor]) &gt; 0">
+ <xsl:for-each select="document('reference.tags')/tagfile/compound[@kind='class']/member[anchor=$anchor]">
+ <xsl:variable name="scope">
+ <xsl:call-template name="make-id">
+ <xsl:with-param name="name">
+ <xsl:call-template name="strip-asio-ns">
+ <xsl:with-param name="name" select="../name"/>
+ </xsl:call-template>
+ </xsl:with-param>
+ </xsl:call-template>
+ </xsl:variable>
+ <xsl:variable name="name">
+ <xsl:call-template name="make-id">
+ <xsl:with-param name="name" select="name"/>
+ </xsl:call-template>
+ </xsl:variable>
+ <xsl:text>[link asio.reference.</xsl:text>
+ <xsl:if test="string-length($scope) &gt; 0">
+ <xsl:value-of select="$scope"/><xsl:text>.</xsl:text>
+ </xsl:if>
+ <xsl:value-of select="$name"/>
+ <xsl:text> </xsl:text><xsl:value-of select="$text"/><xsl:text>]</xsl:text>
+ </xsl:for-each>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:apply-templates/>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:apply-templates/>
+ </xsl:otherwise>
+ </xsl:choose>
+</xsl:template>
+
+
+<xsl:template match="ulink">
+ <xsl:text>[@</xsl:text>
+ <xsl:value-of select="@url"/>
+ <xsl:text> </xsl:text>
+ <xsl:value-of select="."/>
+ <xsl:text>]</xsl:text>
+</xsl:template>
+
+
+</xsl:stylesheet>