[Github-comments] [geany] Gtkdoc hdr (#890)

Thomas Martitz notifications at xxxxx
Tue Feb 16 14:53:04 UTC 2016


Am 11.02.2016 um 19:45 schrieb Colomban Wendling:
>
> I believe there are a lot of transfer annotations that aren't needed, 
> and in most case natural to the reader. In such case, I guess I'd 
> rather leave them out.
>
>

@b4n Which ones? I only added them where needed, that is basically all 
non-const returns of struct pointers (otherwise g-ir-scanner throws 
warnings like this:
 > Geany: editor_create_widget: return value: Invalid non-constant 
return of bare structure or union; register as boxed type or (skip)

The only superflous annotation was for stash_group_new(). I dropped 
that. However, IMO the transfer annotations are very valuable for the 
html/pdf docs to and probably shouldn't be dropped either way.

@codebrainz The updated patch set incorporates your changes.


---
Reply to this email directly or view it on GitHub:
https://github.com/geany/geany/pull/890#issuecomment-184712949
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.geany.org/pipermail/github-comments/attachments/20160216/308f8ca6/attachment.html>


More information about the Github-comments mailing list