From af2e146f5f24b93322ad0112d37a8e41222c3085 Mon Sep 17 00:00:00 2001
From: Dieter Verfaillie <dieterv@optionexplicit.be>
Date: Wed, 4 Jul 2012 11:58:13 +0200
Subject: giscanner: add AnnotationParser tests

The tests in giscanner/annotationpatters.py only test the regular
expression programs used when parsing GTK-Doc comment blocks but
do not test the structure of the resulting "parse tree".

This patch adds 193 GTK-Doc comment blocks and the expected
results AnnotationParser should return (with it's current level
of understanding of GTK-Doc comment block syntax). These are
compared by tests/scanner/annotationparser/test_parser.py which
complains with a diff on failure.

https://bugzilla.gnome.org/show_bug.cgi?id=688897
---
 .../annotationparser/gtkdoc/bugs/tester.c.xml      | 765 +++++++++++++++++++++
 1 file changed, 765 insertions(+)
 create mode 100644 tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml

(limited to 'tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml')

diff --git a/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml b/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml
new file mode 100644
index 00000000..f0a2b225
--- /dev/null
+++ b/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml
@@ -0,0 +1,765 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<tests>
+
+<test>
+  <commentblock><![CDATA[/**
+ * SECTION:tester
+ * @short_description: module for gtk-doc unit test
+ *
+ * This file contains non-sense code for the sole purpose of testing the docs.
+ *
+ * As described in http://bugzilla.gnome.org/show_bug.cgi?id=457077 it
+ * returns nothing.
+ *
+ * Some special characters need escaping. The tests should pass 100\%.
+ * Try a <ulink url="http://www.gtk.org/gtk-doc/#Top">link containing a # char</ulink>.
+ *
+ * <refsect2 id="dummy-id">
+ * <title>more details</title>
+ * <para>
+ * Second paragraph inside subsection.
+ * </para>
+ * </refsect2>
+ */]]></commentblock>
+  <docblock>
+    <identifier>
+      <name>SECTION:tester</name>
+    </identifier>
+    <parameters>
+      <parameter>
+        <name>short_description</name>
+        <description>module for gtk-doc unit test</description>
+      </parameter>
+    </parameters>
+    <description><![CDATA[This file contains non-sense code for the sole purpose of testing the docs.
+
+As described in http://bugzilla.gnome.org/show_bug.cgi?id=457077 it
+returns nothing.
+
+Some special characters need escaping. The tests should pass 100\%.
+Try a <ulink url="http://www.gtk.org/gtk-doc/#Top">link containing a # char</ulink>.
+
+<refsect2 id="dummy-id">
+<title>more details</title>
+<para>
+Second paragraph inside subsection.
+</para>
+</refsect2>]]></description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_141869_a:
+ * @pid: arg
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=141869
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_141869_a</name>
+    </identifier>
+    <parameters>
+      <parameter>
+        <name>pid</name>
+        <description>arg</description>
+      </parameter>
+    </parameters>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=141869</description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_141869_b:
+ * @pid: arg
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=141869
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_141869_b</name>
+    </identifier>
+    <parameters>
+      <parameter>
+        <name>pid</name>
+        <description>arg</description>
+      </parameter>
+    </parameters>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=141869</description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_379466:
+ * @pid: arg
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=379466
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_379466</name>
+    </identifier>
+    <parameters>
+      <parameter>
+        <name>pid</name>
+        <description>arg</description>
+      </parameter>
+    </parameters>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=379466</description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_380824:
+ * @arg: arg
+ *
+ * Returns a value.
+ * http://bugzilla.gnome.org/show_bug.cgi?id=380824
+ *
+ * Since: 0.1
+ *
+ * Returns: result
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_380824</name>
+    </identifier>
+    <parameters>
+      <parameter>
+        <name>arg</name>
+        <description>arg</description>
+      </parameter>
+    </parameters>
+    <description>Returns a value.
+http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
+    <tags>
+      <tag>
+        <name>since</name>
+        <description>0.1</description>
+      </tag>
+      <tag>
+        <name>returns</name>
+        <description>result</description>
+      </tag>
+    </tags>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_411739:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=411739
+ *
+ * Returns: result
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_411739</name>
+    </identifier>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=411739</description>
+    <tags>
+      <tag>
+        <name>returns</name>
+        <description>result</description>
+      </tag>
+    </tags>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_419997:
+ * @const_values: arg
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=419997
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_419997</name>
+    </identifier>
+    <parameters>
+      <parameter>
+        <name>const_values</name>
+        <description>arg</description>
+      </parameter>
+    </parameters>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=419997</description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_445693:
+ * @pid: arg
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=445693
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_445693</name>
+    </identifier>
+    <parameters>
+      <parameter>
+        <name>pid</name>
+        <description>arg</description>
+      </parameter>
+    </parameters>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=445693</description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_471014:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=471014
+ *
+ * Returns: result
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_471014</name>
+    </identifier>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=471014</description>
+    <tags>
+      <tag>
+        <name>returns</name>
+        <description>result</description>
+      </tag>
+    </tags>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * Bug446648:
+ * @BUG_446648_FOO: foo
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=446648
+ **/</commentblock>
+  <docblock>
+    <identifier>
+      <name>Bug446648</name>
+    </identifier>
+    <parameters>
+      <parameter>
+        <name>BUG_446648_FOO</name>
+        <description>foo</description>
+      </parameter>
+    </parameters>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=446648</description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_552602:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=552602
+ *
+ * Returns: result
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_552602</name>
+    </identifier>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=552602</description>
+    <tags>
+      <tag>
+        <name>returns</name>
+        <description>result</description>
+      </tag>
+    </tags>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_574654a:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=574654
+ *
+ * Returns: result
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_574654a</name>
+    </identifier>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=574654</description>
+    <tags>
+      <tag>
+        <name>returns</name>
+        <description>result</description>
+      </tag>
+    </tags>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_574654b:
+ * @offset: skip this many items
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=574654
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_574654b</name>
+    </identifier>
+    <parameters>
+      <parameter>
+        <name>offset</name>
+        <description>skip this many items</description>
+      </parameter>
+    </parameters>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=574654</description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_580300a_get_type:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=580300
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_580300a_get_type</name>
+    </identifier>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=580300</description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_580300b_get_type:
+ * @a: value
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=580300
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_580300b_get_type</name>
+    </identifier>
+    <parameters>
+      <parameter>
+        <name>a</name>
+        <description>value</description>
+      </parameter>
+    </parameters>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=580300</description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_580300c_get_type:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=580300
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_580300c_get_type</name>
+    </identifier>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=580300</description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_580300d_get_type:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=580300
+ *
+ * Returns: result
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_580300d_get_type</name>
+    </identifier>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=580300</description>
+    <tags>
+      <tag>
+        <name>returns</name>
+        <description>result</description>
+      </tag>
+    </tags>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_597937:
+ * @function_arg: value
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=597937
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_597937</name>
+    </identifier>
+    <parameters>
+      <parameter>
+        <name>function_arg</name>
+        <description>value</description>
+      </parameter>
+    </parameters>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=597937</description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_602518a:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=602518
+ *
+ * Returns: result
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_602518a</name>
+    </identifier>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=602518</description>
+    <tags>
+      <tag>
+        <name>returns</name>
+        <description>result</description>
+      </tag>
+    </tags>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_602518b:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=602518
+ *
+ * Returns: result
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_602518b</name>
+    </identifier>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=602518</description>
+    <tags>
+      <tag>
+        <name>returns</name>
+        <description>result</description>
+      </tag>
+    </tags>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_602518c:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=602518
+ *
+ * Returns: result
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_602518c</name>
+    </identifier>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=602518</description>
+    <tags>
+      <tag>
+        <name>returns</name>
+        <description>result</description>
+      </tag>
+    </tags>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_607445:
+ * @a: parameter
+ * @n: parameter
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=607445
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_607445</name>
+    </identifier>
+    <parameters>
+      <parameter>
+        <name>a</name>
+        <description>parameter</description>
+      </parameter>
+      <parameter>
+        <name>n</name>
+        <description>parameter</description>
+      </parameter>
+    </parameters>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=607445</description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_610257:
+ * @der: parameter
+ * @len: parameter
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=610257
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_610257</name>
+    </identifier>
+    <parameters>
+      <parameter>
+        <name>der</name>
+        <description>parameter</description>
+      </parameter>
+      <parameter>
+        <name>len</name>
+        <description>parameter</description>
+      </parameter>
+    </parameters>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=610257</description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock><![CDATA[/**
+ * bug_623968a:
+ *
+ * <para>test</para>
+ * <refsect3>
+ *   <title>subsect</title>
+ *   <para>test</para>
+ * </refsect3>
+ **/]]></commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_623968a</name>
+    </identifier>
+    <description><![CDATA[<para>test</para>
+<refsect3>
+  <title>subsect</title>
+  <para>test</para>
+</refsect3>]]></description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock><![CDATA[/**
+ * bug_623968b:
+ *
+ * test
+ *
+ * <refsect3>
+ *   <title>subsect</title>
+ *   <para>test</para>
+ * </refsect3>
+ **/]]></commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_623968b</name>
+    </identifier>
+    <description><![CDATA[test
+
+<refsect3>
+  <title>subsect</title>
+  <para>test</para>
+</refsect3>]]></description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock><![CDATA[/**
+ * bug_623968c:
+ *
+ * <para>test</para>
+ **/]]></commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_623968c</name>
+    </identifier>
+    <description><![CDATA[<para>test</para>]]></description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_624200a:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=624200
+ *
+ * Returns: result
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_624200a</name>
+    </identifier>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=624200</description>
+    <tags>
+      <tag>
+        <name>returns</name>
+        <description>result</description>
+      </tag>
+    </tags>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_624200b:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=624200
+ *
+ * Returns: result
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_624200b</name>
+    </identifier>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=624200</description>
+    <tags>
+      <tag>
+        <name>returns</name>
+        <description>result</description>
+      </tag>
+    </tags>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_638330:
+ * @arg1: arg1
+ * @data: data
+ * @length: length
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=638330
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_638330</name>
+    </identifier>
+    <parameters>
+      <parameter>
+        <name>arg1</name>
+        <description>arg1</description>
+      </parameter>
+      <parameter>
+        <name>data</name>
+        <description>data</description>
+      </parameter>
+      <parameter>
+        <name>length</name>
+        <description>length</description>
+      </parameter>
+    </parameters>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=638330</description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_000000_va1:
+ * @name: a name
+ * @...: A printf-style message to output
+ *
+ * Outputs a message.
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_000000_va1</name>
+    </identifier>
+    <parameters>
+      <parameter>
+        <name>name</name>
+        <description>a name</description>
+      </parameter>
+      <parameter>
+        <name>...</name>
+        <description>A printf-style message to output</description>
+      </parameter>
+    </parameters>
+    <description>Outputs a message.</description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_624001a:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=624001
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_624001a</name>
+    </identifier>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=624001</description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_624001b:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=624001
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_624001b</name>
+    </identifier>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=624001</description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_624001c:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=624001
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_624001c</name>
+    </identifier>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=624001</description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_624001d:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=624001
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_624001d</name>
+    </identifier>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=624001</description>
+  </docblock>
+</test>
+
+<test>
+  <commentblock>/**
+ * bug_624001e:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=624001
+ */</commentblock>
+  <docblock>
+    <identifier>
+      <name>bug_624001e</name>
+    </identifier>
+    <description>http://bugzilla.gnome.org/show_bug.cgi?id=624001</description>
+  </docblock>
+</test>
+
+</tests>
-- 
cgit v1.2.1


