2.9.0

ChangeLog

 2006-05-04  Matthias Clasen  <mclasen@redhat.com>
 
+	* configure.in: Bump version
+
 	* === Released 2.9.0 ===
 
 	* configure.in: Require cairo 1.1.6

ChangeLog.pre-2-10

 2006-05-04  Matthias Clasen  <mclasen@redhat.com>
 
+	* configure.in: Bump version
+
 	* === Released 2.9.0 ===
 
 	* configure.in: Require cairo 1.1.6

INSTALL

@@ -18,8 +18,8 @@ GTK+ requires the following packages:
 Simple install procedure
 ========================
 
-  % gzip -cd gtk+-2.8.2.tar.gz | tar xvf - # unpack the sources
-  % cd gtk+-2.8.2			   # change to the toplevel directory
+  % gzip -cd gtk+-2.9.0.tar.gz | tar xvf - # unpack the sources
+  % cd gtk+-2.9.0			   # change to the toplevel directory
   % ./configure				   # run the `configure' script
   % make				   # build GTK
   [ Become root if necessary ]

Makefile.am

@@ -191,5 +191,4 @@ sanity:
 snapshot:
 	$(MAKE) dist distdir=$(PACKAGE)-snap`date +"%Y%m%d"`
 
-
-DISTCHECK_CONFIGURE_FLAGS = --enable-gtk-doc
+DISTCHECK_CONFIGURE_FLAGS = --enable-gtk-doc --enable-man --disable-rebuilds

NEWS

@@ -37,6 +37,8 @@ Overview of Changes from GTK+ 2.8.x to 2.9.0
     modules, such as theme engines, input method modules or pixbuf loaders 
     have to be rebuilt so that they are installed in the right place
     for GTK+ to find them.
+  - The location entry (popped up by C-L) has been integrated in the
+    main dialog.
     
 * Reworked hex Unicode input now requires Ctrl-Shift-U
 

README

 General Information
 ===================
 
-This is GTK+ version 2.8.2. GTK+ is a multi-platform toolkit for
+This is GTK+ version 2.9.0. GTK+ is a multi-platform toolkit for
 creating graphical user interfaces. Offering a complete set of widgets,
 GTK+ is suitable for projects ranging from small one-off projects to
 complete application suites.
@@ -25,6 +25,47 @@ Installation
 
 See the file 'INSTALL'
 
+Release notes for 2.10
+======================
+
+* The hexadecimal Unicode input feature has been reworked. It no longer
+  blocks the use of the sixteen Ctrl-Shift-<hex digit> key sequences. Now
+  it only uses Ctrl-Shift-u.
+
+* A memory leak in GtkStyle handling has been fixed. This may expose bugs
+  in third-party widgets which forget to call gtk_style_attach() in their
+  realize functions.
+
+* Range widgets like GtkScrollbar now render their arrows insensitive
+  when the slider is at the end. Applications which react to arrow
+  clicks even if the slider is at the end may want to use the new
+  gtk_range_set_[upper/lower]_stepper_sensitivity() functions to
+  prevent the arrows from being rendered insensitive.
+
+* GtkObject now uses the "floating reference" support in GObject. 
+  GTK_OBJECT_IS_FLOATING() will still work, but direct checking
+  of the GTK_FLOATING flag will no longer detect the floating 
+  reference. Details about floating references can be found in the docs:
+  http://developer.gnome.org/doc/API/2.0/gobject/gobject-The-Base-Object-Type.html#floating-ref
+
+* Suffixes like (_F) are now stripped from labels when they are displayed
+  in toolbars. If this is not wanted, the feature can be suppressed by 
+  inserting a Unicode control character, e.g ZWNJ.
+
+* The pixbuf theme engine can now customize expanders (in GtkTreeView
+  and GtkExpander) and resize grips, using the new EXPANDER and
+  RESIZE_GRIP function values.
+
+* Dialogs created by gtk_about_dialog_new no longer hide automatically
+  when the user clicks close. It is the applications responsibility to
+  hide or destroy the dialog.
+
+* Several new signals have been added to GtkNotebook. Care has been taken
+  to choose signal names which do not collide with signals added by well-known
+  derived classes. The names which can no longer be used for signals in 
+  objects derived from GtkNotebook are page-reordered, page-removed and
+  page-added.
+
 Release notes
 =============
 

configure.in

@@ -12,10 +12,10 @@ AC_PREREQ(2.54)
 
 m4_define([gtk_major_version], [2])
 m4_define([gtk_minor_version], [9])
-m4_define([gtk_micro_version], [0])
+m4_define([gtk_micro_version], [1])
 m4_define([gtk_version],
           [gtk_major_version.gtk_minor_version.gtk_micro_version])
