gtk2/docs
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
..
reference Allow binding GdkContentFormatsBuilder 2018-02-03 16:24:13 +01:00
tools toolpalette: Remove 2018-02-03 11:52:37 +01:00
CODING-STYLE docs: Update the coding style 2013-07-09 09:30:02 +01:00
developers.txt Substitute gtk_widget_ref/unref with g_object_ref/unref 2009-10-14 03:30:57 +02:00
dnd_internals.txt Use g_object_ref/unref instead deprecated gdk_*_ref/unref functions 2009-10-14 03:13:52 +02:00
focus_tracking.txt Apply a cleanup patch by Kjartan Maraas (#341812) 2006-10-08 05:07:55 +00:00
iconcache.txt Update spec. 2005-03-15 13:18:25 +00:00
RELEASE-HOWTO.md docs: Update references to Meson CLI utilities 2017-08-15 14:08:57 +01:00
sizing-test.txt Completely remove any use of GtkWindow allow-grow and allow-shrink properties 2010-08-07 17:19:16 +02:00
styles.txt Remove remaining GtkWindow deprecated documentation 2010-05-03 01:49:50 +02:00
text_widget_internals.txt add a file documenting some of the text widget internals 2003-01-04 03:07:14 +00:00
tree-column-sizing.png constrain cell area to passed in cell_area, #147867 2004-08-31 21:15:51 +00:00
tree-column-sizing.txt update a little 2002-02-04 19:30:00 +00:00
widget_geometry.txt Add a note about the !CAN_FOCUS quirk in the button size allocation code. 2004-06-05 03:58:50 +00:00
widget_system.txt Add invariant that a child is unmapped if parent is unmapped 2010-12-20 12:58:04 -05:00