From 146a56f7f358dc14989e198fee4c2dd01b55be07 Mon Sep 17 00:00:00 2001
From: Dieter Verfaillie <dieterv@optionexplicit.be>
Date: Wed, 15 May 2013 14:42:09 +0200
Subject: tests: rename <commentblock> element to <input>

We'll start testing parser warning/error messages and
serialized output later on so this will make it easier to
see what's parser input and output...
---
 .../annotationparser/gtkdoc/bugs/tester.c.xml      | 140 ++++++++++-----------
 1 file changed, 70 insertions(+), 70 deletions(-)

(limited to 'tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml')

diff --git a/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml b/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml
index f0a2b225..250b1626 100644
--- a/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml
+++ b/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml
@@ -3,7 +3,7 @@
 <tests>
 
 <test>
-  <commentblock><![CDATA[/**
+  <input><![CDATA[/**
  * SECTION:tester
  * @short_description: module for gtk-doc unit test
  *
@@ -21,7 +21,7 @@
  * Second paragraph inside subsection.
  * </para>
  * </refsect2>
- */]]></commentblock>
+ */]]></input>
   <docblock>
     <identifier>
       <name>SECTION:tester</name>
@@ -50,12 +50,12 @@ Second paragraph inside subsection.
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_141869_a:
  * @pid: arg
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=141869
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_141869_a</name>
@@ -71,12 +71,12 @@ Second paragraph inside subsection.
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_141869_b:
  * @pid: arg
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=141869
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_141869_b</name>
@@ -92,12 +92,12 @@ Second paragraph inside subsection.
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_379466:
  * @pid: arg
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=379466
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_379466</name>
@@ -113,7 +113,7 @@ Second paragraph inside subsection.
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_380824:
  * @arg: arg
  *