-m4_define([gtk_interface_age], [0])
+m4_define([gtk_interface_age], [1])
 m4_define([gtk_binary_age],
           [m4_eval(100 * gtk_minor_version + gtk_micro_version)])
 # This is the X.Y used in -lgtk-FOO-X.Y

contrib/gdk-pixbuf-xlib/ChangeLog

+2006-05-04  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.9.0 ===
+
 2005-11-17  Matthias Clasen  <mclasen@redhat.com>
 
 	* gdk-pixbuf-xlib-drawable.c: 

docs/reference/ChangeLog

+2006-05-04  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.9.0 ===
+
 2006-04-29  Matthias Clasen  <mclasen@redhat.com>
 
 	* gtk/gtk-sections.txt: Add gtk_status_icon_position_menu

docs/reference/gdk-pixbuf/tmpl/creating.sgml

@@ -95,9 +95,6 @@ Creating a pixbuf from image data that is already in memory.
 @copy_pixels: 
 @error: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@inline_pixbuf: 
-@length: 
 
 
 <!-- ##### FUNCTION gdk_pixbuf_new_subpixbuf ##### -->

docs/reference/gdk-pixbuf/tmpl/file-loading.sgml

@@ -66,8 +66,6 @@ End:
 @preserve_aspect_ratio: 
 @error: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@keep_aspect_ratio: 
 
 
 <!-- ##### FUNCTION gdk_pixbuf_get_file_info ##### -->

docs/reference/gdk/tmpl/cairo_interaction.sgml

@@ -56,6 +56,17 @@ Cairo paths and to use pixbufs as sources for drawing operations.
 @pixbuf_y: 
 
 
+<!-- ##### FUNCTION gdk_cairo_set_source_pixmap ##### -->
+<para>
+
+</para>
+
+@cr: 
+@pixmap: 
+@pixmap_x: 
+@pixmap_y: 
+
+
 <!-- ##### FUNCTION gdk_cairo_rectangle ##### -->
 <para>
 

docs/reference/gdk/tmpl/events.sgml

@@ -295,8 +295,6 @@ gdk_event_handler_set().
 @event: 
 @winid: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@xid: 
 
 
 <!-- ##### FUNCTION gdk_event_send_client_message_for_display ##### -->
@@ -308,8 +306,6 @@ gdk_event_handler_set().
 @event: 
 @winid: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@xid: 
 
 
 <!-- ##### FUNCTION gdk_event_send_clientmessage_toall ##### -->

docs/reference/gdk/tmpl/gdkdisplay.sgml

@@ -378,3 +378,21 @@ Applications should never have any reason to use this facility
 @n_targets: 
 
 
+<!-- ##### FUNCTION gdk_display_supports_shapes ##### -->
+<para>
+
+</para>
+
+@display: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_display_supports_input_shapes ##### -->
+<para>
+
+</para>
+
+@display: 
+@Returns: 
+
+

docs/reference/gdk/tmpl/gdkscreen.sgml

@@ -34,6 +34,13 @@ when GDK gets multihead support.
 
 @Since: 2.2
 
+<!-- ##### SIGNAL GdkScreen::composited-changed ##### -->
+<para>
+
+</para>
+
+@gdkscreen: the object which received the signal.
+
 <!-- ##### SIGNAL GdkScreen::size-changed ##### -->
 <para>
 
@@ -131,6 +138,15 @@ when GDK gets multihead support.
 @Returns: 
 
 
+<!-- ##### FUNCTION gdk_screen_is_composited ##### -->
+<para>
+
+</para>
+
+@screen: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_screen_get_root_window ##### -->
 <para>
 
@@ -238,8 +254,6 @@ when GDK gets multihead support.
 @screen: 
 @monitor_num: 
 @dest: 
-<!-- # Unused Parameters # -->
-@Returns: 
 
 
 <!-- ##### FUNCTION gdk_screen_get_monitor_at_point ##### -->
@@ -261,8 +275,6 @@ when GDK gets multihead support.
 @screen: 
 @window: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@anid: 
 
 
 <!-- ##### FUNCTION gdk_screen_broadcast_client_message ##### -->
@@ -321,6 +333,24 @@ when GDK gets multihead support.
 @dpi: 
 
 
+<!-- ##### FUNCTION gdk_screen_get_active_window ##### -->
+<para>
+
+</para>
+
+@screen: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_screen_get_window_stack ##### -->
+<para>
+
+</para>
+
+@screen: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_spawn_on_screen ##### -->
 <para>
 

docs/reference/gdk/tmpl/keys.sgml

@@ -167,8 +167,6 @@ be mapped to a keyval.
 @level: 
 @consumed_modifiers: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@unused_modifiers: 
 
 
 <!-- ##### FUNCTION gdk_keymap_get_entries_for_keyval ##### -->

