GNOME Bugzilla – Bug 144878
Too many warnings in gtk-doc generation
Last modified: 2017-12-22 12:45:32 UTC
The main reason is missing attribute description in gtk-doc comments. The most often is missing Return: description. But there are other issues, like that gtk-doc can't handle arguments like enum EnumType, but requires typedef and arguments EnumType. Also there is problem with different function attribute names in .h files and in .c files and many other.
Created attachment 28957 [details] [review] Patch Proposed patch fixes critical gtk-doc errors and starts to fix some warnings. It would be to hard to do all work with one patch, so I propose to start with that patch and then fix remaining part.
Patch looks fine, I gonna apply it (after reverting my changes I did today in the doc/reference directory )
Comment on attachment 28957 [details] [review] Patch The patch is in
Let us when you are ready for the remaining part. BTW: thanks again!
Created attachment 28987 [details] [review] Second part Large patch to fix the rest.
Thanks - I've committed attachment 28987 [details] [review]
Bug 123318 was also about gtk-doc comments. (this entry is only a cross-reference to that bugreport)
Conglomerate is not under active development anymore. It is currently unlikely that there will be any further Conglomerate development. Closing this report as WONTFIX as part of Bugzilla Housekeeping (bug 685689) to reflect reality. Please feel free to reopen this bug report in the future if anyone takes the responsibility for active development again.