summaryrefslogtreecommitdiffstats
path: root/secret-service/tools/spec-to-docbook.xsl
diff options
context:
space:
mode:
authorMichael Leupold <lemma@leunet.de>2009-08-01 17:06:47 +0200
committerStef Walter <stefw@collabora.co.uk>2010-12-04 16:11:41 +0000
commit71b33da854c43d89147075fb5d06673b52d0bd1c (patch)
treed56503df065e711edfe351c3229cf9892a2c74ac /secret-service/tools/spec-to-docbook.xsl
parent01d37dc2d31277bc6d55fa2a7c689a681443e1e7 (diff)
downloadxdg-specs-71b33da854c43d89147075fb5d06673b52d0bd1c.tar.xz
Adapt style, hide "Name" of reference pages.
Diffstat (limited to 'secret-service/tools/spec-to-docbook.xsl')
-rw-r--r--secret-service/tools/spec-to-docbook.xsl174
1 files changed, 114 insertions, 60 deletions
diff --git a/secret-service/tools/spec-to-docbook.xsl b/secret-service/tools/spec-to-docbook.xsl
index 8b6c223..d320d61 100644
--- a/secret-service/tools/spec-to-docbook.xsl
+++ b/secret-service/tools/spec-to-docbook.xsl
@@ -288,7 +288,7 @@
</refmeta>
<refnamediv>
- <refdescriptor>D-Bus Interface</refdescriptor>
+ <refdescriptor><xsl:value-of select="@name"/></refdescriptor>
<refname><xsl:value-of select="@name"/></refname>
<refpurpose><xsl:apply-templates select="tp:docstring" mode="nopara"/></refpurpose>
</refnamediv>
@@ -357,6 +357,15 @@
</funcsynopsis>
</refsect2>
</xsl:if>
+ <xsl:if test="property">
+ <refsect2>
+ <title>Properties</title>
+ <refsynopsisdiv>
+ <title> </title>
+ <xsl:apply-templates select="property" mode="fieldsynopsislinked"/>
+ </refsynopsisdiv>
+ </refsect2>
+ </xsl:if>
</refsynopsisdiv>
<xsl:if test="method">
@@ -394,9 +403,7 @@
<para>
Accessed using the org.freedesktop.DBus.Properties interface.
</para>
- <glosslist>
- <xsl:apply-templates select="property" mode="detail"/>
- </glosslist>
+ <xsl:apply-templates select="property" mode="detail"/>
</refsection>
</xsl:if>
@@ -526,6 +533,88 @@
</section>
</xsl:template>
+ <xsl:template match="property" mode="fieldsynopsis">
+
+ <fieldsynopsis>
+ <xsl:attribute name="xml:id">
+ <xsl:value-of select="concat(../@name, '.', @name)"/>
+ </xsl:attribute>
+ <modifier>
+ <xsl:choose>
+ <xsl:when test="@access = 'read'">
+ <xsl:text>READ</xsl:text>
+ </xsl:when>
+ <xsl:when test="@access = 'write'">
+ <xsl:text>WRITE</xsl:text>
+ </xsl:when>
+ <xsl:when test="@access = 'readwrite'">
+ <xsl:text>READWRITE</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>'&#10;</xsl:text>
+ </xsl:message>
+ </xsl:otherwise>
+ </xsl:choose>
+ </modifier>
+ <type>
+ <xsl:call-template name="ResolveType">
+ <xsl:with-param name="node" select="."/>
+ </xsl:call-template>
+ </type>
+ <varname>
+ <xsl:value-of select="@name"/>
+ </varname>
+ </fieldsynopsis>
+
+ </xsl:template>
+
+ <xsl:template match="property" mode="fieldsynopsislinked">
+
+ <fieldsynopsis>
+ <modifier>
+ <xsl:choose>
+ <xsl:when test="@access = 'read'">
+ <xsl:text>READ</xsl:text>
+ </xsl:when>
+ <xsl:when test="@access = 'write'">
+ <xsl:text>WRITE</xsl:text>
+ </xsl:when>
+ <xsl:when test="@access = 'readwrite'">
+ <xsl:text>READWRITE</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>'&#10;</xsl:text>
+ </xsl:message>
+ </xsl:otherwise>
+ </xsl:choose>
+ </modifier>
+ <type>
+ <xsl:call-template name="ResolveType">
+ <xsl:with-param name="node" select="."/>
+ </xsl:call-template>
+ </type>
+ <varname>
+ <xsl:attribute name="xlink:href">
+ <xsl:value-of select="concat('#', ../@name, '.', @name)"/>
+ </xsl:attribute>
+ <xsl:value-of select="@name"/>
+ </varname>
+ </fieldsynopsis>
+
+ </xsl:template>
+
<xsl:template match="property" mode="detail">
<xsl:if test="not(parent::interface)">
@@ -554,47 +643,12 @@
</xsl:message>
</xsl:if>
- <glossentry>
- <glossterm>
- <xsl:attribute name="xml:id">
- <xsl:value-of select="concat(../@name, '.', @name)"/>
- </xsl:attribute>
- <property><xsl:value-of select="@name"/></property> -
- <type>
- <xsl:call-template name="ResolveType">
- <xsl:with-param name="node" select="."/>
- </xsl:call-template>
- </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>'&#10;</xsl:text>
- </xsl:message>
- </xsl:otherwise>
- </xsl:choose>
- </glossterm>
- <glossdef>
- <xsl:apply-templates select="tp:docstring"/>
- <xsl:apply-templates select="tp:added"/>
- <xsl:apply-templates select="tp:changed"/>
- <xsl:apply-templates select="tp:deprecated"/>
- </glossdef>
- </glossentry>
+ <xsl:apply-templates select="." mode="fieldsynopsis"/>
+
+ <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" mode="detail">
@@ -803,21 +857,21 @@
</xsl:template>
<xsl:template match="method|signal" mode="funcsynopsislinked">
- <funcprototype>
- <funcdef>
- <function linkend="{concat(parent::interface//@name, '.', @name)}">
- <xsl:value-of select="@name"/>
- </function>
- </funcdef>
- <xsl:choose>
- <xsl:when test="arg">
- <xsl:apply-templates select="arg" mode="paramdef"/>
- </xsl:when>
- <xsl:otherwise>
- <void/>
- </xsl:otherwise>
- </xsl:choose>
- </funcprototype>
+ <funcprototype>
+ <funcdef>
+ <function linkend="{concat(parent::interface//@name, '.', @name)}">
+ <xsl:value-of select="@name"/>
+ </function>
+ </funcdef>
+ <xsl:choose>
+ <xsl:when test="arg">
+ <xsl:apply-templates select="arg" mode="paramdef"/>
+ </xsl:when>
+ <xsl:otherwise>
+ <void/>
+ </xsl:otherwise>
+ </xsl:choose>
+ </funcprototype>
</xsl:template>
<xsl:template match="method" mode="detail">