The master copy of this stylesheet is in the Telepathy spec repository -

please make any changes there.

Copyright (C) 2006-2008 Collabora Limited

This library is free software; you can redistribute it and/or

modify it under the terms of the GNU Lesser General Public

License as published by the Free Software Foundation; either

version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,

but WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public

License along with this library; if not, write to the Free Software

Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

-->

  xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0"

  xmlns:html="http://www.w3.org/1999/xhtml"

  exclude-result-prefixes="tp html">

  don't work ideally in the presence of two things that want to use the

  absence of a prefix, sadly. -->

  <xsl:param name="allow-undefined-interfaces" select="false()"/>

  <xsl:template match="html:* | @*" mode="html">

    <xsl:copy>

      <xsl:apply-templates mode="html"/>

    </xsl:copy>

  </xsl:template>

  <xsl:template match="tp:type" mode="html">

    <xsl:call-template name="tp-type">

      <xsl:with-param name="tp-type" select="string(.)"/>

    </xsl:call-template>

  </xsl:template>

  <xsl:template match="tp:dbus-ref" mode="html">

    <xsl:variable name="name">

      <xsl:choose>

        <xsl:when test="@namespace">

          <xsl:value-of select="@namespace"/>

          <xsl:text>.</xsl:text>

        </xsl:when>

      </xsl:choose>

      <xsl:value-of select="string(.)"/>

    </xsl:variable>

    <xsl:choose>

        or //interface/method[concat(../@name, '.', @name)=$name]

        or //interface/signal[concat(../@name, '.', @name)=$name]

        or //interface/property[concat(../@name, '.', @name)=$name]

        or //interface[@name=concat($name, '.DRAFT')]

        or //interface/method[

          concat(../@name, '.', @name)=concat($name, '.DRAFT')]

        or //interface/signal[

          concat(../@name, '.', @name)=concat($name, '.DRAFT')]

        or //interface/property[

          concat(../@name, '.', @name)=concat($name, '.DRAFT')]

        ">

          <xsl:value-of select="string(.)"/>

      </xsl:when>

      <xsl:when test="$allow-undefined-interfaces">

          <xsl:value-of select="string(.)"/>

      </xsl:when>

      <xsl:otherwise>

        <xsl:message terminate="yes">

          <xsl:text>ERR: cannot find D-Bus interface, method, </xsl:text>

          <xsl:text>signal or property called '</xsl:text>

          <xsl:value-of select="$name"/>

          <xsl:text>'
</xsl:text>

        </xsl:message>

      </xsl:otherwise>

    </xsl:choose>

  </xsl:template>

  <xsl:template match="tp:member-ref" mode="html">

      '.')"/>

    <xsl:variable name="name" select="string(.)"/>

    <xsl:if test="not(ancestor::interface)">

      <xsl:message terminate="yes">

        <xsl:text>ERR: Cannot use tp:member-ref when not in an</xsl:text>

        <xsl:text> <interface>
</xsl:text>

      </xsl:message>

    </xsl:if>

    <xsl:choose>

      <xsl:when test="ancestor::interface/signal[@name=$name]"/>

      <xsl:when test="ancestor::interface/method[@name=$name]"/>

      <xsl:when test="ancestor::interface/property[@name=$name]"/>

      <xsl:otherwise>

        <xsl:message terminate="yes">

          <xsl:text>ERR: interface </xsl:text>

          <xsl:value-of select="ancestor::interface/@name"/>

          <xsl:text> has no signal/method/property called </xsl:text>

          <xsl:value-of select="$name"/>

          <xsl:text>
</xsl:text>

        </xsl:message>

      </xsl:otherwise>

    </xsl:choose>

      <xsl:value-of select="$name"/>

  </xsl:template>

  <xsl:template match="*" mode="identity">

    <xsl:copy>

      <xsl:apply-templates mode="identity"/>

    </xsl:copy>

  </xsl:template>

  <xsl:template match="tp:docstring">

    <xsl:apply-templates mode="html"/>

  </xsl:template>

  <xsl:template match="tp:added">

    