docs/reference/gdk/tmpl/pixmaps.sgml

@@ -30,6 +30,7 @@ The type #GdkDrawable refers generically to any of
 these types.
 </para>
 
+@user_data: 
 
 <!-- ##### FUNCTION gdk_pixmap_new ##### -->
 <para>

docs/reference/gdk/tmpl/regions.sgml

@@ -70,9 +70,9 @@ Defines the position and size of a rectangle.
 
 </para>
 
-@src1:
-@src2:
-@dest:
+@src1: 
+@src2: 
+@dest: 
 
 
 <!-- ##### STRUCT GdkRegion ##### -->
@@ -97,6 +97,7 @@ A GdkRegion represents a set of pixels on the screen.
 @points: 
 @npoints: 
 @fill_rule: 
+@Returns: 
 
 
 <!-- ##### ENUM GdkFillRule ##### -->
@@ -141,8 +142,8 @@ included in the region, while areas overlapped an even number of times are not.
 
 </para>
 
-@region:
-@rectangle:
+@region: 
+@rectangle: 
 
 
 <!-- ##### FUNCTION gdk_region_get_rectangles ##### -->
@@ -161,6 +162,7 @@ included in the region, while areas overlapped an even number of times are not.
 </para>
 
 @region: 
+@Returns: 
 
 
 <!-- ##### FUNCTION gdk_region_equal ##### -->
@@ -170,6 +172,7 @@ included in the region, while areas overlapped an even number of times are not.
 
 @region1: 
 @region2: 
+@Returns: 
 
 
 <!-- ##### FUNCTION gdk_region_point_in ##### -->
@@ -177,9 +180,10 @@ included in the region, while areas overlapped an even number of times are not.
 
 </para>
 
-@region:
+@region: 
 @x: 
 @y: 
+@Returns: 
 
 
 <!-- ##### FUNCTION gdk_region_rect_in ##### -->
@@ -189,6 +193,7 @@ included in the region, while areas overlapped an even number of times are not.
 
 @region: 
 @rectangle: 
+@Returns: 
 
 
 <!-- ##### ENUM GdkOverlapType ##### -->
@@ -288,10 +293,10 @@ gdk_region_spans_intersect_foreach().
 </para>
 
 @region: 
-@spans:
-@n_spans:
+@spans: 
+@n_spans: 
 @sorted: 
-@function:
+@function: 
 @data: 
 
 

docs/reference/gdk/tmpl/threads.sgml

@@ -298,9 +298,6 @@ The #GMutex used to implement the critical region for
 gdk_threads_enter()/gdk_threads_leave(). 
 </para>
 
-@Deprecated: 2.4: This variable should not be used directly 
-  &mdash; consider it private.
-
 
 <!-- ##### FUNCTION gdk_threads_set_lock_functions ##### -->
 <para>

docs/reference/gdk/tmpl/windows.sgml

@@ -30,6 +30,7 @@ The type #GdkDrawable refers generically to any of
 these types.
 </para>
 
+@user_data: 
 
 <!-- ##### ENUM GdkWindowType ##### -->
 <para>
@@ -211,6 +212,12 @@ window types.
 @GDK_WINDOW_TYPE_HINT_DOCK: Used for creating dock or panel windows.
 @GDK_WINDOW_TYPE_HINT_DESKTOP: Used for creating the desktop background 
 window.
+@GDK_WINDOW_TYPE_HINT_DROPDOWN_MENU: 
+@GDK_WINDOW_TYPE_HINT_POPUP_MENU: 
+@GDK_WINDOW_TYPE_HINT_TOOLTIP: 
+@GDK_WINDOW_TYPE_HINT_NOTIFICATION: 
+@GDK_WINDOW_TYPE_HINT_COMBO: 
+@GDK_WINDOW_TYPE_HINT_DND: 
 
 <!-- ##### STRUCT GdkWindowAttr ##### -->
 <para>
@@ -896,6 +903,44 @@ backend, <type>MSG</type>s for Win32).
 @window: 
 
 
+<!-- ##### FUNCTION gdk_window_input_shape_combine_mask ##### -->
+<para>
+
+</para>
+
+@window: 
+@mask: 
+@x: 
+@y: 
+
+
+<!-- ##### FUNCTION gdk_window_input_shape_combine_region ##### -->
+<para>
+
+</para>
+
+@window: 
+@shape_region: 
+@offset_x: 
+@offset_y: 
+
+
+<!-- ##### FUNCTION gdk_window_set_child_input_shapes ##### -->
+<para>
+
+</para>
+
+@window: 
+
+
+<!-- ##### FUNCTION gdk_window_merge_child_input_shapes ##### -->
+<para>
+
+</para>
+
+@window: 
+
+
 <!-- ##### FUNCTION gdk_window_set_static_gravities ##### -->
 <para>
 

