[Github-comments] [geany/geany] api: rename document_new_file to _file_new (and girskip the older one) (#1094)

[Thomas Martitz]

No, when that annotation is applied the function is already determined to be a constructor. In addition, the target function must exist. The primary use case is renaming a _full function to the non-_full one, perhaps because the non-_full one is incompatible (e.g if the _full one adds a destroy notify which is often required to be gir compatible). The non-_full one is effectively shadowed.

I also strongly favor to keep the C api and GIR bindings  in sync/the same rather than manifesting subtle differences. The point is getting the GIR bindings for free (as a side effect) without manual maintenance for every other symbol. The above use case for rename-to is a valid exception though IMO.


---
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/geany/geany/pull/1094#issuecomment-228949672
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.geany.org/pipermail/github-comments/attachments/20160627/3e73bffa/attachment.html>