Skip to content
  • Emmanuele Bassi's avatar
    Update rcbox annotations for acquire/release functions · 822b511c
    Emmanuele Bassi authored
    The accepted behaviour for reference counting functions can be described
    as such:
    
     - acquire: takes a pointer to a memory area and returns the same
       pointer with its reference count increased; this means that the
       returned value's ownership is fully transfered from the callee
       to the caller
     - release: takes a pointer to a memory area and drops the reference
       count; this means that the caller transfers the ownership of the
       argument to the callee
    
    These annotations are mostly meant for documentation purposes: high
    level language bindings are unlikely to use them, as they have their own
    reference counting semantics on top of GLib's own, and they should not
    expose this API to their own consumers.
    822b511c