@@ -123,7 +123,7 @@ Second paragraph inside subsection.
  * Since: 0.1
  *
  * Returns: result
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_380824</name>
@@ -150,13 +150,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_411739:
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=411739
  *
  * Returns: result
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_411739</name>
@@ -172,12 +172,12 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_419997:
  * @const_values: arg
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=419997
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_419997</name>
@@ -193,12 +193,12 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_445693:
  * @pid: arg
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=445693
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_445693</name>
@@ -214,13 +214,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_471014:
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=471014
  *
  * Returns: result
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_471014</name>
@@ -236,12 +236,12 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * Bug446648:
  * @BUG_446648_FOO: foo
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=446648
- **/</commentblock>
+ **/</input>
   <docblock>
     <identifier>
       <name>Bug446648</name>
@@ -257,13 +257,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_552602:
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=552602
  *
  * Returns: result
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_552602</name>
@@ -279,13 +279,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_574654a:
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=574654
  *
  * Returns: result
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_574654a</name>
@@ -301,12 +301,12 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_574654b:
  * @offset: skip this many items
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=574654
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_574654b</name>
@@ -322,11 +322,11 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_580300a_get_type:
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=580300
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_580300a_get_type</name>
@@ -336,12 +336,12 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_580300b_get_type:
  * @a: value
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=580300
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_580300b_get_type</name>
@@ -357,11 +357,11 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_580300c_get_type:
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=580300
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_580300c_get_type</name>
@@ -371,13 +371,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_580300d_get_type:
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=580300
  *
  * Returns: result
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_580300d_get_type</name>
@@ -393,12 +393,12 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_597937:
  * @function_arg: value
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=597937
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_597937</name>
@@ -414,13 +414,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_602518a:
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=602518
  *
  * Returns: result
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_602518a</name>
@@ -436,13 +436,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_602518b:
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=602518
  *
  * Returns: result
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_602518b</name>
@@ -458,13 +458,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_602518c:
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=602518
  *
  * Returns: result
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_602518c</name>
@@ -480,13 +480,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_607445:
  * @a: parameter
  * @n: parameter
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=607445
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_607445</name>
@@ -506,13 +506,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_610257:
  * @der: parameter
  * @len: parameter
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=610257
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_610257</name>
@@ -532,7 +532,7 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock><![CDATA[/**
+  <input><![CDATA[/**
  * bug_623968a:
  *
  * <para>test</para>
@@ -540,7 +540,7 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *   <title>subsect</title>
  *   <para>test</para>
  * </refsect3>
- **/]]></commentblock>
+ **/]]></input>
   <docblock>
     <identifier>
       <name>bug_623968a</name>
@@ -554,7 +554,7 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock><![CDATA[/**
+  <input><![CDATA[/**
  * bug_623968b:
  *
  * test
@@ -563,7 +563,7 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *   <title>subsect</title>
  *   <para>test</para>
  * </refsect3>
- **/]]></commentblock>
+ **/]]></input>
   <docblock>
     <identifier>
       <name>bug_623968b</name>
@@ -578,11 +578,11 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock><![CDATA[/**
+  <input><![CDATA[/**
  * bug_623968c:
  *
  * <para>test</para>
- **/]]></commentblock>
+ **/]]></input>
   <docblock>
     <identifier>
       <name>bug_623968c</name>
@@ -592,13 +592,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_624200a:
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=624200
  *
  * Returns: result
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_624200a</name>
@@ -614,13 +614,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_624200b:
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=624200
  *
  * Returns: result
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_624200b</name>
@@ -636,14 +636,14 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_638330:
  * @arg1: arg1
  * @data: data
  * @length: length
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=638330
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_638330</name>
@@ -667,13 +667,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_000000_va1:
  * @name: a name
  * @...: A printf-style message to output
  *
  * Outputs a message.
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_000000_va1</name>
@@ -693,11 +693,11 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_624001a:
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=624001
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_624001a</name>
@@ -707,11 +707,11 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_624001b:
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=624001
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_624001b</name>
@@ -721,11 +721,11 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_624001c:
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=624001
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_624001c</name>
@@ -735,11 +735,11 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_624001d:
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=624001
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_624001d</name>
@@ -749,11 +749,11 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </test>
 
 <test>
-  <commentblock>/**
+  <input>/**
  * bug_624001e:
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=624001
- */</commentblock>
+ */</input>
   <docblock>
     <identifier>
       <name>bug_624001e</name>
-- 
cgit v1.2.1


From 1359fb6d7a76609ec07e22af9cd79ae604d23d20 Mon Sep 17 00:00:00 2001
From: Dieter Verfaillie <dieterv@optionexplicit.be>
Date: Wed, 15 May 2013 17:31:14 +0200
Subject: tests: put <docblock> element inside a <parser> element

