perf: Use a temp window instead of a normal one

This way, we don't need hacks to not set the background.

API: Remove APIs to generate pixmaps from pixbufs

The 3 functions in question were:
- gdk_pixbuf_render_threshold_alpha()
- gdk_pixbuf_render_pixmap_and_mask()
- gdk_pixbuf_render_pixmap_and_mask_for_colormap()

All of them can be replaced using Cairo if they have to. The
functionality is only needed to talk to old X interfaces and normal apps
do fine without them.

x11: Set the icon using Cairo

No more GdkPixmap to store the icon and its mask, but instead use cairo
surfaces. Also render the icon into the surfaces using Cairo instead of
gdk_pixbuf_render_threshold_alpha().

API: Change offscreen windows to use a cairo_surface_t

This requires changes to all the offscreen surface getters that used to
return a GdkPixmap before.

gdk: Use surfaces for double buffering

Don't use pixmaps anymore. Also use subsurfaces for implicit paints and
correcly set device offsets.

gdk: Make csw windows have their own cairo surface

With Cairo 1.10 now having cairo_surface_create_for_rectangle(), we can
use them. No need to create multiple native surfaces for the same X
window (ugh) anymore.

API: Remove gdk_window_get_internal_paint_info()

This function should not exist in public API, it exposes too many
internals.

gdk: offscreen window source drawable now is the root window

As the source drawable is only used for creating pixmaps these days, we
don't have to keep a real drawable around, but can just use the root
window.

gdk: Create surfaces directly, not from the source drawable

The notion of a source drawable does not make a lot of sense for windows
that are not backed by a drawable, such as GdkOffscreenWindow after
converting it to cairo_surface_t.

gdk: Remove gdk_windowing_create_cairo_surface()

Instead, actually use the create_cairo_surface vfunc on the
implementation drawable. D'oh.

dnd: Replace last pixmap usage with cairo surfaces.

API: image: Remove ability to set image from a pixmap

API: Remove the ability to set the dnd icon from a pixmap

tests: Convert testinput to use cairo_surface_t

gdk: Remove gdk_window_redirect_to_drawable()

Also remove the reverse gdk_window_remove_redirection().

The code was only used by the snapshotting code, and that code is dead
now.

testoffscreen: Remove unused code

API: Remove gtk_widget_get_snapshot()

It will be replaced with gtk_widget_draw().

testgtk: Remove snapshot test

gtk_widget_get_snapshot is on its way out.

The test can be added back once we have gtk_widget_draw(), but until
then, there's no way to take snapshots.

ruler: Make the backing store use a surface

API: make gtk_icon_view_create_drag_icon() return a cairo_surface_t

GdkPixmap is going to die!

API: make gtk_tree_view_create_row_drag_icon() return a cairo_surface_t

GdkPixmap is going to die!

treeview: Convert GtkTreeViewColumn rendering to Cairo

iconview: Port to Cairo rendering

cellview: Port to Cairo rendering

API: Add gtk_cell_renderer_render_cairo()

It's like gtk_cell_renderer_render(), just cooler.

API: Change cellrenderer->render vfunc to take a cairo_t

Also constify the rectangle arguments. They were const anyway.

testview: Convert _gtk_text_util_create_rich_drag_icon() to use surfaces

textview: API: change gtk_text_layout_draw() to take a cairo_t

This simplifies the API a lot and allows more magic to happen later.

API: Add gtk_cairo_draw_insertion_cursor()

For now just add it instead of replacing the current function. In the
end, this one should probably be renamed to
gtk_draw_insertion_cursor() and the current
gtk_draw_insertion_cursor() should die.

text: Make _gtk_text_util_create_drag_icon() return a surface

And change its callers to handle it that way.

API: Add gtk_drag_set_icon_surface()

The function is supposed to replace gtk_drag_set_icon_pixmap().

menu: set tearoff background using new background API

Use gdk_window_set_background_pattern() to set parent-relative bakground

iconview: No need to set background

style: Rewrite background handling to use cairo_pattern_t

trayicon: Use new gdk_window_set_background_pattern() API

gtk: Remove calls that try to set GDK_NO_BG on their windows

These calls aren't necessary anymore.

gdk: Rewrite background handling

Now the window background is a cairo_pattern_t. The backends will try to
set this as good as they can on the windowing system, but no guarantees
are made on wether the windowing system supports the pattern.

Also gets rid of GDK_NO_BG as undefined behavior is not a good idea to
support, and GDK_NO_BG effectively made the window's contents undefined.
It wasn't effectively used in GTK anyway.

gdk: Remove supports_native_bg on WindowImplIface

This will not be TRUE for anything anymore, once we fix background
handling.

gdk: Remove send_expose event from gdk_window_clear_region_internal()

It's always FALSE.

gdk: Remove GdkWindowImpl->clear_region

It was only used on the X11 backend and is easier to implement locally,
in particular when we want to allow backgrounds that X can't handle.

gdk: Simplify clear_area code

No more use for a gdk_window_clear_area_internal() function as there's
just one caller.

API: Remove gdk_window_clear_area_e()

Awesome name for a function. Plus, it's unused and its functionality can
easily be replicated.

gdk: Don't use clear_area_e() in offscreenwindow

Instead, call gdk_window_invalidate_rect() ourselves.

gdk: Remove _gdk_windowing_get_shape_for_mask()

It's unused. And there's a replacement available with
gdk_cairo_region_create_from_surface()

API: Remove shape_combine_mask functions from gdk