Added in

      version <xsl:value-of select="@version"/>.

      <xsl:apply-templates select="node()" mode="html"/>

  </xsl:template>

  <xsl:template match="tp:changed">

    <xsl:choose>

      <xsl:when test="node()">

        
Changed in

          version <xsl:value-of select="@version"/>:

          <xsl:apply-templates select="node()" mode="html"/>

      </xsl:when>

      <xsl:otherwise>

        
Changed in version

          <xsl:value-of select="@version"/>

      </xsl:otherwise>

    </xsl:choose>

  </xsl:template>

  <xsl:template match="tp:deprecated">

    
Deprecated

      since version <xsl:value-of select="@version"/>.

      <xsl:apply-templates select="node()" mode="html"/>

  </xsl:template>

  <xsl:template match="tp:rationale" mode="html">

      <xsl:apply-templates select="node()" mode="html"/>

  </xsl:template>

  <xsl:template match="tp:errors">

    
Errors

    <xsl:apply-templates/>

  </xsl:template>

  <xsl:template match="tp:generic-types">

    
Generic types

    <xsl:call-template name="do-types"/>

  </xsl:template>

  <xsl:template name="do-types">

    <xsl:if test="tp:simple-type">

      
Simple types

      <xsl:apply-templates select="tp:simple-type"/>

    </xsl:if>

    <xsl:if test="tp:enum">

      
Enumerated types:

      <xsl:apply-templates select="tp:enum"/>

    </xsl:if>

    <xsl:if test="tp:flags">

      
Sets of flags:

      <xsl:apply-templates select="tp:flags"/>

    </xsl:if>

    <xsl:if test="tp:struct">

      
Structure types

      <xsl:apply-templates select="tp:struct"/>

    </xsl:if>

    <xsl:if test="tp:mapping">

      
Mapping types

      <xsl:apply-templates select="tp:mapping"/>

    </xsl:if>

    <xsl:if test="tp:external-type">

      
Types defined elsewhere

      
<xsl:apply-templates select="tp:external-type"/>

    </xsl:if>

  </xsl:template>

  <xsl:template match="tp:error">

    
<xsl:value-of select="concat(../@namespace, '.', translate(@name, ' ', ''))"/>

    <xsl:apply-templates select="tp:docstring"/>

    <xsl:apply-templates select="tp:added"/>

    <xsl:apply-templates select="tp:changed"/>

    <xsl:apply-templates select="tp:deprecated"/>

  </xsl:template>

  <xsl:template match="/tp:spec/tp:copyright">

      <xsl:apply-templates mode="text"/>

  </xsl:template>

  <xsl:template match="/tp:spec/tp:license">

      <xsl:apply-templates mode="html"/>

  </xsl:template>

  <xsl:template match="tp:copyright"/>

  <xsl:template match="tp:license"/>

  <xsl:template match="interface">

    
<xsl:value-of select="@name"/>

    <xsl:if test="@tp:causes-havoc">

        This interface is <xsl:value-of select="@tp:causes-havoc"/>

        and is likely to cause havoc to your API/ABI if bindings are generated.

        Don't include it in libraries that care about compatibility.

    </xsl:if>

    <xsl:if test="tp:requires">

      
Implementations of this interface must also implement:

        <xsl:for-each select="tp:requires">

          
<xsl:value-of select="@interface"/>

        </xsl:for-each>

    </xsl:if>

    <xsl:apply-templates select="tp:docstring" />

    <xsl:apply-templates select="tp:added"/>

    <xsl:apply-templates select="tp:changed"/>

    <xsl:apply-templates select="tp:deprecated"/>

    <xsl:choose>

      <xsl:when test="method">

        