The <parser> element can then hold both the expected
<docblock> parse tree and the warning/error messages
emitted by the parser in a future <messages> child
element.
---
 .../annotationparser/gtkdoc/bugs/tester.c.xml      | 850 +++++++++++----------
 1 file changed, 460 insertions(+), 390 deletions(-)

(limited to 'tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml')

diff --git a/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml b/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml
index 250b1626..dd05970b 100644
--- a/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml
+++ b/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml
@@ -22,17 +22,18 @@
  * </para>
  * </refsect2>
  */]]></input>
-  <docblock>
-    <identifier>
-      <name>SECTION:tester</name>
-    </identifier>
-    <parameters>
-      <parameter>
-        <name>short_description</name>
-        <description>module for gtk-doc unit test</description>
-      </parameter>
-    </parameters>
-    <description><![CDATA[This file contains non-sense code for the sole purpose of testing the docs.
+  <parser>
+    <docblock>
+      <identifier>
+        <name>SECTION:tester</name>
+      </identifier>
+      <parameters>
+        <parameter>
+          <name>short_description</name>
+          <description>module for gtk-doc unit test</description>
+        </parameter>
+      </parameters>
+      <description><![CDATA[This file contains non-sense code for the sole purpose of testing the docs.
 
 As described in http://bugzilla.gnome.org/show_bug.cgi?id=457077 it
 returns nothing.
@@ -46,7 +47,8 @@ Try a <ulink url="http://www.gtk.org/gtk-doc/#Top">link containing a # char</uli
 Second paragraph inside subsection.
 </para>
 </refsect2>]]></description>
-  </docblock>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -56,18 +58,20 @@ Second paragraph inside subsection.
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=141869
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_141869_a</name>
-    </identifier>
-    <parameters>
-      <parameter>
-        <name>pid</name>
-        <description>arg</description>
-      </parameter>
-    </parameters>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=141869</description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_141869_a</name>
+      </identifier>
+      <parameters>
+        <parameter>
+          <name>pid</name>
+          <description>arg</description>
+        </parameter>
+      </parameters>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=141869</description>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -77,18 +81,20 @@ Second paragraph inside subsection.
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=141869
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_141869_b</name>
-    </identifier>
-    <parameters>
-      <parameter>
-        <name>pid</name>
-        <description>arg</description>
-      </parameter>
-    </parameters>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=141869</description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_141869_b</name>
+      </identifier>
+      <parameters>
+        <parameter>
+          <name>pid</name>
+          <description>arg</description>
+        </parameter>
+      </parameters>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=141869</description>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -98,18 +104,20 @@ Second paragraph inside subsection.
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=379466
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_379466</name>
-    </identifier>
-    <parameters>
-      <parameter>
-        <name>pid</name>
-        <description>arg</description>
-      </parameter>
-    </parameters>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=379466</description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_379466</name>
+      </identifier>
+      <parameters>
+        <parameter>
+          <name>pid</name>
+          <description>arg</description>
+        </parameter>
+      </parameters>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=379466</description>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -124,29 +132,31 @@ Second paragraph inside subsection.
  *
  * Returns: result
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_380824</name>
-    </identifier>
-    <parameters>
-      <parameter>
-        <name>arg</name>
-        <description>arg</description>
-      </parameter>
-    </parameters>
-    <description>Returns a value.
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_380824</name>
+      </identifier>
+      <parameters>
+        <parameter>
+          <name>arg</name>
+          <description>arg</description>
+        </parameter>
+      </parameters>
+      <description>Returns a value.
 http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
-    <tags>
-      <tag>
-        <name>since</name>
-        <description>0.1</description>
-      </tag>
-      <tag>
-        <name>returns</name>
-        <description>result</description>
-      </tag>
-    </tags>
-  </docblock>
+      <tags>
+        <tag>
+          <name>since</name>
+          <description>0.1</description>
+        </tag>
+        <tag>
+          <name>returns</name>
+          <description>result</description>
+        </tag>
+      </tags>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -157,18 +167,20 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * Returns: result
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_411739</name>
-    </identifier>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=411739</description>
-    <tags>
-      <tag>
-        <name>returns</name>
-        <description>result</description>
-      </tag>
-    </tags>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_411739</name>
+      </identifier>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=411739</description>
+      <tags>
+        <tag>
+          <name>returns</name>
+          <description>result</description>
+        </tag>
+      </tags>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -178,18 +190,20 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=419997
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_419997</name>
-    </identifier>
-    <parameters>
-      <parameter>
-        <name>const_values</name>
-        <description>arg</description>
-      </parameter>
-    </parameters>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=419997</description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_419997</name>
+      </identifier>
+      <parameters>
+        <parameter>
+          <name>const_values</name>
+          <description>arg</description>
+        </parameter>
+      </parameters>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=419997</description>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -199,18 +213,20 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=445693
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_445693</name>
-    </identifier>
-    <parameters>
-      <parameter>
-        <name>pid</name>
-        <description>arg</description>
-      </parameter>
-    </parameters>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=445693</description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_445693</name>
+      </identifier>
+      <parameters>
+        <parameter>
+          <name>pid</name>
+          <description>arg</description>
+        </parameter>
+      </parameters>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=445693</description>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -221,18 +237,20 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * Returns: result
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_471014</name>
-    </identifier>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=471014</description>
-    <tags>
-      <tag>
-        <name>returns</name>
-        <description>result</description>
-      </tag>
-    </tags>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_471014</name>
+      </identifier>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=471014</description>
+      <tags>
+        <tag>
+          <name>returns</name>
+          <description>result</description>
+        </tag>
+      </tags>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -242,18 +260,20 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=446648
  **/</input>
-  <docblock>
-    <identifier>
-      <name>Bug446648</name>
-    </identifier>
-    <parameters>
-      <parameter>
-        <name>BUG_446648_FOO</name>
-        <description>foo</description>
-      </parameter>
-    </parameters>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=446648</description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>Bug446648</name>
+      </identifier>
+      <parameters>
+        <parameter>
+          <name>BUG_446648_FOO</name>
+          <description>foo</description>
+        </parameter>
+      </parameters>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=446648</description>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -264,18 +284,20 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * Returns: result
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_552602</name>
-    </identifier>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=552602</description>
-    <tags>
-      <tag>
-        <name>returns</name>
-        <description>result</description>
-      </tag>
-    </tags>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_552602</name>
+      </identifier>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=552602</description>
+      <tags>
+        <tag>
+          <name>returns</name>
+          <description>result</description>
+        </tag>
+      </tags>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -286,18 +308,20 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * Returns: result
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_574654a</name>
-    </identifier>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=574654</description>
-    <tags>
-      <tag>
-        <name>returns</name>
-        <description>result</description>
-      </tag>
-    </tags>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_574654a</name>
+      </identifier>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=574654</description>
+      <tags>
+        <tag>
+          <name>returns</name>
+          <description>result</description>
+        </tag>
+      </tags>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -307,18 +331,20 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=574654
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_574654b</name>
-    </identifier>
-    <parameters>
-      <parameter>
-        <name>offset</name>
-        <description>skip this many items</description>
-      </parameter>
-    </parameters>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=574654</description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_574654b</name>
+      </identifier>
+      <parameters>
+        <parameter>
+          <name>offset</name>
+          <description>skip this many items</description>
+        </parameter>
+      </parameters>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=574654</description>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -327,12 +353,14 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=580300
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_580300a_get_type</name>
-    </identifier>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=580300</description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_580300a_get_type</name>
+      </identifier>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=580300</description>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -342,18 +370,20 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=580300
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_580300b_get_type</name>
-    </identifier>
-    <parameters>
-      <parameter>
-        <name>a</name>
-        <description>value</description>
-      </parameter>
-    </parameters>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=580300</description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_580300b_get_type</name>
+      </identifier>
+      <parameters>
+        <parameter>
+          <name>a</name>
+          <description>value</description>
+        </parameter>
+      </parameters>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=580300</description>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -362,12 +392,14 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=580300
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_580300c_get_type</name>
-    </identifier>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=580300</description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_580300c_get_type</name>
+      </identifier>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=580300</description>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -378,18 +410,20 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * Returns: result
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_580300d_get_type</name>
-    </identifier>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=580300</description>
-    <tags>
-      <tag>
-        <name>returns</name>
-        <description>result</description>
-      </tag>
-    </tags>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_580300d_get_type</name>
+      </identifier>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=580300</description>
+      <tags>
+        <tag>
+          <name>returns</name>
+          <description>result</description>
+        </tag>
+      </tags>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -399,18 +433,20 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=597937
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_597937</name>
-    </identifier>
-    <parameters>
-      <parameter>
-        <name>function_arg</name>
-        <description>value</description>
-      </parameter>
-    </parameters>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=597937</description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_597937</name>
+      </identifier>
+      <parameters>
+        <parameter>
+          <name>function_arg</name>
+          <description>value</description>
+        </parameter>
+      </parameters>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=597937</description>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -421,18 +457,20 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * Returns: result
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_602518a</name>
-    </identifier>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=602518</description>
-    <tags>
-      <tag>
-        <name>returns</name>
-        <description>result</description>
-      </tag>
-    </tags>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_602518a</name>
+      </identifier>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=602518</description>
+      <tags>
+        <tag>
+          <name>returns</name>
+          <description>result</description>
+        </tag>
+      </tags>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -443,18 +481,20 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * Returns: result
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_602518b</name>
-    </identifier>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=602518</description>
-    <tags>
-      <tag>
-        <name>returns</name>
-        <description>result</description>
-      </tag>
-    </tags>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_602518b</name>
+      </identifier>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=602518</description>
+      <tags>
+        <tag>
+          <name>returns</name>
+          <description>result</description>
+        </tag>
+      </tags>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -465,18 +505,20 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * Returns: result
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_602518c</name>
-    </identifier>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=602518</description>
-    <tags>
-      <tag>
-        <name>returns</name>
-        <description>result</description>
-      </tag>
-    </tags>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_602518c</name>
+      </identifier>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=602518</description>
+      <tags>
+        <tag>
+          <name>returns</name>
+          <description>result</description>
+        </tag>
+      </tags>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -487,22 +529,24 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=607445
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_607445</name>
-    </identifier>
-    <parameters>
-      <parameter>
-        <name>a</name>
-        <description>parameter</description>
-      </parameter>
-      <parameter>
-        <name>n</name>
-        <description>parameter</description>
-      </parameter>
-    </parameters>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=607445</description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_607445</name>
+      </identifier>
+      <parameters>
+        <parameter>
+          <name>a</name>
+          <description>parameter</description>
+        </parameter>
+        <parameter>
+          <name>n</name>
+          <description>parameter</description>
+        </parameter>
+      </parameters>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=607445</description>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -513,22 +557,24 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=610257
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_610257</name>
-    </identifier>
-    <parameters>
-      <parameter>
-        <name>der</name>
-        <description>parameter</description>
-      </parameter>
-      <parameter>
-        <name>len</name>
-        <description>parameter</description>
-      </parameter>
-    </parameters>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=610257</description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_610257</name>
+      </identifier>
+      <parameters>
+        <parameter>
+          <name>der</name>
+          <description>parameter</description>
+        </parameter>
+        <parameter>
+          <name>len</name>
+          <description>parameter</description>
+        </parameter>
+      </parameters>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=610257</description>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -541,16 +587,18 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *   <para>test</para>
  * </refsect3>
  **/]]></input>
