Commit 6921206d authored by Matthias Clasen's avatar Matthias Clasen

2.11.0

svn path=/trunk/; revision=17903
parent 30e97fc1
2007-05-24 Matthias Clasen <mclasen@redhat.com>
* === Released 2.11.0 ===
* NEWS: Updates
2007-05-23 Matthias Clasen <mclasen@redhat.com>
......
......@@ -4,7 +4,7 @@ Prerequisites
GTK+ requires the following packages:
- The GLib, Pango, ATK and cairo libraries, available at the same
location as GTK+. GTK+ 2.10.2 requires at least GLib 2.12,
location as GTK+. GTK+ 2.11.0 requires at least GLib 2.12,
Pango 1.13, ATK 1.9 and cairo 1.2.
- The TIFF, PNG, and JPEG image loading libraries. You most
......@@ -20,8 +20,8 @@ GTK+ requires the following packages:
Simple install procedure
========================
% gzip -cd gtk+-2.10.2.tar.gz | tar xvf - # unpack the sources
% cd gtk+-2.10.2 # change to the toplevel directory
% gzip -cd gtk+-2.11.0.tar.gz | tar xvf - # unpack the sources
% cd gtk+-2.11.0 # change to the toplevel directory
% ./configure # run the `configure' script
% make # build GTK+
[ Become root if necessary ]
......
General Information
===================
This is GTK+ version 2.10.2. GTK+ is a multi-platform toolkit for
This is GTK+ version 2.11.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.
......@@ -27,6 +27,27 @@ Installation
See the file 'INSTALL'
Release notes for 2.12
======================
* Functions: gtk_about_dialog_get/set_name() were deprecated in favour of
gtk_about_dialog_get/set_program_name(), the GtkAboutDialog now uses the
"program-name" property instead of the conflicting "name" property.
* The tiff loader now requires libtiff 3.6.0 or later.
* Support for Windows 9x/ME has officially been removed. It hasn't worked
since 2.6 anyway.
* The GtkTextBufferTargetInfo enumeration values have been changed from
G_MAXUINT-0, G_MAXUINT-1, G_MAXUINT-2, etc, to -1, -2, -3 to stay within
ANSI C limits.
* A change in the handling of _NET_WM_USER_TIME properties on toplevel
windows can cause deadlock problems with window managers that are using
GDK for drawing decorations. In particular, metacity <= 2.18.0 is affected
by this. The problem has been fixed in metacity 2.18.1.
Release notes for 2.10
======================
......@@ -126,7 +147,7 @@ Release notes for 2.8
Release notes for 2.6
=====================
* GTK+ 2.6 supports clipboard persistence. To make use of this feature,
* GTK+ 2.6 supports clipboard persistency. To make use of this feature,
a clipboard manager following the specification at
http://www.freedesktop.org/wiki/Standards/clipboard-manager-spec
must be running. A sample implementation of such a clipboard manager
......@@ -137,11 +158,11 @@ Release notes for 2.6
* Notification on clipboard ownership changes via GdkOwnerChange events
requires the XFIXES X extension. Applications can use the function
gdk_display_supports_selection_notification() to find out if ownership
gdk_display_supports_selection_notification() to find out if ownerchip
change notification is available.
* The icon theme code in GTK+ 2.6 follows the freedesktop.org icon theme
specification. Setting the XDG_DATA_DIRS environment variable may be
specification. Setting the XDG_DATA_DIRS environtment variable may be
necessary if your icons aren't installed in the default location
/usr/share/icons.
......@@ -151,7 +172,7 @@ Release notes for 2.6
see the gtk-update-icon-cache man page or the GTK+ documentation.
* To reduce code size and improve efficiency, GTK+, when compiled
with the GNU tool chain, has separate internal and external entry
with the GNU toolchain, has separate internal and external entry
points for exported functions. The internal names, which begin with
IA__, may be seen when debugging a GTK+ program.
......@@ -179,7 +200,7 @@ Release notes for 2.6
compatibility are provided.
* On Unix, the assumption of GLib and GTK+ by default is that filenames on
the file system are encoded in UTF-8 rather than the encoding of the locale;
the filesystem are encoded in UTF-8 rather than the encoding of the locale;
the GTK+ developers consider that having filenames whose interpretation
depends on the current locale is fundamentally a bad idea.
......@@ -197,7 +218,7 @@ Release notes for 2.6
On Windows, filenames passed to GTK+ should always be in UTF-8, as
in GLib 2.6. This is different than in previous versions of GTK+
where the system code page was used. As in GLib, for DLL ABI
where the system codepage was used. As in GLib, for DLL ABI
stability, applications built against previous versions of GTK+ will
use entry points providing the old semantics.
......@@ -233,7 +254,7 @@ In the bug report please include:
that can be downloaded.
* If the bug was a crash, the exact text that was printed out when the
crash occurred.
crash occured.
* Further information such as stack traces may be useful, but is not
necessary. If you do send a stack trace, and the error is an X error,
......@@ -251,7 +272,8 @@ report.
Otherwise, enter a new bug report that describes the patch, and attach
the patch to that bug report.
Bug reports containing patches that add to or change the GTK+ programming
interface should include the API keyword in their keyword fields.
Bug reports containing patches should include the PATCH keyword in their
keyword fields. If the patch adds to or changes the GTK+ programming
interface, the API keyword should also be included.
Patches should be in unified diff form. (The -u option to GNU diff.)
......@@ -34,11 +34,23 @@ Release notes for 2.12
gtk_about_dialog_get/set_program_name(), the GtkAboutDialog now uses the
"program-name" property instead of the conflicting "name" property.
* The tiff loader now requires libtiff 3.6.0 or later.
* Support for Windows 9x/ME has officially been removed. It hasn't worked
since 2.6 anyway.
* The GtkTextBufferTargetInfo enumeration values have been changed from
G_MAXUINT-0, G_MAXUINT-1, G_MAXUINT-2, etc, to -1, -2, -3 to stay within
ANSI C limits.
* A change in the handling of _NET_WM_USER_TIME properties on toplevel
windows can cause deadlock problems with window managers that are using
GDK for drawing decorations. In particular, metacity <= 2.18.0 is affected
by this. The problem has been fixed in metacity 2.18.1.
Release notes for 2.10
======================
* The tiff loader now requires libtiff 3.6.0 or later.
* 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.
......
2007-05-24 Matthias Clasen <mclasen@redhat.com>
* === Released 2.11.0 ===
2006-10-08 Matthias Clasen <mclasen@redhat.com>
* gdk-pixbuf-xlib.c: Apply a cleanup patch by
......
2007-05-24 Matthias Clasen <mclasen@redhat.com>
* === Released 2.11.0 ===
2007-05-23 Matthias Clasen <mclasen@redhat.com>
* gtk/gtk-sections.txt:
......
......@@ -289,3 +289,12 @@ The colormap structure contains the following public fields.
@Returns:
<!-- ##### FUNCTION gdk_color_to_string ##### -->
<para>
</para>
@color:
@Returns:
......@@ -308,3 +308,49 @@ gdk_threads_enter()/gdk_threads_leave().
@leave_fn:
<!-- ##### FUNCTION gdk_threads_add_idle ##### -->
<para>
</para>
@function:
@data:
@Returns:
<!-- ##### FUNCTION gdk_threads_add_idle_full ##### -->
<para>
</para>
@priority:
@function:
@data:
@notify:
@Returns:
<!-- ##### FUNCTION gdk_threads_add_timeout ##### -->
<para>
</para>
@interval:
@function:
@data:
@Returns:
<!-- ##### FUNCTION gdk_threads_add_timeout_full ##### -->
<para>
</para>
@priority:
@interval:
@function:
@data:
@notify:
@Returns:
......@@ -531,6 +531,12 @@ Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_FOREIGN
</para>
<!-- ##### ARG GtkAboutDialog:name ##### -->
<para>
</para>
<!-- ##### STRUCT GtkAccelEntry ##### -->
<para>
This is a private struct used by GTK+ internally, don't worry about it.
......@@ -626,6 +632,12 @@ Define a function pointer. Deprecated.
@parent:
<!-- ##### ARG GtkCellView:use-fg ##### -->
<para>
</para>
<!-- ##### ARG GtkColorSelection:previous-alpha ##### -->
<para>
......@@ -2070,6 +2082,14 @@ Sets the default size of child buttons.
@Returns:
<!-- ##### FUNCTION gtk_cell_view_get_use_fg ##### -->
<para>
</para>
@cell_view:
@Returns:
<!-- ##### FUNCTION gtk_cell_view_set_cell_data ##### -->
<para>
......@@ -2078,6 +2098,14 @@ Sets the default size of child buttons.
@cell_view:
@cellview:
<!-- ##### FUNCTION gtk_cell_view_set_use_fg ##### -->
<para>
</para>
@cell_view:
@use_fg:
<!-- ##### FUNCTION gtk_clist_construct ##### -->
<para>
Initializes a previously allocated #GtkCList widget for use. This should not
......
......@@ -98,7 +98,7 @@ only private fields and should not be directly accessed.
</para>
<!-- ##### ARG GtkAboutDialog:name ##### -->
<!-- ##### ARG GtkAboutDialog:program-name ##### -->
<para>
</para>
......@@ -154,6 +154,24 @@ only private fields and should not be directly accessed.
@name:
<!-- ##### FUNCTION gtk_about_dialog_get_program_name ##### -->
<para>
</para>
@about:
@Returns:
<!-- ##### FUNCTION gtk_about_dialog_set_program_name ##### -->
<para>
</para>
@about:
@name:
<!-- ##### FUNCTION gtk_about_dialog_get_version ##### -->
<para>
......
......@@ -246,6 +246,15 @@ and should not be accessed directly.
@Returns:
<!-- ##### FUNCTION gtk_action_create_menu ##### -->
<para>
</para>
@action:
@Returns:
<!-- ##### FUNCTION gtk_action_connect_proxy ##### -->
<para>
......
......@@ -50,6 +50,7 @@ of the attribute for each cell that is rendered.
@set_cell_data_func:
@clear_attributes:
@reorder:
@get_cells:
<!-- ##### USER_FUNCTION GtkCellLayoutDataFunc ##### -->
<para>
......@@ -84,6 +85,15 @@ as appropriate.
@expand:
<!-- ##### FUNCTION gtk_cell_layout_get_cells ##### -->
<para>
</para>
@cell_layout:
@Returns:
<!-- ##### FUNCTION gtk_cell_layout_reorder ##### -->
<para>
......
......@@ -62,7 +62,6 @@ probably has a selection colored background to render to.
@GTK_CELL_RENDERER_INSENSITIVE: The cell is drawn in an insensitive manner
@GTK_CELL_RENDERER_SORTED: The cell is in a sorted row
@GTK_CELL_RENDERER_FOCUSED:
@GTK_CELL_RENDERER_USE_FG:
<!-- ##### ENUM GtkCellRendererMode ##### -->
<para>
......
......@@ -28,6 +28,11 @@ The #GtkCellRendererProgress cell renderer was added in GTK+ 2.6.
</para>
<!-- ##### ARG GtkCellRendererProgress:pulse ##### -->
<para>
</para>
<!-- ##### ARG GtkCellRendererProgress:text ##### -->
<para>
......
......@@ -46,29 +46,6 @@ and drag and drop.
</para>
<!-- ##### ARG GtkCellView:use-fg ##### -->
<para>
</para>
<!-- ##### FUNCTION gtk_cell_view_get_use_fg ##### -->
<para>
</para>
@cell_view:
@Returns:
<!-- ##### FUNCTION gtk_cell_view_set_use_fg ##### -->
<para>
</para>
@cell_view:
@use_fg:
<!-- ##### FUNCTION gtk_cell_view_new ##### -->
<para>
......
......@@ -63,6 +63,14 @@ gtk_combo_box_get_active_text().
@combobox: the object which received the signal.
@arg1:
<!-- ##### SIGNAL GtkComboBox::popdown ##### -->
<para>
</para>
@combobox: the object which received the signal.
@Returns:
<!-- ##### SIGNAL GtkComboBox::popup ##### -->
<para>
......@@ -130,6 +138,11 @@ gtk_combo_box_get_active_text().
</para>
<!-- ##### ARG GtkComboBox:shadow-type ##### -->
<para>
</para>
<!-- ##### FUNCTION gtk_combo_box_new ##### -->
<para>
......
......@@ -69,10 +69,10 @@ constraints on an entry in a #GtkTargetTable.
@GTK_TARGET_SAME_WIDGET:
If this is set, the target will only be selected
for drags within a single widget.
@GTK_TARGET_OTHER_APP:
@GTK_TARGET_OTHER_APP:
If this is set, the target will not be selected
for drags within a single application. Since 2.12
@GTK_TARGET_OTHER_WIDGET:
@GTK_TARGET_OTHER_WIDGET:
If this is set, the target will not be selected
for drags withing a single widget. Since 2.12
......
......@@ -156,6 +156,11 @@ The #GtkEntry-struct struct contains only private data.
</para>
<!-- ##### ARG GtkEntry:shadow-type ##### -->
<para>
</para>
<!-- ##### ARG GtkEntry:text ##### -->
<para>
......@@ -240,7 +245,6 @@ Prepends the given text to the contents of the widget.
instead.
<!-- ##### FUNCTION gtk_entry_set_position ##### -->
<para>
Sets the cursor position in an entry to the given
......@@ -505,3 +509,21 @@ use gtk_editable_set_editable() instead.
@Returns:
<!-- ##### FUNCTION gtk_entry_set_cursor_hadjustment ##### -->
<para>
</para>
@entry:
@adjustment:
<!-- ##### FUNCTION gtk_entry_get_cursor_hadjustment ##### -->
<para>
</para>
@entry:
@Returns:
......@@ -60,6 +60,16 @@ The GtkEntryCompletion struct contains only private data.
@entrycompletion: the object which received the signal.
@arg1:
<!-- ##### SIGNAL GtkEntryCompletion::cursor-on-match ##### -->
<para>
</para>
@entrycompletion: the object which received the signal.
@arg1:
@arg2:
@Returns:
<!-- ##### SIGNAL GtkEntryCompletion::insert-prefix ##### -->
<para>
......@@ -84,6 +94,11 @@ The GtkEntryCompletion struct contains only private data.
</para>
<!-- ##### ARG GtkEntryCompletion:inline-selection ##### -->
<para>
</para>
<!-- ##### ARG GtkEntryCompletion:minimum-key-length ##### -->
<para>
......@@ -202,6 +217,15 @@ to the unmodified key via <literal>gtk_entry_get_text (GTK_ENTRY (gtk_entry_comp
@completion:
<!-- ##### FUNCTION gtk_entry_completion_get_completion_prefix ##### -->
<para>
</para>
@completion:
@Returns:
<!-- ##### FUNCTION gtk_entry_completion_insert_prefix ##### -->
<para>
......@@ -275,6 +299,24 @@ to the unmodified key via <literal>gtk_entry_get_text (GTK_ENTRY (gtk_entry_comp
@Returns:
<!-- ##### FUNCTION gtk_entry_completion_set_inline_selection ##### -->
<para>
</para>
@completion:
@inline_selection:
<!-- ##### FUNCTION gtk_entry_completion_get_inline_selection ##### -->
<para>
</para>
@completion:
@Returns:
<!-- ##### FUNCTION gtk_entry_completion_set_popup_completion ##### -->
<para>
......
......@@ -84,6 +84,7 @@ contains. (See also: #GtkVButtonBox and #GtkHButtonBox).
left for a HBox, or the top for a VBox).
@GTK_BUTTONBOX_END: Buttons are grouped towards the end of a box, (on the
right for a HBox, or the bottom for a VBox).
@GTK_BUTTONBOX_CENTER:
<!-- ##### ENUM GtkCornerType ##### -->
<para>
......
......@@ -57,6 +57,13 @@ This should not be accessed directly. Use the accessor functions below.
</para>
<!-- ##### SIGNAL GtkFileChooserButton::file-set ##### -->
<para>
</para>
@filechooserbutton: the object which received the signal.
<!-- ##### ARG GtkFileChooserButton:dialog ##### -->
<para>
......
......@@ -99,33 +99,32 @@ void create_file_selection (void) {
The #GtkFileSelection struct contains the following #GtkWidget fields:
</para>
@fileop_dialog: the dialog box used to display the #GtkFileSelection.
It can be customized by adding/removing widgets from it using the
standard #GtkDialog functions.
@dir_list:
@file_list:
@selection_entry:
@selection_text:
@main_vbox:
@ok_button:
@cancel_button: the two main buttons that signals should be connected
to in order to perform an action when the user hits either OK or
Cancel.
@help_button:
@history_pulldown: the #GtkOptionMenu used to create the drop-down
directory history.
@history_menu:
@history_list:
@fileop_dialog: the dialog box used to display the #GtkFileSelection.
It can be customized by adding/removing widgets from it using the
standard #GtkDialog functions.
@fileop_entry:
@fileop_file:
@cmpl_state:
@fileop_c_dir:
@fileop_del_file:
@fileop_ren_file: the buttons that appear at the top of the file
selection dialog. These "operation buttons" can be hidden and
redisplayed with gtk_file_selection_hide_fileop_buttons() and
gtk_file_selection_show_fileop_buttons() respectively.
@dir_list:
@file_list:
@selection_entry:
@selection_text:
@main_vbox:
@help_button:
@history_menu:
@history_list:
@fileop_entry:
@fileop_file:
@cmpl_state:
@button_area:
@action_area:
......
......@@ -137,6 +137,7 @@ gtk_icon_theme_set_custom_theme().
@GTK_ICON_LOOKUP_NO_SVG:
@GTK_ICON_LOOKUP_FORCE_SVG:
@GTK_ICON_LOOKUP_USE_BUILTIN:
@GTK_ICON_LOOKUP_GENERIC_FALLBACK:
<!-- ##### MACRO GTK_ICON_THEME_ERROR ##### -->
<para>
......@@ -256,6 +257,18 @@ The #GQuark used for #GtkIconThemeError errors.
@Returns:
<!-- ##### FUNCTION gtk_icon_theme_choose_icon ##### -->
<para>
</para>
@icon_theme:
@icon_names:
@size:
@flags:
@Returns:
<!-- ##### FUNCTION gtk_icon_theme_load_icon ##### -->
<para>
......@@ -269,6 +282,15 @@ The #GQuark used for #GtkIconThemeError errors.
@Returns:
<!-- ##### FUNCTION gtk_icon_theme_list_contexts ##### -->
<para>
</para>