Created attachment 158165 [details] [review]
Patch extending doc extraction scripts

With the new gir annotations, sometimes the annotations are included in the generated docs xml.  The attached patch modifies the doc extraction scripts to deal with the new annotations[1].

[1] http://live.gnome.org/GObjectIntrospection/Annotations

The patch also enhances the documentation generation by modularizing the code and tweaking the regular expressions to handle special cases so that, for example, the function descriptions are not replaced by return descriptions among other improvements.

Also, the scripts now handle signal and property comment blocks somewhat better than before generating appropriate xml (like <signal name="Class::a-signal">...</signal>) and including to the entire name of the signal/property so it is clear as to which signal/property is being dealt with.

The code may be more, but I think the modularity makes it easier to know what is happening.

Following the patch, I'll attach some differences so that the original output can be compared to the new one.