-  <docblock>
-    <identifier>
-      <name>bug_623968a</name>
-    </identifier>
-    <description><![CDATA[<para>test</para>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_623968a</name>
+      </identifier>
+      <description><![CDATA[<para>test</para>
 <refsect3>
   <title>subsect</title>
   <para>test</para>
 </refsect3>]]></description>
-  </docblock>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -564,17 +612,19 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *   <para>test</para>
  * </refsect3>
  **/]]></input>
-  <docblock>
-    <identifier>
-      <name>bug_623968b</name>
-    </identifier>
-    <description><![CDATA[test
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_623968b</name>
+      </identifier>
+      <description><![CDATA[test
 
 <refsect3>
   <title>subsect</title>
   <para>test</para>
 </refsect3>]]></description>
-  </docblock>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -583,12 +633,14 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * <para>test</para>
  **/]]></input>
-  <docblock>
-    <identifier>
-      <name>bug_623968c</name>
-    </identifier>
-    <description><![CDATA[<para>test</para>]]></description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_623968c</name>
+      </identifier>
+      <description><![CDATA[<para>test</para>]]></description>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -599,18 +651,20 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * Returns: result
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_624200a</name>
-    </identifier>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=624200</description>
-    <tags>
-      <tag>
-        <name>returns</name>
-        <description>result</description>
-      </tag>
-    </tags>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_624200a</name>
+      </identifier>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=624200</description>
+      <tags>
+        <tag>
+          <name>returns</name>
+          <description>result</description>
+        </tag>
+      </tags>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -621,18 +675,20 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * Returns: result
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_624200b</name>
-    </identifier>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=624200</description>
-    <tags>
-      <tag>
-        <name>returns</name>
-        <description>result</description>
-      </tag>
-    </tags>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_624200b</name>
+      </identifier>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=624200</description>
+      <tags>
+        <tag>
+          <name>returns</name>
+          <description>result</description>
+        </tag>
+      </tags>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -644,26 +700,28 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=638330
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_638330</name>
-    </identifier>
-    <parameters>
-      <parameter>
-        <name>arg1</name>
-        <description>arg1</description>
-      </parameter>
-      <parameter>
-        <name>data</name>
-        <description>data</description>
-      </parameter>
-      <parameter>
-        <name>length</name>
-        <description>length</description>
-      </parameter>
-    </parameters>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=638330</description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_638330</name>
+      </identifier>
+      <parameters>
+        <parameter>
+          <name>arg1</name>
+          <description>arg1</description>
+        </parameter>
+        <parameter>
+          <name>data</name>
+          <description>data</description>
+        </parameter>
+        <parameter>
+          <name>length</name>
+          <description>length</description>
+        </parameter>
+      </parameters>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=638330</description>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -674,22 +732,24 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * Outputs a message.
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_000000_va1</name>
-    </identifier>
-    <parameters>
-      <parameter>
-        <name>name</name>
-        <description>a name</description>
-      </parameter>
-      <parameter>
-        <name>...</name>
-        <description>A printf-style message to output</description>
-      </parameter>
-    </parameters>
-    <description>Outputs a message.</description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_000000_va1</name>
+      </identifier>
+      <parameters>
+        <parameter>
+          <name>name</name>
+          <description>a name</description>
+        </parameter>
+        <parameter>
+          <name>...</name>
+          <description>A printf-style message to output</description>
+        </parameter>
+      </parameters>
+      <description>Outputs a message.</description>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -698,12 +758,14 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=624001
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_624001a</name>
-    </identifier>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=624001</description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_624001a</name>
+      </identifier>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=624001</description>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -712,12 +774,14 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=624001
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_624001b</name>
-    </identifier>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=624001</description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_624001b</name>
+      </identifier>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=624001</description>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -726,12 +790,14 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=624001
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_624001c</name>
-    </identifier>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=624001</description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_624001c</name>
+      </identifier>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=624001</description>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -740,12 +806,14 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=624001
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_624001d</name>
-    </identifier>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=624001</description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_624001d</name>
+      </identifier>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=624001</description>
+    </docblock>
+  </parser>
 </test>
 
 <test>
@@ -754,12 +822,14 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  *
  * http://bugzilla.gnome.org/show_bug.cgi?id=624001
  */</input>
-  <docblock>
-    <identifier>
-      <name>bug_624001e</name>
-    </identifier>
-    <description>http://bugzilla.gnome.org/show_bug.cgi?id=624001</description>
-  </docblock>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>bug_624001e</name>
+      </identifier>
+      <description>http://bugzilla.gnome.org/show_bug.cgi?id=624001</description>
+    </docblock>
+  </parser>
 </test>
 
 </tests>
-- 
cgit v1.2.1


From d464fb1f18173fea1aa3028cf44002944419b6ee Mon Sep 17 00:00:00 2001
From: Dieter Verfaillie <dieterv@optionexplicit.be>
Date: Wed, 22 May 2013 07:39:32 +0200
Subject: tests: validate GTK-Doc test files

This is more of a handy developer tool than something
that is always expected to be executed as part of the
test suite, so we don't add a hard dependency on xmllint.

https://bugzilla.gnome.org/show_bug.cgi?id=688897
---
 tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml')

diff --git a/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml b/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml
index dd05970b..b8aea1ac 100644
--- a/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml
+++ b/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 
-<tests>
+<tests xmlns="http://schemas.gnome.org/gobject-introspection/2013/test">
 
 <test>
   <input><![CDATA[/**
-- 
cgit v1.2.1


From 839e4f10a6b291a261c200484ff05ec44a31d93e Mon Sep 17 00:00:00 2001
From: Dieter Verfaillie <dieterv@optionexplicit.be>
Date: Thu, 25 Jul 2013 17:22:21 +0200
Subject: giscanner: extract tag values

---
 tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml')

diff --git a/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml b/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml
index b8aea1ac..1197c9b7 100644
--- a/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml
+++ b/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml
@@ -148,7 +148,7 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       <tags>
         <tag>
           <name>since</name>
-          <description>0.1</description>
+          <value>0.1</value>
         </tag>
         <tag>
           <name>returns</name>
-- 
cgit v1.2.1


From 6a874b86a1b9aae0c50a30b8cd3033870797eb1c Mon Sep 17 00:00:00 2001
From: Dieter Verfaillie <dieterv@optionexplicit.be>
Date: Tue, 23 Jul 2013 17:34:07 +0200
Subject: giscanner: refactor GTK-Doc comment block serialization

---
 .../annotationparser/gtkdoc/bugs/tester.c.xml      | 241 +++++++++++++++++++++
 1 file changed, 241 insertions(+)

(limited to 'tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml')

diff --git a/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml b/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml
index 1197c9b7..7d766c68 100644
--- a/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml
+++ b/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml
@@ -49,6 +49,25 @@ Second paragraph inside subsection.
 </refsect2>]]></description>
     </docblock>
   </parser>
+  <output><![CDATA[/**
+ * SECTION:tester
+ * @short_description: module for gtk-doc unit test
+ *
+ * This file contains non-sense code for the sole purpose of testing the docs.
+ *
+ * As described in http://bugzilla.gnome.org/show_bug.cgi?id=457077 it
+ * returns nothing.
+ *
+ * Some special characters need escaping. The tests should pass 100\%.
+ * Try a <ulink url="http://www.gtk.org/gtk-doc/#Top">link containing a # char</ulink>.
+ *
+ * <refsect2 id="dummy-id">
+ * <title>more details</title>
+ * <para>
+ * Second paragraph inside subsection.
+ * </para>
+ * </refsect2>
+ */]]></output>
 </test>
 
 <test>
