GtkSharp/audit/mono-api.xsl
Bertrand Lorentz 2a7d26a8b0 audit: Add gen-apidiff-html tool to generate apidiff reports
The gen-apidiff-html tool takes all apidiff files in a directory, merges
them and then applies mono-api.xsl to produce a nice HTML page that
shows the information about the API changes.

The various resources needed by the HTML page (images, CSS, javascript)
are added in the html/ directory.

This is all adapted from an older version of the tools in Mono git
master, under mcs/tools/corcompare.
2013-03-29 17:50:07 +01:00

541 lines
15 KiB
XML

<?xml version="1.0" ?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
<xsl:output method="html" indent="yes"/>
<!-- <xsl:output method="xml"/>-->
<xsl:strip-space elements="*"/>
<xsl:template match="/">
<HTML>
<HEAD>
<TITLE>
Gtk# API Status
</TITLE>
<SCRIPT src="cormissing.js"></SCRIPT>
<LINK rel="stylesheet" type="text/css" href="cormissing.css"></LINK>
</HEAD>
<BODY onLoad="onLoad();">
<P>
<H1>Gtk# API Status</H1>
</P>
<table>
<tr>
<td> <input type="checkbox" ID="todo" onClick="selectTodo()" checked="checked"/> </td>
<td> <img src="st.gif"/> </td>
<td> TODO </td>
<td width="20"/>
<td> <input type="checkbox" ID="missing" onClick="selectMissing()" checked="checked"/> </td>
<td> <img src="sm.gif"/> </td>
<td> Removed </td>
</tr>
<tr>
<td> <input type="checkbox" ID="extra" onClick="selectExtra()" checked="checked"/> </td>
<td> <img src="sx.gif"/> </td>
<td> Added </td>
<td width="20"/>
<td> <input type="checkbox" ID="errors" onClick="selectErrors()" checked="checked"/> </td>
<td> <img src="se.gif"/> </td>
<td> Changed </td>
</tr>
<tr>
<td> <input type="checkbox" ID="stable" onClick="selectStable()"/> </td>
<td> <img src="sc.gif"/> </td>
<td> Stable </td>
</tr>
</table>
<p></p>
<div ID="ROOT">
<xsl:apply-templates/>
</div>
<p>
Legend :<br/>
<table>
<tr>
<td> <img src="y.gif"/> </td>
<td> Assembly </td>
<td width="20"/>
<td> <img src="n.gif"/> </td>
<td> Namespace </td>
<td width="20"/>
<td> <img src="c.gif"/> </td>
<td> Class </td>
<td width="20"/>
<td> <img src="s.gif"/> </td>
<td> Struct </td>
<tr>
</tr>
<td> <img src="i.gif"/> </td>
<td> Interface </td>
<td width="20"/>
<td> <img src="d.gif"/> </td>
<td> Delegate </td>
<td width="20"/>
<td> <img src="en.gif"/> </td>
<td> Enum </td>
<td width="20"/>
<td> <img src="m.gif"/> </td>
<td> Method </td>
</tr>
<tr>
<td> <img src="f.gif"/> </td>
<td> Field </td>
<td width="20"/>
<td> <img src="p.gif"/> </td>
<td> Property </td>
<td width="20"/>
<td> <img src="e.gif"/> </td>
<td> Event </td>
<td width="20"/>
<td> <img src="r.gif"/> </td>
<td> Attribute </td>
</tr>
</table>
</p>
</BODY>
</HTML>
</xsl:template>
<!-- assembly -->
<xsl:template match="/assemblies">
<xsl:apply-templates select="assembly">
<xsl:sort select="@name"/>
</xsl:apply-templates>
</xsl:template>
<xsl:template match="assembly">
<div>
<xsl:call-template name="ELEMENT">
<xsl:with-param name="class">y</xsl:with-param>
</xsl:call-template>
<xsl:if test="not(@presence)">
<xsl:apply-templates/>
</xsl:if>
</div>
</xsl:template>
<!-- namespace -->
<xsl:template match="namespaces">
<xsl:apply-templates select="namespace">
<xsl:sort select="@name"/>
</xsl:apply-templates>
</xsl:template>
<xsl:template match="namespace">
<div>
<xsl:call-template name="ELEMENT">
<xsl:with-param name="class">n</xsl:with-param>
</xsl:call-template>
<xsl:if test="not(@presence)">
<xsl:apply-templates/>
</xsl:if>
</div>
</xsl:template>
<xsl:template match="namespace/classes">
<xsl:apply-templates />
</xsl:template>
<!-- class -->
<xsl:template match="class[@type='class']">
<div>
<xsl:call-template name="ELEMENT">
<xsl:with-param name="class">c</xsl:with-param>
</xsl:call-template>
<xsl:if test="(@missing_total or @todo_total or @extra_total or @warning_total or @error) and not(@presence)">
<xsl:apply-templates select="attributes"/>
<xsl:apply-templates select="interfaces"/>
<xsl:apply-templates select="constructors"/>
<xsl:apply-templates select="./*[local-name() != 'attributes' and local-name() != 'constructors' and local-name() != 'interfaces']"/>
</xsl:if>
</div>
</xsl:template>
<!-- struct -->
<xsl:template match="class[@type='struct'][@missing_total or @todo_total or @extra_total or @warning_total or @error or @presence]">
<div>
<xsl:call-template name="ELEMENT">
<xsl:with-param name="class">s</xsl:with-param>
</xsl:call-template>
<xsl:if test="not(@presence)">
<xsl:apply-templates/>
</xsl:if>
</div>
</xsl:template>
<!-- interface types -->
<xsl:template match="class[@type='interface']">
<xsl:apply-templates select="class[@type='interface']">
<xsl:sort select="@name"/>
</xsl:apply-templates>
</xsl:template>
<xsl:template match="class[@type='interface'][@missing_total or @todo_total or @extra_total or @warning_total or @error or @presence]">
<div>
<xsl:call-template name="ELEMENT">
<xsl:with-param name="class">i</xsl:with-param>
</xsl:call-template>
<xsl:if test="not(@presence)">
<xsl:apply-templates/>
</xsl:if>
</div>
</xsl:template>
<!-- interfaces implemented by Types -->
<xsl:template match="interface">
<xsl:apply-templates select="interface">
<xsl:sort select="@name"/>
</xsl:apply-templates>
</xsl:template>
<xsl:template match="interface[@missing_total or @todo_total or @extra_total or @warning_total or @error or @presence]">
<div>
<xsl:call-template name="ELEMENT">
<xsl:with-param name="class">i</xsl:with-param>
</xsl:call-template>
<xsl:if test="not(@presence)">
<xsl:apply-templates/>
</xsl:if>
</div>
</xsl:template>
<!-- generic constraints -->
<xsl:template match="generic-type-constraints">
<xsl:apply-templates select="generic-type-constraint">
<xsl:sort select="@name"/>
</xsl:apply-templates>
</xsl:template>
<xsl:template match="generic-type-constraint[@missing_total or @todo_total or @extra_total or @warning_total or @error or @presence]">
<div>
<xsl:call-template name="ELEMENT">
<xsl:with-param name="class">w</xsl:with-param>
</xsl:call-template>
<xsl:if test="not(@presence)">
<xsl:apply-templates/>
</xsl:if>
</div>
</xsl:template>
<!-- delegate -->
<xsl:template match="class[@type='delegate'][@missing_total or @todo_total or @extra_total or @warning_total or @error or @presence]">
<div>
<xsl:call-template name="ELEMENT">
<xsl:with-param name="class">d</xsl:with-param>
</xsl:call-template>
<xsl:if test="not(@presence)">
<xsl:apply-templates/>
</xsl:if>
</div>
</xsl:template>
<!-- enumeration -->
<xsl:template match="class[@type='enum'][@missing_total or @todo_total or @extra_total or @warning_total or @error or @presence]">
<div>
<xsl:call-template name="ELEMENT">
<xsl:with-param name="class">en</xsl:with-param>
</xsl:call-template>
<xsl:if test="not(@presence)">
<xsl:apply-templates/>
</xsl:if>
</div>
</xsl:template>
<!-- method -->
<xsl:template match="methods">
<xsl:apply-templates select="method">
<xsl:sort select="@name"/>
</xsl:apply-templates>
</xsl:template>
<xsl:template match="method[@missing_total or @todo_total or @extra_total or @warning_total or @error or @presence]">
<div>
<xsl:call-template name="ELEMENT">
<xsl:with-param name="class">m</xsl:with-param>
</xsl:call-template>
<xsl:if test="not(@presence)">
<xsl:apply-templates/>
</xsl:if>
</div>
</xsl:template>
<!-- property -->
<xsl:template match="properties">
<xsl:apply-templates select="property">
<xsl:sort select="@name"/>
</xsl:apply-templates>
</xsl:template>
<xsl:template match="property[@missing_total or @todo_total or @extra_total or @warning_total or @error or @presence]">
<div>
<xsl:call-template name="ELEMENT">
<xsl:with-param name="class">p</xsl:with-param>
</xsl:call-template>
<xsl:if test="not(@presence)">
<xsl:apply-templates/>
</xsl:if>
</div>
</xsl:template>
<!-- event -->
<xsl:template match="events">
<xsl:apply-templates select="event">
<xsl:sort select="@name"/>
</xsl:apply-templates>
</xsl:template>
<xsl:template match="event[@missing_total or @todo_total or @extra_total or @warning_total or @error or @presence]">
<div>
<xsl:call-template name="ELEMENT">
<xsl:with-param name="class">e</xsl:with-param>
</xsl:call-template>
<xsl:if test="not(@presence)">
<xsl:apply-templates/>
</xsl:if>
</div>
</xsl:template>
<!-- constructor -->
<xsl:template match="constructors">
<xsl:apply-templates select="constructor">
<xsl:sort select="@name"/>
</xsl:apply-templates>
</xsl:template>
<xsl:template match="constructor[@missing_total or @todo_total or @extra_total or @warning_total or @error or @presence]">
<div>
<xsl:call-template name="ELEMENT">
<xsl:with-param name="class">x</xsl:with-param>
<xsl:with-param name="image">m</xsl:with-param>
</xsl:call-template>
<xsl:if test="not(@presence)">
<xsl:apply-templates/>
</xsl:if>
</div>
</xsl:template>
<!-- field -->
<xsl:template match="fields">
<xsl:apply-templates select="field">
<xsl:sort select="@name"/>
</xsl:apply-templates>
</xsl:template>
<xsl:template match="field[@missing_total or @todo_total or @extra_total or @warning_total or @error or @presence]">
<div>
<xsl:call-template name="ELEMENT">
<xsl:with-param name="class">f</xsl:with-param>
</xsl:call-template>
<xsl:if test="not(@presence)">
<xsl:apply-templates/>
</xsl:if>
</div>
</xsl:template>
<!-- accessor -->
<xsl:template match="property/methods">
<xsl:apply-templates select="method">
<xsl:sort select="@name"/>
</xsl:apply-templates>
</xsl:template>
<xsl:template match="property[@missing_total or @todo_total or @extra_total or @warning_total or @error or @presence]/methods/method[@missing_total or @todo_total or @extra_total or @warning_total or @error or @presence]">
<div>
<xsl:call-template name="ELEMENT">
<xsl:with-param name="class">o</xsl:with-param>
<xsl:with-param name="image">m</xsl:with-param>
</xsl:call-template>
<xsl:if test="not(@presence)">
<xsl:apply-templates/>
</xsl:if>
</div>
</xsl:template>
<!-- attribute -->
<xsl:template match="attributes">
<xsl:apply-templates select="attribute">
<xsl:sort select="@name"/>
</xsl:apply-templates>
</xsl:template>
<xsl:template match="attribute[@missing_total or @todo_total or @extra_total or @warning_total or @error or @presence]">
<div>
<xsl:call-template name="ELEMENT">
<xsl:with-param name="class">r</xsl:with-param>
</xsl:call-template>
<xsl:if test="not(@presence)">
<xsl:apply-templates/>
</xsl:if>
</div>
</xsl:template>
<!-- nested classes -->
<xsl:template match="classes">
<xsl:apply-templates select="class[@type='interface']">
<xsl:sort select="@name"/>
</xsl:apply-templates>
<xsl:apply-templates select="class[@type='class']">
<xsl:sort select="@name"/>
</xsl:apply-templates>
<xsl:apply-templates select="class[@type='struct']">
<xsl:sort select="@name"/>
</xsl:apply-templates>
<xsl:apply-templates select="class[@type='delegate']">
<xsl:sort select="@name"/>
</xsl:apply-templates>
<xsl:apply-templates select="class[@type='enum']">
<xsl:sort select="@name"/>
</xsl:apply-templates>
</xsl:template>
<!-- support templates -->
<xsl:template name="ELEMENT">
<xsl:param name="class"/>
<xsl:param name="image"/>
<xsl:attribute name="class">
<xsl:value-of select="$class"/>
<xsl:if test="./node() and local-name() != 'assembly'">_</xsl:if>
</xsl:attribute>
<xsl:call-template name="toggle"/>
<xsl:choose>
<xsl:when test="@error and @error != 'todo'">
<xsl:element name="img">
<xsl:attribute name="src">se.gif</xsl:attribute>
<xsl:attribute name="class">t</xsl:attribute>
<xsl:attribute name="title"><xsl:call-template name="warning-hover" /></xsl:attribute>
</xsl:element>
</xsl:when>
<xsl:when test="@error = 'todo'">
<xsl:element name="img">
<xsl:attribute name="src">st.gif</xsl:attribute>
<xsl:attribute name="class">t</xsl:attribute>
<xsl:if test="@comment">
<xsl:attribute name="title"><xsl:value-of select="@comment"/></xsl:attribute>
</xsl:if>
<xsl:if test="not(@comment)">
<xsl:attribute name="title">No TODO description</xsl:attribute>
</xsl:if>
</xsl:element>
</xsl:when>
<xsl:when test="@presence = 'missing'">
<img src="sm.gif" class="t"/>
</xsl:when>
<xsl:when test="@presence = 'extra'">
<img src="sx.gif" class="t"/>
</xsl:when>
<xsl:otherwise>
<img src="sc.gif" class="t"/>
</xsl:otherwise>
</xsl:choose>
<xsl:choose>
<xsl:when test="$image">
<img src="{$image}.gif" class="t"/>
</xsl:when>
<xsl:otherwise>
<img src="{$class}.gif" class="t"/>
</xsl:otherwise>
</xsl:choose>
<xsl:call-template name="name"/>
<xsl:if test="not(@presence)">
<xsl:call-template name="status"/>
</xsl:if>
<xsl:call-template name="warning-text" />
<xsl:for-each select="parameters/parameter[warnings/warning]">
<div>
<xsl:call-template name="ELEMENT">
<xsl:with-param name="class">a</xsl:with-param>
<xsl:with-param name="image">tb</xsl:with-param>
</xsl:call-template>
</div>
</xsl:for-each>
</xsl:template>
<xsl:template name="status">
<xsl:if test="@complete_total and @complete_total != 0">
<span class="st">
<img src="sc.gif"/>
<xsl:text>: </xsl:text>
<xsl:value-of select="@complete_total"/>
<xsl:text>%</xsl:text>
</span>
</xsl:if>
<xsl:if test="@todo_total">
<span class="st">
<img src="st.gif"/>: <xsl:value-of select="@todo_total"/>
</span>
</xsl:if>
<xsl:if test="@missing_total">
<span class="st">
<img src="sm.gif"/>: <xsl:value-of select="@missing_total"/>
</span>
</xsl:if>
<xsl:if test="@extra_total">
<span class="st">
<img src="sx.gif"/>: <xsl:value-of select="@extra_total"/>
</span>
</xsl:if>
<xsl:if test="@warning_total">
<span class="st">
<img src="se.gif"/>: <xsl:value-of select="@warning_total"/>
</span>
</xsl:if>
</xsl:template>
<xsl:template name="toggle">
<xsl:choose>
<xsl:when test="not(@presence) and .//*[@missing_total or @todo_total or @extra_total or @warning_total or @error or @presence]">
<xsl:choose>
<xsl:when test="local-name() != 'assembly'">
<img src="tp.gif" class="t"/>
</xsl:when>
<xsl:otherwise>
<img src="tm.gif" class="t"/>
</xsl:otherwise>
</xsl:choose>
</xsl:when>
<xsl:otherwise>
<img src="tb.gif"/>
</xsl:otherwise>
</xsl:choose>
</xsl:template>
<xsl:template name="name">
<xsl:if test="@name">
<span class="l"><xsl:value-of select="@name"/></span>
</xsl:if>
</xsl:template>
<xsl:template name="warning-hover">
<xsl:for-each select="warnings/warning">
<xsl:text>WARNING: </xsl:text>
<xsl:value-of select="@text"/>
</xsl:for-each>
</xsl:template>
<xsl:template name="warning-text">
<xsl:for-each select="warnings/warning">
<img src="tb.gif"/>
<xsl:value-of select="@text"/>
</xsl:for-each>
</xsl:template>
</xsl:stylesheet>