Methods:

        <xsl:apply-templates select="method"/>

      </xsl:when>

      <xsl:otherwise>

        
Interface has no methods.

      </xsl:otherwise>

    </xsl:choose>

    <xsl:choose>

      <xsl:when test="signal">

        
Signals:

        <xsl:apply-templates select="signal"/>

      </xsl:when>

      <xsl:otherwise>

        
Interface has no signals.

      </xsl:otherwise>

    </xsl:choose>

    <xsl:choose>

      <xsl:when test="tp:property">

        
Telepathy Properties:

        
Accessed using the

          Telepathy

            Properties interface.

          <xsl:apply-templates select="tp:property"/>

      </xsl:when>

      <xsl:otherwise>

        
Interface has no Telepathy

          properties.

      </xsl:otherwise>

    </xsl:choose>

    <xsl:choose>

      <xsl:when test="property">

        
D-Bus core Properties:

        
Accessed using the

          org.freedesktop.DBus.Properties interface.

          <xsl:apply-templates select="property"/>

      </xsl:when>

      <xsl:otherwise>

        
Interface has no D-Bus core

          properties.

      </xsl:otherwise>

    </xsl:choose>

    <xsl:call-template name="do-types"/>

  </xsl:template>

  <xsl:template match="tp:flags">

    <xsl:if test="not(@name) or @name = ''">

      <xsl:message terminate="yes">

        <xsl:text>ERR: missing @name on a tp:flags type
</xsl:text>

      </xsl:message>

    </xsl:if>

    <xsl:if test="not(@type) or @type = ''">

      <xsl:message terminate="yes">

        <xsl:text>ERR: missing @type on tp:flags type</xsl:text>

        <xsl:value-of select="@name"/>

        <xsl:text>
</xsl:text>

      </xsl:message>

    </xsl:if>

        <xsl:value-of select="@name"/>

    <xsl:apply-templates select="tp:docstring" />

    <xsl:apply-templates select="tp:added"/>

    <xsl:apply-templates select="tp:changed"/>

    <xsl:apply-templates select="tp:deprecated"/>

        <xsl:variable name="value-prefix">

          <xsl:choose>

            <xsl:when test="@value-prefix">

              <xsl:value-of select="@value-prefix"/>

            </xsl:when>

            <xsl:otherwise>

              <xsl:value-of select="@name"/>

            </xsl:otherwise>

          </xsl:choose>

        </xsl:variable>

      <xsl:for-each select="tp:flag">

        
<xsl:value-of select="concat($value-prefix, '_', @suffix)"/> = <xsl:value-of select="@value"/>

        <xsl:choose>

          <xsl:when test="tp:docstring">

              <xsl:apply-templates select="tp:docstring" />

              <xsl:apply-templates select="tp:added"/>

              <xsl:apply-templates select="tp:changed"/>

              <xsl:apply-templates select="tp:deprecated"/>

          </xsl:when>

          <xsl:otherwise>

            
(Undocumented)

          </xsl:otherwise>

        </xsl:choose>

      </xsl:for-each>

  </xsl:template>

  <xsl:template match="tp:enum">

    <xsl:if test="not(@name) or @name = ''">

      <xsl:message terminate="yes">

        <xsl:text>ERR: missing @name on a tp:enum type
</xsl:text>

      </xsl:message>

    </xsl:if>

    <xsl:if test="not(@type) or @type = ''">

      <xsl:message terminate="yes">

        <xsl:text>ERR: missing @type on tp:enum type</xsl:text>

        <xsl:value-of select="@name"/>

        <xsl:text>
