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

[elextr]

> The members are part of the ABI, that's a fact and can't be argue away with conventions. 

Gotta agree with @codebrainz that members that should never be accessed, are not part of the guaranteed stable ABI, API or AFI.  If a user *DOES THE WRONG THING* and accesses them because the compiler lets them, tough if it breaks.  

We recently "broke" the whole interface by making formerly leaked functions that were not supposed to be used unavailable.  That the user can currently misuse something is not a reason for making it part of the stable interface.

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