Re: gtk-doc-1.22 change wrt to tmpl builds

[Milan Crha <mcrha redhat com>]

On Sun, 2015-04-26 at 21:38 +0200, Stefan Sauer wrote:
> The upcoming gtk-doc-1.22 release will switch the default makefile
> flavour from "legacy" to "no-tmpl".

        Hi,
I'm trying to build evolution-data-server 3.16.2 against gtk-doc-1.22
and it fails [1]. It has its configure.ac with this line:
   GTK_DOC_CHECK([1.14],[--flavour no-tmpl])
thus should not be affected by the change. Trying to build against
gtk-doc 1.21 works flawlessly.

I'm wondering, could there be a regression in the gtk-doc 1.22, or is
there anything I should fix in evolution-data-server? The thing is that
if I understand the errors properly, then it's in the generated files,
which are mostly out of my hands.
        Thanks and bye,
        Milan

[1] The actual build errors with gtk-doc 1.22:

      DOC   Building HTML
    ../xml/e-source-webdav.xml:125: parser error :
    Opening and ending tag mismatch: note line 125 and para
    <para><note></para>
                       ^
    ../xml/e-source
    -webdav.xml:131: parser error : Opening and ending tag mismatch:
    para line 131 and note
    <para></note></para>
                 ^
    ../xml/e-source-webdav.xml:157: parser error : Opening and ending tag mismatch: note line 157 and para
    <para><note></para>
                       ^
    ../xml/e-source-webdav.xml:163: parser error : Opening and ending tag mismatch: para line 163 and note
    <para></note></para>
                 ^
    ../eds-docs.sgml:118: element include: XInclude error : could not load ../xml/e-source-webdav.xml, and no 
fallback was found
    ../xml/e-book-client-cursor.xml:244: parser error : Opening and ending tag mismatch: programlisting line 
242 and para
        gdouble percent;</para>
                               ^
    ../xml/e-book-client-cursor.xml:245: parser error : xmlParseEntityRef: no name
    <para>    // Fetch the position & total
                                     ^
    ../xml/e-book-client-cursor.xml:256: parser error : Sequence ']]>' not allowed in content
    <para>    // Let the user know the percentage of contacts in the list
          ^
    ../xml/e-book-client-cursor.xml:256: parser error : Sequence ']]>' not allowed in content
        update_percentage_of_list_browsed (user_interface, percent);]]></programlist
                                                                    ^
    ../xml/e-book-client-cursor.xml:256: parser error : internal error: detected an error in element content
        update_percentage_of_list_browsed (user_interface, percent);]]></programlist
                                                                    ^
    ../xml/e-book-client-cursor.xml:256: parser error : Extra content at the end of the document
        update_percentage_of_list_browsed (user_interface, percent);]]></programlist
                                                                    ^
    ../eds-docs.sgml:135: element include: XInclude error : could not load ../xml/e-book-client-cursor.xml, 
and no fallback was found
    ../eds-docs.sgml:1945: element refsect2: validity error : ID CLIENT-BACKEND-PROPERTY-CAPABILITIES:CAPS 
already defined
    ../eds-docs.sgml:1951: element refsect2: validity error : ID BOOK-BACKEND-PROPERTY-REQUIRED-FIELDS:CAPS 
already defined
    ../eds-docs.sgml:1957: element refsect2: validity error : ID BOOK-BACKEND-PROPERTY-SUPPORTED-FIELDS:CAPS 
already defined
    ../xml/e-data-book-cursor.xml:157: parser error : Opening and ending tag mismatch: programlisting line 
151 and para
         gint i;</para>
                       ^
    ../xml/e-data-book-cursor.xml:160: parser error : StartTag: invalid element name
         for (i = 0; i < cursor->n_sort_fields; i++) {</para>
                        ^
    ../xml/e-data-book-cursor.xml:174: parser error : Sequence ']]>' not allowed in content
    <para>     state->last_uid = e_contact_get (contact, E_CONTACT_UID);
          ^
    ../xml/e-data-book-cursor.xml:174: parser error : Sequence ']]>' not allowed in content
    ]]></programlisting>
    ^
    ../xml/e-data-book-cursor.xml:174: parser error : internal error: detected an error in element content
    ]]></programlisting>
    ^
    ../xml/e-data-book-cursor.xml:174: parser error : Extra content at the end of the document
    ]]></programlisting>
    ^