Drop the gtk-doc SECTION markers, and move documentation to classes or
separate documents.

The syntax is "Deprecated: version: message".

The relative links in the functions documentation stanza refer to the
current section; this means that, in order to refer to an anchor
specified in a section the symbols must be in the same section within
the same file.

To calculate the rowstride without allocating memory!

https://bugzilla.gnome.org/show_bug.cgi?id=765094

Philip Withnall authored Jan 07, 2017 and Philip Withnall committed Jan 10, 2017

That one moved to gdk-pixbuf-xlib a while ago.

https://bugzilla.gnome.org/show_bug.cgi?id=442452

Christoph Reiter authored Oct 31, 2016 and Christoph Reiter committed Nov 07, 2016

(and as a side effect make the gi bindings API compatible with
other platforms)

The compat code was added in
https://git.gnome.org/browse/gdk-pixbuf/commit/?id=141506eb46927eb10b74bc24727488bdbde1c7d4
to allow switching to utf-8 paths while keeping binary compatibility and to
make new programs link against the "_utf8" variants.

This results in two problems for gi bindings:
(1) g-ir-scanner can't find the annotations due to the renames and thus
    gdk_pixbuf_savev() can't be used in bindings (the other functions happen to
    work with default annotations)
(2) g-ir-scanner will write the renamed functions in the gir/typelib with
    the "_utf8" suffix, making the resulting bindings API incompatible with other
    platforms.

Some months ago
https://git.gnome.org/browse/gdk-pixbuf/commit/?id=6855a2d806b2305938abc04b0cb4fa383f8ccd3b
got rid of symbol files, breaking ABI and old binaries.

This patch removes the, now unused, codepage code and removes the renames so that
new code links against the real functions again. To not break recent binaries
add new functions with the _utf8 suffix which just call the main functions.
Annotations are copied as well to not break bindings API.

A similar change in glib was commited some years ago
https://git.gnome.org/browse/glib/commit/?id=8c42a663f8182f8281c083390aa761e8e9badc63

https://bugzilla.gnome.org/show_bug.cgi?id=773760

Bastien Nocera authored Jun 26, 2016 and Matthias Clasen committed Aug 02, 2016

Not just in loaders.

https://bugzilla.gnome.org/show_bug.cgi?id=768043

Bastien Nocera authored Jun 25, 2016 and Matthias Clasen committed Aug 02, 2016

https://bugzilla.gnome.org/show_bug.cgi?id=768043

Bastien Nocera authored Jun 25, 2016 and Matthias Clasen committed Aug 02, 2016

https://bugzilla.gnome.org/show_bug.cgi?id=768043

Add a version macro header that would reveal the availability of the
various APIs, which is used to  indicate what stable release series an
API is available, and what release series is an API deprecated.  This
is also used to export the symbols using compiler directives, which
would eliminate the need to maintain .symbols files.

Annotate the symbols in the pubic headers accordingly, and update the
doc sections file so that the macros are included in the documentation.

https://bugzilla.gnome.org/show_bug.cgi?id=767164

Cosimo Cecchi authored Aug 30, 2012 and Cosimo Cecchi committed Apr 06, 2016

This is useful when the set of options you want to use changes according
to specific conditions, and makes the stream-based API consistent with
the others.

https://bugzilla.gnome.org/show_bug.cgi?id=683063

When using progressive loading, the GIF loader seems to expect us to
load every single frame of the image before being "done". That's really
not the case when thumbnailing, as we only want the first frame in that
case.

Return the GDK_PIXBUF_ERROR_INCOMPLETE_ANIMATION error when not all the
frames have been decoded, so that users of the API can ignore it, like
gnome-desktop's thumbnailer.

https://bugzilla.gnome.org/show_bug.cgi?id=755672

So people don't have to guess the possible values of "key" in
gdk_pixbuf_get_option() calls

https://bugzilla.gnome.org/show_bug.cgi?id=674858

Colin Walters authored Jul 14, 2014 and Matthias Clasen committed Jul 18, 2014

This can be convenient for language bindings to access the readonly
data in a form that includes length, and also avoids a copy (for
readonly pixbufs).

https://bugzilla.gnome.org/show_bug.cgi?id=732297

Colin Walters authored Jul 05, 2014 and Matthias Clasen committed Jul 18, 2014

GdkPixbuf is an old API that predates introspection and GBytes.  It
has some confusion around whether or not pixbuf data is mutable or
not.  The _new_from_data() API takes a *const* pointer, but it's not
copied, and _get_pixels() returns a non-const copy of the same
pointer.

There are several cases where we get read-only data, such as a
GResource.  For language bindings, _new_from_data() doesn't work
because the array may be a temporary copy only allocated for the call.

In order to support a clean _new_from_bytes() API, we need to add the
concept of a read-only pixbuf into the core.  The fundamental hack
here is that _get_pixels() now causes an implicit copy.

For the cases where we don't want to copy, add a new
gdk_pixbuf_read_pixels() that returns a proper const pointer.