This removes gdk_window_shape_combine_mask() and
gdk_window_input_shape_combine_mask(). GdkBitmap is going away and a
replacement exists via the combine_region() functions and
gdk_cairo_region_create_from_surface().

widget: shape_combine_mask => shape_cobine_region

Replace gtk_widget_shape_combine_region() with
gtk_widget_shape_combine_mask() and
gtk_widget_input_shape_combine_region() with
gtk_widget_input_shape_combine_mask().
As GdkBitmap is going away, and the region equivalents already exist,
this seems like pretty much the default step to take.

Includes code to fix up the users.

treeview: Port to gdk_window_shape_combine_region()

gdk_window_shape_combine_mask() is going away. It's using a GdkPixmap
and falls back to gdk_window_shape_combine_region() anyway.

API: Add gdk_cairo_region_create_from_surface()

The function converts the given surface into an alpha bitmap mask. This
is mostly useful for setting shape regions.

Also adds a new internal function _gdk_cairo_surface_extents() that
computes a surface's extents.

API: Remove gdk_cursor_new_from_pixmap()

gdk_cursor_new_from_pixbuf() is the proper replacement.

colorsel: Use gdk_cursor_new_from_pixbuf() to create the cursor

gdk_cursor_new_from_pixmap() is about to die.

API: remove gdk_window_set_icon()

gdk_window_set_icon_list() now does everything gdk_window_set_icon()
used to do.

testgtk: Convert WM hints example to use gdk_window_set_icon_list()

gdk_window_set_icon() is about to go away.

Also removes the circles.xbm file and uses the oncluded openfile logo
instead.

window: Remove call to gdk_window_set_icon()

Also remove all the functions taking care of it. This is now handled by
the X11 backend directly. And the other backends ignored this function
anyway.

x11: remove icon_window property, it's not used anymore

x11: Set icon based on icon list

Basically copies the code for setting the WM icon hint from GtkWindow to
GdkWindow. This achieves the following:
- Putting this X11 specific code into the X11 backend
- Enables removal of gdk_window_set_icon()
- Gets rid of Pixmap/Bitmap usage outside of GDK.

pixbuf-engine: remove unused theme_pixbuf_render_no_cairo()

style: Convert draw_spinner vfunc to Cairo version

style: Convert draw_resize_grip vfunc to Cairo version

Includes removal of now unused draw_simple_image_no_cairo() function
from pixbuf engine.

style: Convert draw_layout vfunc to Cairo version

style: Convert draw_expander vfunc to Cairo version

style: Convert draw_handle vfunc to Cairo version

style: Convert draw_slider vfunc to Cairo version

style: Convert draw_focus vfunc to Cairo version

style: Convert draw_extension vfunc to Cairo version

style: Convert draw_box_gap vfunc to Cairo version

Includes removal of now unused draw_gap_image_no_cairo() function from
pixbuf theme engine.

style: Convert draw_shadow_gap vfunc to a Cairo version

style: Convert draw_tab vfunc to Cairo version

style: Convert draw_option vfunc to Cairo version

style: Convert draw_check vfunc to Cairo version

style: Convert draw_flat_box vfunc to Cairo version

style: Convert draw_shadow vfunc to Cairo version

style: Convert draw_vline vfunc to a Cairo version

style: Convert draw_hline vfunc to Cairo version

API: change gtk_style_apply_default_background()

It now takes a cr to apply the default background to. And it no longer
takes a set_bg parameter

pixbuf-engine: Add Cairo version for draw_gap_image()

pixbuf-engine: Add Cairo version for draw_simple_image()

pixbuf-engine: Make theme_pixbuf_render take a cairo_t

This is in preparation for the theme engine switch to Cairo. We keep the
old function around so that we can step-by-step upgrade all the vfuncs.

pixbuf-engine: Get rid of unused mask argument

notebook: Fix compilation warnings

A quark is not a pointer.

menu: Remove unused variable

GtkScrolledWindow: document changed default policy

Nuke the 'Types' section from the docs

Remove mention of input dialog from the docs

GtkOffscreenWindow: shorten doc title

GtkScale: Remove links from doc section title

GtkMenu: Add a destroy notify to gtk_menu_popup_for_device

This is necessary so language bindings can use gtk_menu_popup_for_device()
as a 'full' variant of gtk_menu_popup().

http://bugzilla.gnome.org/show_bug.cgi?id=623664

Update docs of GtkAboutDialog and GtkLinkButton

Remove references to global hooks from the docs. Also move remaining
docs inline, and remove the templates.

DND: don't use uninitialized memory

The dest_x/y members of GtkDragDestInfo were not initialized.
At the same time, switch some of the small temporary structs
to g_slice allocation.

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

GtkAboutDialog: correct a since tag

gtkeditable: move documentation to inline comments

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

introspection: Fix typo in annotation

Don't try to unref event->dnd.context unconditionally.

As it's not set in gdk_event_new but eventually later.

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

GtkAboutDialog: escape mail addresses

This got lost when converting to the ::activate-link signal.

Remove gtk_notebook_set_window_creation_hook in testnotebookdnd.c

Another since tag

Correct since tags

GtkNotebook: replace group by group_name

Dealing with bare pointers is problematic for language bindings,
using interned strings is much more straightforward and more than
good enough for what is needed here.

http://bugzilla.gnome.org/show_bug.cgi?id=630521

GtkNotebook: remove gtk_notebook_set_window_creation_hook

http://bugzilla.gnome.org/show_bug.cgi?id=630521

docs: Add a CODING-STYLE document

This document mostly codifies the existing GTK+ coding style
conventions; it is strongly based on the clutter document of
the same name.