<?xml version="1.0" encoding="UTF-8"?>

<tests>

<test>
  <commentblock><![CDATA[/**
 * SECTION:iface
 * @title: GtkdocIface
 * @short_description: interface for gtk-doc unit test
 * @see_also: #GtkdocObject
 *
 * This file contains non-sense code for the sole purpose of testing the docs.
 * We can link to the #GtkdocIface:itest property and the #GtkdocIface::itest
 * signal.
 * An instance can be configured using the gtkdoc_iface_configure() function.
 *
 * I can haz pictures too!
 * <mediaobject>
 *   <imageobject><imagedata fileref="home.png" format="PNG"/></imageobject>
 *   <caption><para>Home sweet home.</para></caption>
 * </mediaobject>
 *
 * Just incase you wonder, special caracters can be escaped with a \ like in \%
 * or \# or even \@.
 */]]></commentblock>
  <docblock>
    <identifier>
      <name>SECTION:iface</name>
    </identifier>
    <parameters>
      <parameter>
        <name>title</name>
        <description>GtkdocIface</description>
      </parameter>
      <parameter>
        <name>short_description</name>
        <description>interface for gtk-doc unit test</description>
      </parameter>
      <parameter>
        <name>see_also</name>
        <description>#GtkdocObject</description>
      </parameter>
    </parameters>
    <description><![CDATA[This file contains non-sense code for the sole purpose of testing the docs.
We can link to the #GtkdocIface:itest property and the #GtkdocIface::itest
signal.
An instance can be configured using the gtkdoc_iface_configure() function.

I can haz pictures too!
<mediaobject>
  <imageobject><imagedata fileref="home.png" format="PNG"/></imageobject>
  <caption><para>Home sweet home.</para></caption>
</mediaobject>

Just incase you wonder, special caracters can be escaped with a \ like in \%
or \# or even \@.]]></description>
  </docblock>
</test>

<test>
  <commentblock>/**
 * SECTION:iface2
 * @title: GtkdocIface2
 * @short_description: interface with a prerequisite for gtk-doc unit test
 * @see_also: #GtkdocObject, #GtkdocIface
 *
 * This file contains non-sense code for the sole purpose of testing the docs.
 */</commentblock>
  <docblock>
    <identifier>
      <name>SECTION:iface2</name>
    </identifier>
    <parameters>
      <parameter>
        <name>title</name>
        <description>GtkdocIface2</description>
      </parameter>
      <parameter>
        <name>short_description</name>
        <description>interface with a prerequisite for gtk-doc unit test</description>
      </parameter>
      <parameter>
        <name>see_also</name>
        <description>#GtkdocObject, #GtkdocIface</description>
      </parameter>
    </parameters>
    <description>This file contains non-sense code for the sole purpose of testing the docs.</description>
  </docblock>
</test>

<test>
  <commentblock>/**
 * gtkdoc_iface_configure:
 * @config: settings
 *
 * Configure a new instance
 *
 * Returns: %TRUE for sucess or %FALSE in case of an error
 *
 * Since: 0.1
 */</commentblock>
  <docblock>
    <identifier>
      <name>gtkdoc_iface_configure</name>
    </identifier>
    <parameters>
      <parameter>
        <name>config</name>
        <description>settings</description>
      </parameter>
    </parameters>
    <description>Configure a new instance</description>
    <tags>
      <tag>
        <name>returns</name>
        <description>%TRUE for sucess or %FALSE in case of an error</description>
      </tag>
      <tag>
        <name>since</name>
        <description>0.1</description>
      </tag>
    </tags>
  </docblock>
</test>

<test>
  <commentblock>/**
     * GtkdocIface::itest:
     * @self: myself
     *
     * The event has been triggered.
     */</commentblock>
  <docblock>
    <identifier>
      <name>GtkdocIface::itest</name>
    </identifier>
    <parameters>
      <parameter>
        <name>self</name>
        <description>myself</description>
      </parameter>
    </parameters>
    <description>The event has been triggered.</description>
  </docblock>
</test>

</tests>