docs/reference/gdk/tmpl/x_interaction.sgml

@@ -280,6 +280,19 @@ Another name for GDK_DRAWABLE_XID().
 @Returns: 
 
 
+<!-- ##### FUNCTION gdk_pixmap_foreign_new_for_screen ##### -->
+<para>
+
+</para>
+
+@screen: 
+@anid: 
+@width: 
+@height: 
+@depth: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_window_foreign_new ##### -->
 <para>
 

docs/reference/gtk/gtk-docs.sgml

@@ -177,7 +177,6 @@
 <!ENTITY gtk-Styles SYSTEM "xml/gtkstyle.xml">
 <!ENTITY gtk-Themes SYSTEM "xml/gtkthemes.xml">
 <!ENTITY gtk-Resource-Files SYSTEM "xml/gtkrc.xml">
-<!ENTITY gtk-Rich-Text SYSTEM "xml/gtkrichtext.xml">
 <!ENTITY GtkAccelGroup SYSTEM "xml/gtkaccelgroup.xml">
 <!ENTITY gtk-accel-map SYSTEM "xml/gtkaccelmap.xml">
 <!ENTITY gtk-Selections SYSTEM "xml/gtkselection.xml">
@@ -348,7 +347,6 @@ that is, GUI components such as <link linkend="GtkButton">GtkButton</link> or
     &gtk-Graphics-Contexts;
     &gtk-Styles;
     &gtk-Selections;
-    &gtk-Rich-Text;
     &gtk-Feature-Test-Macros;
     &gtk-Signals;
     &gtk-Types;

docs/reference/gtk/tmpl/gtk-unused.sgml

@@ -513,6 +513,12 @@ Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_FOREIGN
 @b: 
 @Returns: 
 
+<!-- ##### ARG GtkAboutDialog:link-color ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### STRUCT GtkAccelEntry ##### -->
 <para>
 This is a private struct used by GTK+ internally, don't worry about it.
@@ -620,6 +626,20 @@ Define a function pointer.  Deprecated.
 </para>
 
 
+<!-- ##### SIGNAL GtkComboBox::popup-hide ##### -->
+<para>
+
+</para>
+
+@combobox: the object which received the signal.
+
+<!-- ##### SIGNAL GtkComboBox::popup-show ##### -->
+<para>
+
+</para>
+
+@combobox: the object which received the signal.
+
 <!-- ##### ARG GtkComboBox:appearance ##### -->
 <para>
 
@@ -925,6 +945,33 @@ a RC file.
 @menubar: the object which received the signal.
 @arg1: 
 
+<!-- ##### SIGNAL GtkNotebook::tab-added ##### -->
+<para>
+
+</para>
+
+@notebook: the object which received the signal.
+@arg1: 
+@arg2: 
+
+<!-- ##### SIGNAL GtkNotebook::tab-removed ##### -->
+<para>
+
+</para>
+
+@notebook: the object which received the signal.
+@arg1: 
+@arg2: 
+
+<!-- ##### SIGNAL GtkNotebook::tab-reordered ##### -->
+<para>
+
+</para>
+
+@notebook: the object which received the signal.
+@arg1: 
+@arg2: 
+
 <!-- ##### ARG GtkObject:object-signal ##### -->
 <para>
 Setting this with a GtkType of GTK_TYPE_SIGNAL connects
@@ -2136,6 +2183,13 @@ Claim or disclaim ownership of the PRIMARY X selection.
 @claim: if %TRUE, claim the selection, otherwise, disclaim it.
 @time: the timestamp for claiming the selection.
 
+<!-- ##### FUNCTION gtk_file_chooser_error_quark ##### -->
+<para>
+
+</para>
+
+@Returns: 
+
 <!-- ##### FUNCTION gtk_file_chooser_get_folder_mode ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtkaboutdialog.sgml

@@ -114,11 +114,6 @@ only private fields and should not be directly accessed.
 
 </para>
 
-<!-- ##### ARG GtkAboutDialog:link-color ##### -->
-<para>
-
-</para>
-
 <!-- ##### FUNCTION gtk_about_dialog_new ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtkaccelgroup.sgml

@@ -94,9 +94,6 @@ Deprecated equivalent of g_object_unref().
 @accel_mods: 
 @accel_flags: 
 @closure: 
-<!-- # Unused Parameters # -->
-@accel_path_quark: 
-@path_quark: 
 
 
 <!-- ##### FUNCTION gtk_accel_group_connect_by_path ##### -->
@@ -141,9 +138,6 @@ Deprecated equivalent of g_object_unref().
 @accel_group: 
 @closure: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@accel_key: 
-@accel_mods: