It seems that gtk-doc tools no longer allow using < and > directly in <programlisting> after gtk-doc is rewritten in python.


Error in gtkdoc helper script:
'gtkdoc-mkhtml' failed with status 6
../xml/pangocairo.xml:153: parser error : error parsing attribute name
#include <pango/pangocairo.h>
               ^
../xml/pangocairo.xml:153: parser error : attributes construct error
#include <pango/pangocairo.h>
               ^
../xml/pangocairo.xml:153: parser error : Couldn't find end of Start Tag pango line 153
#include <pango/pangocairo.h>
               ^
../xml/pangocairo.xml:242: parser error : Opening and ending tag mismatch: math.h line 152 and programlisting
</programlisting>
                 ^
../xml/pangocairo.xml:243: parser error : Opening and ending tag mismatch: programlisting line 151 and example
</example>
          ^
../xml/pangocairo.xml:249: parser error : Opening and ending tag mismatch: example line 149 and refsect1
</refsect1>
           ^
../xml/pangocairo.xml:1124: parser error : Opening and ending tag mismatch: refsect1 line 122 and refentry
</refentry>
           ^
../xml/pangocairo.xml:1125: parser error : Premature end of data in tag refentry line 8

^
../pango-docs.sgml:33: element include: XInclude error : could not load ../xml/pangocairo.xml, and no fallback was found


This problem has be reported to gtk-doc as bug 783420, and they recommend using CDATA sections or |[ and ]|.