</xsl:text>

      </xsl:message>

    </xsl:if>

        <xsl:value-of select="@name"/>

    <xsl:apply-templates select="tp:docstring" />

    <xsl:apply-templates select="tp:added"/>

    <xsl:apply-templates select="tp:changed"/>

    <xsl:apply-templates select="tp:deprecated"/>

        <xsl:variable name="value-prefix">

          <xsl:choose>

            <xsl:when test="@value-prefix">

              <xsl:value-of select="@value-prefix"/>

            </xsl:when>

            <xsl:otherwise>

              <xsl:value-of select="@name"/>

            </xsl:otherwise>

          </xsl:choose>

        </xsl:variable>

      <xsl:for-each select="tp:enumvalue">

        
<xsl:value-of select="concat($value-prefix, '_', @suffix)"/> = <xsl:value-of select="@value"/>

        <xsl:choose>

          <xsl:when test="tp:docstring">

              <xsl:apply-templates select="tp:docstring" />

              <xsl:apply-templates select="tp:added"/>

              <xsl:apply-templates select="tp:changed"/>

              <xsl:apply-templates select="tp:deprecated"/>

          </xsl:when>

          <xsl:otherwise>

            
(Undocumented)

          </xsl:otherwise>

        </xsl:choose>

      </xsl:for-each>

  </xsl:template>

  <xsl:template match="property">

    <xsl:if test="not(parent::interface)">

      <xsl:message terminate="yes">

        <xsl:text>ERR: property </xsl:text>

        <xsl:value-of select="@name"/>

        <xsl:text> does not have an interface as parent
</xsl:text>

      </xsl:message>

    </xsl:if>

    <xsl:if test="not(@name) or @name = ''">

      <xsl:message terminate="yes">

        <xsl:text>ERR: missing @name on a property of </xsl:text>

        <xsl:value-of select="../@name"/>

        <xsl:text>
</xsl:text>

      </xsl:message>

    </xsl:if>

    <xsl:if test="not(@type) or @type = ''">

      <xsl:message terminate="yes">

        <xsl:text>ERR: missing @type on property </xsl:text>

        <xsl:value-of select="concat(../@name, '.', @name)"/>

        <xsl:text>: '</xsl:text>

        <xsl:value-of select="@access"/>

        <xsl:text>'
</xsl:text>

      </xsl:message>

    </xsl:if>

        <xsl:value-of select="@name"/>

      <xsl:text> − </xsl:text>

      <xsl:value-of select="@type"/>

      <xsl:call-template name="parenthesized-tp-type"/>

      <xsl:text>, </xsl:text>

      <xsl:choose>

        <xsl:when test="@access = 'read'">

          <xsl:text>read-only</xsl:text>

        </xsl:when>

        <xsl:when test="@access = 'write'">

          <xsl:text>write-only</xsl:text>

        </xsl:when>

        <xsl:when test="@access = 'readwrite'">

          <xsl:text>read/write</xsl:text>

        </xsl:when>

        <xsl:otherwise>

          <xsl:message terminate="yes">

            <xsl:text>ERR: unknown or missing value for </xsl:text>

            <xsl:text>@access on property </xsl:text>

            <xsl:value-of select="concat(../@name, '.', @name)"/>

            <xsl:text>: '</xsl:text>

            <xsl:value-of select="@access"/>

            <xsl:text>'
</xsl:text>

          </xsl:message>

        </xsl:otherwise>

      </xsl:choose>

      <xsl:apply-templates select="tp:docstring"/>

      <xsl:apply-templates select="tp:added"/>

      <xsl:apply-templates select="tp:changed"/>

      <xsl:apply-templates select="tp:deprecated"/>

  </xsl:template>

  <xsl:template match="tp:property">

      <xsl:if test="@name">

        <xsl:value-of select="@name"/> −

      </xsl:if>

      <xsl:value-of select="@type"/>

      <xsl:apply-templates select="tp:docstring"/>

      <xsl:apply-templates select="tp:added"/>

      <xsl:apply-templates select="tp:changed"/>

      <xsl:apply-templates select="tp:deprecated"/>

  </xsl:template>

  <xsl:template match="tp:mapping">

          <xsl:value-of select="@name"/>

         − a{

        <xsl:for-each select="tp:member">

          <xsl:value-of select="@type"/>

          <xsl:text>: </xsl:text>

          <xsl:value-of select="@name"/>

          <xsl:if test="position() != last()"> → </xsl:if>

        </xsl:for-each>

        }

        <xsl:apply-templates select="tp:docstring"/>

        <xsl:if test="string(@array-name) != ''">

          