@@ -72,6 +91,12 @@ Second paragraph inside subsection.
       <description>http://bugzilla.gnome.org/show_bug.cgi?id=141869</description>
     </docblock>
   </parser>
+  <output>/**
+ * bug_141869_a:
+ * @pid: arg
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=141869
+ */</output>
 </test>
 
 <test>
@@ -95,6 +120,12 @@ Second paragraph inside subsection.
       <description>http://bugzilla.gnome.org/show_bug.cgi?id=141869</description>
     </docblock>
   </parser>
+  <output>/**
+ * bug_141869_b:
+ * @pid: arg
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=141869
+ */</output>
 </test>
 
 <test>
@@ -118,6 +149,12 @@ Second paragraph inside subsection.
       <description>http://bugzilla.gnome.org/show_bug.cgi?id=379466</description>
     </docblock>
   </parser>
+  <output>/**
+ * bug_379466:
+ * @pid: arg
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=379466
+ */</output>
 </test>
 
 <test>
@@ -157,6 +194,16 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       </tags>
     </docblock>
   </parser>
+  <output>/**
+ * bug_380824:
+ * @arg: arg
+ *
+ * Returns a value.
+ * http://bugzilla.gnome.org/show_bug.cgi?id=380824
+ *
+ * Since: 0.1
+ * Returns: result
+ */</output>
 </test>
 
 <test>
@@ -181,6 +228,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       </tags>
     </docblock>
   </parser>
+  <output>/**
+ * bug_411739:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=411739
+ *
+ * Returns: result
+ */</output>
 </test>
 
 <test>
@@ -204,6 +258,12 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       <description>http://bugzilla.gnome.org/show_bug.cgi?id=419997</description>
     </docblock>
   </parser>
+  <output>/**
+ * bug_419997:
+ * @const_values: arg
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=419997
+ */</output>
 </test>
 
 <test>
@@ -227,6 +287,12 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       <description>http://bugzilla.gnome.org/show_bug.cgi?id=445693</description>
     </docblock>
   </parser>
+  <output>/**
+ * bug_445693:
+ * @pid: arg
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=445693
+ */</output>
 </test>
 
 <test>
@@ -251,6 +317,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       </tags>
     </docblock>
   </parser>
+  <output>/**
+ * bug_471014:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=471014
+ *
+ * Returns: result
+ */</output>
 </test>
 
 <test>
@@ -274,6 +347,12 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       <description>http://bugzilla.gnome.org/show_bug.cgi?id=446648</description>
     </docblock>
   </parser>
+  <output>/**
+ * Bug446648:
+ * @BUG_446648_FOO: foo
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=446648
+ */</output>
 </test>
 
 <test>
@@ -298,6 +377,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       </tags>
     </docblock>
   </parser>
+  <output>/**
+ * bug_552602:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=552602
+ *
+ * Returns: result
+ */</output>
 </test>
 
 <test>
@@ -322,6 +408,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       </tags>
     </docblock>
   </parser>
+  <output>/**
+ * bug_574654a:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=574654
+ *
+ * Returns: result
+ */</output>
 </test>
 
 <test>
@@ -345,6 +438,12 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       <description>http://bugzilla.gnome.org/show_bug.cgi?id=574654</description>
     </docblock>
   </parser>
+  <output>/**
+ * bug_574654b:
+ * @offset: skip this many items
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=574654
+ */</output>
 </test>
 
 <test>
@@ -361,6 +460,11 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       <description>http://bugzilla.gnome.org/show_bug.cgi?id=580300</description>
     </docblock>
   </parser>
+  <output>/**
+ * bug_580300a_get_type:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=580300
+ */</output>
 </test>
 
 <test>
@@ -384,6 +488,12 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       <description>http://bugzilla.gnome.org/show_bug.cgi?id=580300</description>
     </docblock>
   </parser>
+  <output>/**
+ * bug_580300b_get_type:
+ * @a: value
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=580300
+ */</output>
 </test>
 
 <test>
@@ -400,6 +510,11 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       <description>http://bugzilla.gnome.org/show_bug.cgi?id=580300</description>
     </docblock>
   </parser>
+  <output>/**
+ * bug_580300c_get_type:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=580300
+ */</output>
 </test>
 
 <test>
@@ -424,6 +539,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       </tags>
     </docblock>
   </parser>
+  <output>/**
+ * bug_580300d_get_type:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=580300
+ *
+ * Returns: result
+ */</output>
 </test>
 
 <test>
@@ -447,6 +569,12 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       <description>http://bugzilla.gnome.org/show_bug.cgi?id=597937</description>
     </docblock>
   </parser>
+  <output>/**
+ * bug_597937:
+ * @function_arg: value
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=597937
+ */</output>
 </test>
 
 <test>
@@ -471,6 +599,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       </tags>
     </docblock>
   </parser>
+  <output>/**
+ * bug_602518a:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=602518
+ *
+ * Returns: result
+ */</output>
 </test>
 
 <test>
@@ -495,6 +630,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       </tags>
     </docblock>
   </parser>
+  <output>/**
+ * bug_602518b:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=602518
+ *
+ * Returns: result
+ */</output>
 </test>
 
 <test>
