Fix malformed GTK-Doc comment blocks:

- add missing colons
- invalid annotations
- invalid parameters and tags
- correct parameter name
- preserve description indentation
- no description parts
- comment end marker
- invalid empty lines
- line numbers

AnnotationParser now emits warnings which are considered as
errors by "make check" so fix those warnings...

https://bugzilla.gnome.org/show_bug.cgi?id=672254

1 files changed, 25 insertions, 25 deletions

diff --git a/tests/scanner/Regress-1.0-expected.gir b/tests/scanner/Regress-1.0-expected.gir
index 5d806d36..5ca8a577 100644
--- a/tests/scanner/Regress-1.0-expected.gir
+++ b/tests/scanner/Regress-1.0-expected.gir
@@ -1040,7 +1040,7 @@ raise an error.</doc>
       </glib:signal>
       <glib:signal name="sig-with-array-prop" when="last">
         <doc xml:whitespace="preserve">This test signal is like TelepathyGlib's
-TpChannel:: group-members-changed-detailed:</doc>
+ TpChannel:: group-members-changed-detailed:</doc>
         <return-value transfer-ownership="none">
           <type name="none"/>
         </return-value>
@@ -1055,7 +1055,7 @@ TpChannel:: group-members-changed-detailed:</doc>
       </glib:signal>
       <glib:signal name="sig-with-hash-prop" when="last">
         <doc xml:whitespace="preserve">This test signal is like TelepathyGlib's
-TpAccount::status-changed</doc>
+ TpAccount::status-changed</doc>
         <return-value transfer-ownership="none">
           <type name="none"/>
         </return-value>
@@ -2716,30 +2716,30 @@ You will give me your credit card number.</doc>
     <function name="test_nested_parameter"
               c:identifier="regress_test_nested_parameter">
       <doc xml:whitespace="preserve">&lt;informaltable&gt;
-&lt;tgroup cols="3"&gt;
-&lt;thead&gt;
-&lt;row&gt;
-&lt;entry&gt;Syntax&lt;/entry&gt;
-&lt;entry&gt;Explanation&lt;/entry&gt;
-&lt;entry&gt;Examples&lt;/entry&gt;
-&lt;/row&gt;
-&lt;/thead&gt;
-&lt;tbody&gt;
-&lt;row&gt;
-&lt;entry&gt;rgb(@r, @g, @b)&lt;/entry&gt;
-&lt;entry&gt;An opaque color; @r, @g, @b can be either integers between
-0 and 255 or percentages&lt;/entry&gt;
-&lt;entry&gt;&lt;literallayout&gt;rgb(128, 10, 54)
+  &lt;tgroup cols="3"&gt;
+    &lt;thead&gt;
+      &lt;row&gt;
+        &lt;entry&gt;Syntax&lt;/entry&gt;
+        &lt;entry&gt;Explanation&lt;/entry&gt;
+        &lt;entry&gt;Examples&lt;/entry&gt;
+      &lt;/row&gt;
+    &lt;/thead&gt;
+    &lt;tbody&gt;
+      &lt;row&gt;
+        &lt;entry&gt;rgb(@r, @g, @b)&lt;/entry&gt;
+        &lt;entry&gt;An opaque color; @r, @g, @b can be either integers between
+               0 and 255 or percentages&lt;/entry&gt;
+        &lt;entry&gt;&lt;literallayout&gt;rgb(128, 10, 54)
 rgb(20%, 30%, 0%)&lt;/literallayout&gt;&lt;/entry&gt;
-&lt;/row&gt;
-&lt;row&gt;
-&lt;entry&gt;rgba(@r, @g, @b, @a)&lt;/entry&gt;
-&lt;entry&gt;A translucent color; @r, @g, @b are as in the previous row,
-@a is a floating point number between 0 and 1&lt;/entry&gt;
-&lt;entry&gt;&lt;literallayout&gt;rgba(255, 255, 0, 0.5)&lt;/literallayout&gt;&lt;/entry&gt;
-&lt;/row&gt;
-&lt;/tbody&gt;
-&lt;/tgroup&gt;
+      &lt;/row&gt;
+      &lt;row&gt;
+        &lt;entry&gt;rgba(@r, @g, @b, @a)&lt;/entry&gt;
+        &lt;entry&gt;A translucent color; @r, @g, @b are as in the previous row,
+               @a is a floating point number between 0 and 1&lt;/entry&gt;
+        &lt;entry&gt;&lt;literallayout&gt;rgba(255, 255, 0, 0.5)&lt;/literallayout&gt;&lt;/entry&gt;
+      &lt;/row&gt;
+   &lt;/tbody&gt;
+ &lt;/tgroup&gt;
 &lt;/informaltable&gt;
 
 What we're testing here is that the scanner ignores the @a nested inside XML.</doc>