In bindings that need a separate name, arrays of

            <xsl:value-of select="@name"/> should be called

            <xsl:value-of select="@array-name"/>.

        </xsl:if>

        
Members

          <xsl:apply-templates select="tp:member" mode="members-in-docstring"/>

  </xsl:template>

  <xsl:template match="tp:docstring" mode="in-index"/>

    mode="in-index">

    − <xsl:value-of select="@type"/>

  </xsl:template>

  <xsl:template match="tp:simple-type">

    <xsl:if test="not(@name) or @name = ''">

      <xsl:message terminate="yes">

        <xsl:text>ERR: missing @name on a tp:simple-type
</xsl:text>

      </xsl:message>

    </xsl:if>

    <xsl:if test="not(@type) or @type = ''">

      <xsl:message terminate="yes">

        <xsl:text>ERR: missing @type on tp:simple-type</xsl:text>

        <xsl:value-of select="@name"/>

        <xsl:text>
</xsl:text>

      </xsl:message>

    </xsl:if>

          <xsl:value-of select="@name"/>

         − <xsl:value-of select="@type"/>

        <xsl:apply-templates select="tp:docstring"/>

        <xsl:apply-templates select="tp:added"/>

        <xsl:apply-templates select="tp:changed"/>

        <xsl:apply-templates select="tp:deprecated"/>

  </xsl:template>

  <xsl:template match="tp:external-type">

    <xsl:if test="not(@name) or @name = ''">

      <xsl:message terminate="yes">

        <xsl:text>ERR: missing @name on a tp:external-type
</xsl:text>

      </xsl:message>

    </xsl:if>

    <xsl:if test="not(@type) or @type = ''">

      <xsl:message terminate="yes">

        <xsl:text>ERR: missing @type on tp:external-type</xsl:text>

        <xsl:value-of select="@name"/>

        <xsl:text>
</xsl:text>

      </xsl:message>

    </xsl:if>

          <xsl:value-of select="@name"/>

         − <xsl:value-of select="@type"/>

      
Defined by: <xsl:value-of select="@from"/>

  </xsl:template>

  <xsl:template match="tp:struct" mode="in-index">

    − ( <xsl:for-each select="tp:member">

          <xsl:value-of select="@type"/>

          <xsl:if test="position() != last()">, </xsl:if>

        </xsl:for-each> )

  </xsl:template>

  <xsl:template match="tp:mapping" mode="in-index">

    − a{ <xsl:for-each select="tp:member">

          <xsl:value-of select="@type"/>

          <xsl:if test="position() != last()"> → </xsl:if>

        </xsl:for-each> }

  </xsl:template>

  <xsl:template match="tp:struct">

          <xsl:value-of select="@name"/>

         − (

        <xsl:for-each select="tp:member">

          <xsl:value-of select="@type"/>

          <xsl:text>: </xsl:text>

          <xsl:value-of select="@name"/>

          <xsl:if test="position() != last()">, </xsl:if>

        </xsl:for-each>

        )

        <xsl:apply-templates select="tp:docstring"/>

        <xsl:apply-templates select="tp:added"/>

        <xsl:apply-templates select="tp:changed"/>

        <xsl:apply-templates select="tp:deprecated"/>

      <xsl:choose>

        <xsl:when test="string(@array-name) != ''">

          
In bindings that need a separate name, arrays of

            <xsl:value-of select="@name"/> should be called

            <xsl:value-of select="@array-name"/>.

        </xsl:when>

        <xsl:otherwise>

          