@@ -519,6 +661,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       </tags>
     </docblock>
   </parser>
+  <output>/**
+ * bug_602518c:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=602518
+ *
+ * Returns: result
+ */</output>
 </test>
 
 <test>
@@ -547,6 +696,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       <description>http://bugzilla.gnome.org/show_bug.cgi?id=607445</description>
     </docblock>
   </parser>
+  <output>/**
+ * bug_607445:
+ * @a: parameter
+ * @n: parameter
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=607445
+ */</output>
 </test>
 
 <test>
@@ -575,6 +731,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       <description>http://bugzilla.gnome.org/show_bug.cgi?id=610257</description>
     </docblock>
   </parser>
+  <output>/**
+ * bug_610257:
+ * @der: parameter
+ * @len: parameter
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=610257
+ */</output>
 </test>
 
 <test>
@@ -599,6 +762,15 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </refsect3>]]></description>
     </docblock>
   </parser>
+  <output><![CDATA[/**
+ * bug_623968a:
+ *
+ * <para>test</para>
+ * <refsect3>
+ *   <title>subsect</title>
+ *   <para>test</para>
+ * </refsect3>
+ */]]></output>
 </test>
 
 <test>
@@ -625,6 +797,16 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
 </refsect3>]]></description>
     </docblock>
   </parser>
+  <output><![CDATA[/**
+ * bug_623968b:
+ *
+ * test
+ *
+ * <refsect3>
+ *   <title>subsect</title>
+ *   <para>test</para>
+ * </refsect3>
+ */]]></output>
 </test>
 
 <test>
@@ -641,6 +823,11 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       <description><![CDATA[<para>test</para>]]></description>
     </docblock>
   </parser>
+  <output><![CDATA[/**
+ * bug_623968c:
+ *
+ * <para>test</para>
+ */]]></output>
 </test>
 
 <test>
@@ -665,6 +852,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       </tags>
     </docblock>
   </parser>
+  <output>/**
+ * bug_624200a:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=624200
+ *
+ * Returns: result
+ */</output>
 </test>
 
 <test>
@@ -689,6 +883,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       </tags>
     </docblock>
   </parser>
+  <output>/**
+ * bug_624200b:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=624200
+ *
+ * Returns: result
+ */</output>
 </test>
 
 <test>
@@ -722,6 +923,14 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       <description>http://bugzilla.gnome.org/show_bug.cgi?id=638330</description>
     </docblock>
   </parser>
+  <output>/**
+ * bug_638330:
+ * @arg1: arg1
+ * @data: data
+ * @length: length
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=638330
+ */</output>
 </test>
 
 <test>
@@ -750,6 +959,13 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       <description>Outputs a message.</description>
     </docblock>
   </parser>
+  <output>/**
+ * bug_000000_va1:
+ * @name: a name
+ * @...: A printf-style message to output
+ *
+ * Outputs a message.
+ */</output>
 </test>
 
 <test>
@@ -766,6 +982,11 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       <description>http://bugzilla.gnome.org/show_bug.cgi?id=624001</description>
     </docblock>
   </parser>
+  <output>/**
+ * bug_624001a:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=624001
+ */</output>
 </test>
 
 <test>
@@ -782,6 +1003,11 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       <description>http://bugzilla.gnome.org/show_bug.cgi?id=624001</description>
     </docblock>
   </parser>
+  <output>/**
+ * bug_624001b:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=624001
+ */</output>
 </test>
 
 <test>
@@ -798,6 +1024,11 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       <description>http://bugzilla.gnome.org/show_bug.cgi?id=624001</description>
     </docblock>
   </parser>
+  <output>/**
+ * bug_624001c:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=624001
+ */</output>
 </test>
 
 <test>
@@ -814,6 +1045,11 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       <description>http://bugzilla.gnome.org/show_bug.cgi?id=624001</description>
     </docblock>
   </parser>
+  <output>/**
+ * bug_624001d:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=624001
+ */</output>
 </test>
 
 <test>
@@ -830,6 +1066,11 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
       <description>http://bugzilla.gnome.org/show_bug.cgi?id=624001</description>
     </docblock>
   </parser>
+  <output>/**
+ * bug_624001e:
+ *
+ * http://bugzilla.gnome.org/show_bug.cgi?id=624001
+ */</output>
 </test>
 
 </tests>
-- 
cgit v1.2.1


From 0d17576deb4b72d29e60ed5d2d91ca8ecc0ef290 Mon Sep 17 00:00:00 2001
From: Dieter Verfaillie <dieterv@optionexplicit.be>
Date: Tue, 30 Jul 2013 11:26:31 +0200
Subject: tests: sync with GTK-Doc test suite @
 1846fc7e904f6f56b74c366d205d6bb946eac17e

---
 .../annotationparser/gtkdoc/bugs/tester.c.xml      | 32 ++++++++++++++++++++++
 1 file changed, 32 insertions(+)

(limited to 'tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml')

diff --git a/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml b/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml
index 7d766c68..09ab9773 100644
--- a/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml
+++ b/tests/scanner/annotationparser/gtkdoc/bugs/tester.c.xml
@@ -1073,4 +1073,36 @@ http://bugzilla.gnome.org/show_bug.cgi?id=380824</description>
  */</output>
 </test>
 
+<test>
+  <input>/**
+ * deprecation_notice:
+ *
+ * Foo.
+ *
+ * Deprecated: 3.10: Use named icon "bar" instead.
+ */</input>
+  <parser>
+    <docblock>
+      <identifier>
+        <name>deprecation_notice</name>
+      </identifier>
+      <description>Foo.</description>
+      <tags>
+        <tag>
+          <name>deprecated</name>
+          <value>3.10</value>
+          <description>Use named icon "bar" instead.</description>
+        </tag>
+      </tags>
+    </docblock>
+  </parser>
+  <output>/**
+ * deprecation_notice:
+ *
+ * Foo.
+ *
+ * Deprecated: 3.10: Use named icon "bar" instead.
+ */</output>
+</test>
+
 </tests>
-- 
cgit v1.2.1