gtk2/docs/reference/gdk
Emmanuele Bassi 2cbe094b91 Allow binding GdkContentFormatsBuilder
GdkContentFormatsBuilder is currently not introspectable, as it does not
have a GType. We can turn it into a boxed type, but we need to implement
memory management for it.

The current gdk_content_formats_builder_free() function returns a newly
constructed value, so we cannot use it as a GBoxedFreeFunc; additionally
copying a GdkContentFormatsBuilder contents would make it a bit odd, as
you could get multiple identical GdkContentFormats out of the copies.

A simple approach is to model the GdkContentFormatsBuilder API to follow
the GBytes one: use reference counting for memory management, and have
a function to release a reference, return a GdkContentFormats, and reset
the GdkContentFormatsBuilder state.

For language bindings, we can provide a get_formats() function that
returns the GdkContentFormats instance and resets the builder instance,
leaving the reference count untouched.

For C convenience we can keep gdk_content_formats_builder_free(), and
make it a wrapper around gdk_content_formats_builder_get_formats(), with
the guarantee that it'll free the builder instance regardless of its
current reference count.

https://bugzilla.gnome.org/show_bug.cgi?id=793097
https://blogs.gnome.org/otte/2018/02/03/builders/
2018-02-03 16:24:13 +01:00
..
images docs: Remove unused images 2018-01-04 15:26:52 -05:00
gdk4-docs.xml gdk: Slight doc rearrangement 2017-12-26 14:39:49 -05:00
gdk4-overrides.txt docs: Rename files to match type and version 2017-05-03 15:10:56 +01:00
gdk4-sections.txt Allow binding GdkContentFormatsBuilder 2018-02-03 16:24:13 +01:00
gdk4.types Add new stuff to the gdk docs 2017-12-04 10:32:17 -08:00
meson.build gdk: Convince gtk-doc to include backend docs 2018-01-04 15:57:28 -05:00
version.xml.in