Arrays of <xsl:value-of select="@name"/> don't generally

            make sense.

        </xsl:otherwise>

      </xsl:choose>

        
Members

          <xsl:apply-templates select="tp:member" mode="members-in-docstring"/>

  </xsl:template>

  <xsl:template match="method">

    <xsl:if test="not(parent::interface)">

      <xsl:message terminate="yes">

        <xsl:text>ERR: method </xsl:text>

        <xsl:value-of select="@name"/>

        <xsl:text> does not have an interface as parent
</xsl:text>

      </xsl:message>

    </xsl:if>

    <xsl:if test="not(@name) or @name = ''">

      <xsl:message terminate="yes">

        <xsl:text>ERR: missing @name on a method of </xsl:text>

        <xsl:value-of select="../@name"/>

        <xsl:text>
</xsl:text>

      </xsl:message>

    </xsl:if>

    <xsl:for-each select="arg">

      <xsl:if test="not(@type) or @type = ''">

        <xsl:message terminate="yes">

          <xsl:text>ERR: an arg of method </xsl:text>

          <xsl:value-of select="concat(../../@name, '.', ../@name)"/>

          <xsl:text> has no type</xsl:text>

        </xsl:message>

      </xsl:if>

      <xsl:choose>

        <xsl:when test="@direction='in'">

          <xsl:if test="not(@name) or @name = ''">

            <xsl:message terminate="yes">

              <xsl:text>ERR: an 'in' arg of method </xsl:text>

              <xsl:value-of select="concat(../../@name, '.', ../@name)"/>

              <xsl:text> has no name</xsl:text>

            </xsl:message>

          </xsl:if>

        </xsl:when>

        <xsl:when test="@direction='out'">

          on their hands goes through the spec adding names to all the "out"

          arguments

          <xsl:if test="not(@name) or @name = ''">

            <xsl:message terminate="no">

              <xsl:text>INFO: an 'out' arg of method </xsl:text>

              <xsl:value-of select="concat(../../@name, '.', ../@name)"/>

              <xsl:text> has no name</xsl:text>

            </xsl:message>

          </xsl:if>-->

        </xsl:when>

        <xsl:otherwise>

          <xsl:message terminate="yes">

            <xsl:text>ERR: an arg of method </xsl:text>

            <xsl:value-of select="concat(../../@name, '.', ../@name)"/>

            <xsl:text> has direction neither 'in' nor 'out'</xsl:text>

          </xsl:message>

        </xsl:otherwise>

      </xsl:choose>

    </xsl:for-each>

          <xsl:value-of select="@name"/>

         (

        <xsl:for-each xmlns="" select="arg[@direction='in']">

          <xsl:value-of select="@type"/>: <xsl:value-of select="@name"/>

          <xsl:if test="position() != last()">, </xsl:if>

        </xsl:for-each>

        ) →

        <xsl:choose>

          <xsl:when test="arg[@direction='out']">

            <xsl:for-each xmlns="" select="arg[@direction='out']">

              <xsl:value-of select="@type"/>

              <xsl:if test="position() != last()">, </xsl:if>

            </xsl:for-each>

          </xsl:when>

          <xsl:otherwise>nothing</xsl:otherwise>

        </xsl:choose>

        <xsl:apply-templates select="tp:docstring" />

        <xsl:apply-templates select="tp:added"/>

        <xsl:apply-templates select="tp:changed"/>

        <xsl:apply-templates select="tp:deprecated"/>

      <xsl:if test="arg[@direction='in']">

          
Parameters

              mode="parameters-in-docstring"/>

      </xsl:if>

      <xsl:if test="arg[@direction='out']">

          
Returns

              mode="returns-in-docstring"/>

      </xsl:if>

      <xsl:if test="tp:possible-errors">

          
