Skip to content
  • Jehan's avatar
    Issue #5946: skip gimp_*get_*() API from GObject Introspection. · 15ec2541
    Jehan authored
    The get() API are sometimes nicer in C code because it's just simpler to
    loop through C arrays, but they end up with similar API to the list()
    variants for binding, or with a useless size return value (since most
    higher level languages have length-aware array types, which is what
    GList are transformed into).
    
    So let's use the list() variants as the main ones and skip the get()
    variants. I hesitated to rename the list() variants to get() with
    `(rename-to)` annotations but since I am unsure if the get() bindings
    are absolutely useless, I don't think it's the best idea. Maybe on some
    other language usable as GI binding, the get() variant might be
    different again and nicer to use. So if we shadowed these by renaming
    list() ones, the day we change our mind, we'd have to rename get() ones
    too (which would be very confusing), or else break bindings' API. To
    avoid this, I just skip the get() ones altogether in bindings but leave
    their name available ...
    15ec2541