summaryrefslogtreecommitdiff
path: root/tests/scanner/annotationparser/gi/syntax_whitespace.xml
diff options
context:
space:
mode:
authorDieter Verfaillie <dieterv@optionexplicit.be>2013-08-14 17:00:39 +0200
committerDieter Verfaillie <dieterv@optionexplicit.be>2013-10-08 20:56:28 +0200
commitba425f1fd48df193fe7a8c6cc559f0b408160604 (patch)
tree39d726ef89cd8925eea02bc46e41255987b9544d /tests/scanner/annotationparser/gi/syntax_whitespace.xml
parent23dddc02594e733b65f9be76dbf0a0a1e54bc67c (diff)
downloadgobject-introspection-ba425f1fd48df193fe7a8c6cc559f0b408160604.tar.gz
giscanner: honor line and paragraph breaks in description fields
GTK-Doc parameter description fields are allowed to span multiple lines, tag description fields are allowed to span multiple lines and paragraphs. A tool fixing/rewriting GTK-Doc comment blocks in source files would need to have description fields parsed and stored (almost) exactly as they appear in the source file.
Diffstat (limited to 'tests/scanner/annotationparser/gi/syntax_whitespace.xml')
-rw-r--r--tests/scanner/annotationparser/gi/syntax_whitespace.xml62
1 files changed, 62 insertions, 0 deletions
diff --git a/tests/scanner/annotationparser/gi/syntax_whitespace.xml b/tests/scanner/annotationparser/gi/syntax_whitespace.xml
new file mode 100644
index 00000000..e66836c2
--- /dev/null
+++ b/tests/scanner/annotationparser/gi/syntax_whitespace.xml
@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<tests xmlns="http://schemas.gnome.org/gobject-introspection/2013/test">
+
+<test>
+ <input>/**
+ * whitespace_test:
+ * @object: (skip):
+ *
+ * A #AnnotationObject
+ *
+ *
+ * @func: The callback
+ *
+ *
+ * Test overriding via the "Rename To" annotation.
+ *
+ *
+ * Returns: nothing
+ *
+ *
+ */</input>
+ <parser>
+ <docblock>
+ <identifier>
+ <name>whitespace_test</name>
+ </identifier>
+ <parameters>
+ <parameter>
+ <name>object</name>
+ <annotations>
+ <annotation>
+ <name>skip</name>
+ </annotation>
+ </annotations>
+ </parameter>
+ <parameter>
+ <name>func</name>
+ <description>The callback</description>
+ </parameter>
+ </parameters>
+ <description>A #AnnotationObject
+
+
+
+Test overriding via the "Rename To" annotation.</description>
+ <tags>
+ <tag>
+ <name>returns</name>
+ <description>nothing</description>
+ </tag>
+ </tags>
+ </docblock>
+ <messages>
+ <message>8: Warning: Test: "@func" parameter unexpected at this location:
+ * @func: The callback
+ ^</message>
+ </messages>
+ </parser>
+</test>
+
+</tests>