dbus/doc/introspect.xsl
John (J5) Palmieri 8d1e7dfeb9 * ChangeLog: clean up my last entry a bit
* doc/introspect.xsl: New stylesheet for converting introspection data
	into browser renderable xhtml. Contributed by Lennart Poettering.

	* doc/introspect.dtd: Fixups in the introspect format from Lennart
	Poettering.

	* doc/dbus-tutorial.xml:
	- Add Colin Walter to the Authors section for authoring the GLib
	section
	- Add descriptions of the new signature and type functionality
	in the Python complex type mapping section
	- Add a sidenote on the new args matching functionality in
	the Python bindings
	- Fixed up some of the examples to use the gobject.MainLoop
	instead of gtk.main

	* python/_dbus.py:
	(Bus::_create_args_dict): New. Converts a hash of arg matches
	to a more useable format
	(Bus::add_signal_receiver): add a **keywords parameter for catching
	arg match parameters
	(Bus::remove_signal_receiver): add a **keywords parameter for catching
	arg match parameters

	* python/matchrules.py:
	(MatchTree::exec_matches): Check for arg matches
	(SignalMatchRule::add_args_match): New method
	(SignalMatchRule::execute): Added args_list parameter as an optimization
	so we don't have to marshal the args more than once
	(SignalMatchRule::match_args_from_list): New method that checks to see
	if the rule's arg matches match an argument list.  Only arguments
	set in the rule are checked.
	(SignalMatchRule::match_args_from_rule): New method that checks to see
	if the rule's arg matches match another rule's.  All args have to match
	in order for this method to return true.  If either rule has more args
	then it is not a match.
	(SignalMatchRule::is_match): Add args match
	(SignalMatchRule::repr): Add args to the final output if they exist
2005-08-18 04:04:57 +00:00

106 lines
3.7 KiB
XML

<?xml version="1.0" encoding="ISO-8859-15"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns="http://www.w3.org/1999/xhtml">
<!--
Copyright (C) 2005 Lennart Poettering.
Licensed under the Academic Free License version 2.1
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program 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 General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
-->
<!-- $Id$ -->
<xsl:output method="xml" version="1.0" encoding="iso-8859-15" doctype-public="-//W3C//DTD XHTML 1.0 Strict//EN" doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd" indent="yes"/>
<xsl:template match="/">
<html>
<head>
<title>DBUS Introspection data</title>
<style type="text/css">
body { color: black; background-color: white }
h1 { font-family: sans-serif }
ul { list-style-type: none; margin-bottom: 10px }
li { font-family: sans-serif }
.keyword { font-style: italic }
.type { font-weight: bold }
.symbol { font-family: monospace }
.interface { padding: 10px; margin: 10px }
</style>
</head>
<body>
<xsl:for-each select="node/interface">
<div class="interface">
<h1>
<span class="keyword">interface</span><xsl:text> </xsl:text>
<span class="symbol"><xsl:value-of select="@name"/></span>
</h1>
<ul>
<xsl:apply-templates select="annotation"/>
<xsl:for-each select="method|signal|property">
<li>
<span class="keyword"><xsl:value-of select="name()"/></span>
<xsl:text> </xsl:text>
<span class="symbol"><xsl:value-of select="@name"/></span>
<ul>
<xsl:apply-templates select="annotation"/>
<xsl:for-each select="arg">
<li>
<span class="keyword">
<xsl:choose>
<xsl:when test="@direction != &quot;&quot;">
<xsl:value-of select="@direction"/>
</xsl:when>
<xsl:when test="name(..) = &quot;signal&quot;">
out
</xsl:when>
<xsl:otherwise>
in
</xsl:otherwise>
</xsl:choose>
</span>
<xsl:text> </xsl:text>
<span class="type"><xsl:value-of select="@type"/></span><xsl:text> </xsl:text>
<span class="symbol"><xsl:value-of select="@name"/></span><xsl:text> </xsl:text>
</li>
</xsl:for-each>
</ul>
</li>
</xsl:for-each>
</ul>
</div>
</xsl:for-each>
</body>
</html>
</xsl:template>
<xsl:template match="annotation">
<li>
<span class="keyword">annotation</span>
<code><xsl:value-of select="@name"/></code><xsl:text> = </xsl:text>
<code><xsl:value-of select="@value"/></code>
</li>
</xsl:template>
</xsl:stylesheet>