Possible errors

            <xsl:apply-templates select="tp:possible-errors/tp:error"/>

      </xsl:if>

  </xsl:template>

  <xsl:template name="tp-type">

    <xsl:param name="tp-type"/>

    <xsl:param name="type"/>

    <xsl:variable name="single-type">

      <xsl:choose>

        <xsl:when test="contains($tp-type, '[]')">

          <xsl:value-of select="substring-before($tp-type, '[]')"/>

        </xsl:when>

        <xsl:otherwise>

          <xsl:value-of select="$tp-type"/>

        </xsl:otherwise>

      </xsl:choose>

    </xsl:variable>

    <xsl:variable name="type-of-tp-type">

      <xsl:if test="contains($tp-type, '[]')">

          translate(substring-after($tp-type, '[]'), '[]', 'a'))"/>

      </xsl:if>

      <xsl:choose>

        <xsl:when test="//tp:simple-type[@name=$single-type]">

          <xsl:value-of select="string(//tp:simple-type[@name=$single-type]/@type)"/>

        </xsl:when>

        <xsl:when test="//tp:struct[@name=$single-type]">

          <xsl:text>(</xsl:text>

          <xsl:for-each select="//tp:struct[@name=$single-type]/tp:member">

            <xsl:value-of select="@type"/>

          </xsl:for-each>

          <xsl:text>)</xsl:text>

        </xsl:when>

        <xsl:when test="//tp:enum[@name=$single-type]">

          <xsl:value-of select="string(//tp:enum[@name=$single-type]/@type)"/>

        </xsl:when>

        <xsl:when test="//tp:flags[@name=$single-type]">

          <xsl:value-of select="string(//tp:flags[@name=$single-type]/@type)"/>

        </xsl:when>

        <xsl:when test="//tp:mapping[@name=$single-type]">

          <xsl:text>a{</xsl:text>

          <xsl:for-each select="//tp:mapping[@name=$single-type]/tp:member">

            <xsl:value-of select="@type"/>

          </xsl:for-each>

          <xsl:text>}</xsl:text>

        </xsl:when>

        <xsl:when test="//tp:external-type[@name=$single-type]">

          <xsl:value-of select="string(//tp:external-type[@name=$single-type]/@type)"/>

        </xsl:when>

        <xsl:otherwise>

          <xsl:message terminate="yes">

            <xsl:text>ERR: Unable to find type '</xsl:text>

            <xsl:value-of select="$tp-type"/>

            <xsl:text>'
</xsl:text>

          </xsl:message>

        </xsl:otherwise>

      </xsl:choose>

    </xsl:variable>

      string($type-of-tp-type) != string($type)">

      <xsl:message terminate="yes">

        <xsl:text>ERR: tp:type '</xsl:text>

        <xsl:value-of select="$tp-type"/>

        <xsl:text>' has D-Bus type '</xsl:text>

        <xsl:value-of select="$type-of-tp-type"/>

        <xsl:text>' but has been used with type='</xsl:text>

        <xsl:value-of select="$type"/>

        <xsl:text>'
</xsl:text>

      </xsl:message>

    </xsl:if>

    <xsl:value-of select="$tp-type"/>

  </xsl:template>

  <xsl:template name="parenthesized-tp-type">

    <xsl:if test="@tp:type">

      <xsl:text> (</xsl:text>

      <xsl:call-template name="tp-type">

        <xsl:with-param name="tp-type" select="@tp:type"/>

        <xsl:with-param name="type" select="@type"/>

      </xsl:call-template>

      <xsl:text>)</xsl:text>

    </xsl:if>

  </xsl:template>

  <xsl:template match="tp:member" mode="members-in-docstring">

      <xsl:value-of select="@name"/> −

      <xsl:value-of select="@type"/>

      <xsl:call-template name="parenthesized-tp-type"/>

      <xsl:choose>

        <xsl:when test="tp:docstring">

          <xsl:apply-templates select="tp:docstring" />

        </xsl:when>

        <xsl:otherwise>