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
_______________________________________________
gtk-doc-list mailing list
gtk-doc-list@gnome.org
https://mail.gnome.org/mailman/listinfo/gtk-doc-list
