https://bugzilla.gnome.org/show_bug.cgi?id=688897
# Check for the end the comment block.
if COMMENT_END_RE.match(comment_lines[-1][1]):
del comment_lines[-1]
+ else:
+ # Not a GTK-Doc comment block.
+ return None
# If we get this far, we are inside a GTK-Doc comment block.
return self._parse_comment_block(comment_lines, filename, lineno)
<test>
<!--
+ Not GTK-Doc
+ -->
+ <commentblock>/**
+Test
+something */</commentblock>
+</test>
+
+<test>
+ <!--
+ Not GTK-Doc
+ -->
+ <commentblock>/**
+Test
+something **/</commentblock>
+</test>
+
+
+<test>
+ <!--
Broken comment block, signal the start of the comment block description followed
by a parameter instead.
-->