[Github-comments] [geany] doxygen: various doxygen-related fixes in preparation for gtkdoc generation (302b40e)

Thomas Martitz notifications at xxxxx
Thu Dec 17 10:27:26 UTC 2015


The size always matters if the struct layout is fully visible. You can always copy from pointer to local variable. From an API perspective, it just means we can usually append to such structs without causing damage downstream (compiled binaries only copy up to the size at compile time). It does *not* mean we can remove from the end or change stuff there.

As for the separate doxyfile. Yes, I absolutely do not want one that gives all, even undocumented symbols, because that means that stuff lands in the gir which totally shouldn't be there (think of all the FooPrivate structs). There is only EXRACT_ALL and so I can chose between everything and everything documented. Everything is far too much to be remotely useful. With just everything documented the gir generation can be completely automated, i.e. no extra maintainance burden (just keep the doxygen comments in good conditional, as always).

---
Reply to this email directly or view it on GitHub:
https://github.com/geany/geany/commit/302b40e9778ff49407902f3ef9f272ed202f4547#commitcomment-15038019
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.geany.org/pipermail/github-comments/attachments/20151217/7d018730/attachment.html>


More information about the Github-comments mailing list