https://bugzilla.gnome.org/show_bug.cgi?id=732297

It does not get expanded anymore; lets just say gdk-pixbuf.

gcc has optimizations for include guards that only work
if they are outermost in the the header.
https://bugzilla.gnome.org/show_bug.cgi?id=689810

Reported by Evan Nemerson in bug 659888.

Jasper St. Pierre authored Oct 06, 2011 and Matthias Clasen committed Dec 16, 2011

Binary data needs an explicit length to be useful. Add a new API for
getting length of binary data, and allow gi users to use "get_pixels"
in a useful manner instead of just grabbing the first pixel.

https://bugzilla.gnome.org/show_bug.cgi?id=662009

gtk-doc gets confused by the win32 compat _utf8 defines.
So, hide those from it.
Bug https://bugzilla.gnome.org/show_bug.cgi?id=663554

This puts all the docs that existed in tmpl files when
gdk-pixbuf was moved out of gtk into inline comments.

Fixes: https://bugzilla.gnome.org/show_bug.cgi?id=635643

Philip Withnall authored Dec 10, 2010 and Bastien Nocera committed Dec 10, 2010

Add async versions of gdk_pixbuf_new_from_stream
and gdk_pixbuf_new_from_stream_at_scale.

https://bugzilla.gnome.org/show_bug.cgi?id=575900

Grudgingly, in the name of API stability.

Grudgingly, in the name of api stability.

Michael Natterer authored Oct 21, 2009 and Javier Jardón committed May 03, 2010

...and disallow inclusion of individual files unconditionally.

2008-05-28  Michael Natterer  <mitch@imendio.com>

	* gdk-pixbuf.h: define GDK_PIXBUF_H_INSIDE around including all
	other headers.

	* gdk-pixbuf-animation.h
	* gdk-pixbuf-core.h
	* gdk-pixbuf-enum-types.h.template
	* gdk-pixbuf-features.h.in
	* gdk-pixbuf-io.h
	* gdk-pixbuf-loader.h
	* gdk-pixbuf-simple-anim.h
	* gdk-pixbuf-transform.h: add single-include guards that #error
	out if GDK_PIXBUF_DISABLE_SINGLE_INCLUDES is defined and any of
	these files is included individually.

	* gdk-pixbuf-private.h: don't incude "gdk-pixbuf-io.h".

	* gdk-pixbuf-csource.c: #define __GTK_H_INSIDE__ around including
	"../gtk/gtkversion.h". Ugly but needed in this special case.


svn path=/trunk/; revision=20214

svn path=/trunk/; revision=19373

2007-07-02  Matthias Clasen <mclasen@redhat.com>

        * gdk-pixbuf.c (gdk_pixbuf_get_option): Document the
        "orientation" option.

        * gdk-pixbuf.symbols:
        * gdk-pixbuf-core.h:
        * gdk-pixbuf-util.c (gdk_pixbuf_apply_embedded_orientation):
        New function to handle Exif orientation information in
        tiff and jpeg images.  (#439567, Michael Chudobiak)


svn path=/trunk/; revision=18340

2005-03-10  Tor Lillqvist  <tml@novell.com>

	* gdk-pixbuf-core.h
	* gdk-pixbuf-io.c
	* gdk-pixbuf.symbols: Implement DLL ABI stablility for
	gdk_pixbuf_save() and gdk_pixbuf_savev(). (#167973)

2005-03-08  Matthias Clasen  <mclasen@redhat.com>

	* gtk/gtkwidget.h:
	* gtk/gtktreeview.h:
	* gtk/gtktreeviewcolumn.h:
	* gtk/gtktextbuffer.h:
	* gtk/gtkobject.h:
	* gtk/gtkfilechooserdialog.h:
	* gtk/gtkdialog.h:
	* gtk/gtkcontainer.h:
	* gtk/gtkcelllayout.h:
	* gtk/gtkaboutdialog.h: Use G_GNUC_NULL_TERMINATED where
	appropriate.  (#165682, Marc Meissner)

2004-12-05  Tor Lillqvist  <tml@iki.fi>

	* gdk-pixbuf-animation.c
	* gdk-pixbuf-io.c
	* io-xbm.c
	* io-xpm.c
	* make-inline-pixbuf.c
	* queryloaders.c: Use gstdio wrappers. Document that file names
	are in the GLib file name encoding.

	* gdk-pixbuf-csource.c
	* queryloaders.c: On Windows, convert command line arguments and
	environment variable values from locale encoding to UTF-8.

	* queryloaders.c: On Windows, use wide character API when
	available.

	* Makefile.am
	* gdk-pixbuf-core.h
	* gdk-pixbuf-io.c
	* gdk-pixbuf-animation.h
	* gdk-pixbuf-animation.c: Like in GLib, for DLL ABI stability on
	Windows, add binary compatibility versions of functions that take
	file names as arguments. They use the system codepage, not GLib
	file name encoding (which is UTF-8 on Windows). Use #defines to
	make newly compiled code use the "real" functions that use the
	GLib file name encoding scheme.