Strange (for me) warnings during doc generating

[Gergely Polonkai <gergely polonkai eu>]

Hello,

when genering docs for my project (https://github.com/gergelypolonkai/matrix-glib-sdk), I get some strange warnings (line numbers refer to the commit 8d95dd913cbc3fff4475b85a123bed636cc87739 which I conveniently tagged with the gtk-doc-questions tag):

    html/matrix-glib-sdk-MatrixAPI.html:1279: warning: no link for: "MatrixAPI--token" -> (<span class="type">“token”</span>).

This one is referring to a property of an interface which is documented at matrix-api.c:2132.  The property also isn’t listed in the generated HTML documents.

    html/matrix-glib-sdk-MatrixClient.html:332: warning: no link for: "MatrixClient-login-finished" -> (<span class="type">“login-finished”</span>).

    html/matrix-glib-sdk-MatrixClient.html:505: warning: no link for: "MatrixClient-event" -> (<span class="type">“event”</span>).

The above lines refer to signals of an interface and are documented at matrix-client.c:375 and matrix-client.c:394, respectively.  The signals also aren’t listed in the generated HTML documents.

    html/matrix-glib-sdk-MatrixMessageBase.html:379: warning: no link for: "MatrixMessageBase--json" -> (<span class="type">“json”</span>).

This one a property of an abstract class, and is documented at matrix-message-base.c:561.  Again, the property also doesn’t show up in the HTML documents.

    html/matrix-glib-sdk-MatrixRoom.html:875: warning: no link for: "MatrixRoom--default-state-level" -> (<span class="type">“default-state-level”</span>).

    html/matrix-glib-sdk-MatrixRoom.html:875: warning: no link for: "MatrixRoom--default-event-level" -> (<span class="type">“default-event-level”</span>).

These are properties of a regular GObject class (directly derived from GObject), and are documented at matrix-room.c:1474 and matrix-room.c:1487, respectively.  They also don’t show up in the generated HTML documents.

For the record, all of these interfaces/classes are assigned to a section, listed in matrix-glib-sdk-sections.txt, and their generated XML files are included in the main document (matrix-glib-sdk-docs.xml).  The warnings are also present if I start from a clean slate, ie. remove all the files except matrix-glib-sdk-sections.txt and matrix-glib-sdk-docs.xml.

Can anyone help me how can I get rid of these warnings?

Best,

Gergely