1998-04-10 04:32:15 +00:00
|
|
|
General Information
|
|
|
|
===================
|
1997-11-24 22:37:52 +00:00
|
|
|
|
2007-06-06 13:40:24 +00:00
|
|
|
This is GTK+ version 2.11.2. GTK+ is a multi-platform toolkit for
|
2002-03-08 20:00:44 +00:00
|
|
|
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.
|
2002-03-08 05:53:51 +00:00
|
|
|
|
|
|
|
GTK+ is free software and part of the GNU Project. However, the
|
|
|
|
licensing terms for GTK+, the GNU LGPL, allow it to be used by all
|
2002-03-08 20:00:44 +00:00
|
|
|
developers, including those developing proprietary software, without any
|
|
|
|
license fees or royalties.
|
1997-12-14 08:49:30 +00:00
|
|
|
|
1997-11-24 22:37:52 +00:00
|
|
|
The official ftp site is:
|
1998-04-14 01:05:16 +00:00
|
|
|
ftp://ftp.gtk.org/pub/gtk
|
1997-11-24 22:37:52 +00:00
|
|
|
|
1998-03-02 00:32:52 +00:00
|
|
|
The official web site is:
|
1998-04-14 01:05:16 +00:00
|
|
|
http://www.gtk.org/
|
1998-03-02 00:32:52 +00:00
|
|
|
|
2001-04-17 23:21:18 +00:00
|
|
|
Information about mailing lists can be found at
|
|
|
|
http://www.gtk.org/mailinglists.html
|
1998-04-10 04:32:15 +00:00
|
|
|
|
2006-07-03 06:07:00 +00:00
|
|
|
|
1998-04-10 04:32:15 +00:00
|
|
|
Installation
|
|
|
|
============
|
|
|
|
|
|
|
|
See the file 'INSTALL'
|
|
|
|
|
2006-07-03 06:07:00 +00:00
|
|
|
|
2007-05-24 05:51:56 +00:00
|
|
|
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.
|
|
|
|
|
2007-06-04 17:01:14 +00:00
|
|
|
* Semi-private GtkTextLayout api has changed: new GtkTextLayout method
|
|
|
|
invalidate_cursors(), and new functions gtk_text_layout_invalidate_cursors()
|
|
|
|
and gtk_text_layout_cursors_changed(), which should be used in place of
|
|
|
|
gtk_text_layout_invalidate() and gtk_text_layout_changed() if invalidation
|
|
|
|
is due to marks moved or changed selection; new GtkTextLineDisplay structure
|
|
|
|
member. Source compatibility is preserved; binary compatibility may break
|
|
|
|
only if GtkTextLineDisplay structure was created on stack or as a part
|
|
|
|
of another structure (in particular GnomeCanvas and its clones do not need
|
|
|
|
recompiling).
|
|
|
|
|
|
|
|
* Another new signal has been added to GtkNotebook. The new signal
|
|
|
|
is called create-window, so this name can no longer be used for signals
|
|
|
|
in objects derived from GtkNotebook.
|
|
|
|
|
|
|
|
* The move-focus signal has been moved to GtkWidget, to unify the
|
|
|
|
various implementations of this signal in specific widgets. Great care
|
|
|
|
has been taken to make sure that all code using this signal continues
|
|
|
|
to work.
|
|
|
|
|
|
|
|
|
2006-05-05 16:21:19 +00:00
|
|
|
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
|
|
|
|
|
2006-07-03 06:07:00 +00:00
|
|
|
* Accelerators 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.
|
2006-05-05 16:21:19 +00:00
|
|
|
|
|
|
|
* The pixbuf theme engine can now customize expanders (in GtkTreeView
|
|
|
|
and GtkExpander) and resize grips, using the new EXPANDER and
|
|
|
|
RESIZE_GRIP function values.
|
|
|
|
|
2006-07-03 06:07:00 +00:00
|
|
|
* Dialogs created by gtk_about_dialog_new() no longer hide automatically
|
2006-05-05 16:21:19 +00:00
|
|
|
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.
|
|
|
|
|
2006-07-03 06:07:00 +00:00
|
|
|
* Due to the interface changes in the file chooser backend interface,
|
|
|
|
the GTK+ ABI version has been bumped to 2.10.0. Third-party filesystem
|
|
|
|
backends have to be ported to the new interface, other 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.
|
|
|
|
|
|
|
|
|
|
|
|
Release notes for 2.8
|
|
|
|
=====================
|
|
|
|
|
|
|
|
* GTK+ 2.8 and Pango 1.10 require the cairo library.
|
|
|
|
|
|
|
|
* The default theme has been renamed to "Raleigh". Existing configurations
|
|
|
|
specifying the "Default" theme name should still work.
|
|
|
|
|
|
|
|
* The GtkTreeView::enable-search property has been changed to control
|
|
|
|
only typeahead search, not the C-f keybinding to start an interactive
|
|
|
|
search. To turn off interactive searching completely, you have to
|
|
|
|
set GtkTreeView::search-column to -1.
|
|
|
|
|
|
|
|
* The restriction on using the same cell renderer in multiple columns
|
|
|
|
of a GtkTreeView is now more strictly enforced.
|
|
|
|
|
|
|
|
* In GTK+ 2.8, GtkCalendar uses nl_langinfo() (if available) to determine
|
|
|
|
the first day of the week. Thus, it is possible to select the first day
|
|
|
|
of the week independently from the language, by setting LC_TIME.
|
|
|
|
|
|
|
|
* In GTK+ 2.8, the gtk-update-icon-cache utility includes image data
|
|
|
|
in the icon caches, which will make the icon cache files larger than
|
|
|
|
the one produced by GTK+ 2.6. This change will reduce the memory
|
|
|
|
overhead of icon themes at runtime, since all GTK+ applications can
|
|
|
|
share the image data in memory.
|
|
|
|
|
|
|
|
* In 2.8, GDK emits GdkEventGrabBroken events when a keyboard or pointer
|
|
|
|
grab is broken. On X11, this can happen if the same application grabs
|
|
|
|
again, or if the window used for the grab becomes unviewable. It happens
|
|
|
|
more often on Win32. Applications which use grabs should pay attention
|
|
|
|
to these events and do the necessary cleanups when the grab is lost.
|
|
|
|
* The GIOChannel code for sockets on win32 has been rewritten.
|
|
|
|
Applications who make non-trivial use of GIOChannels on win32 should
|
|
|
|
be watched for possible problems.
|
|
|
|
|
|
|
|
* GLib 2.8 uses atomic operations to implement reference counting, thus
|
|
|
|
g_object_ref/unref, g_closure_ref/sink/unref and g_iochannel_ref/unref
|
|
|
|
can be used without locking in multithreaded applications. Note that
|
|
|
|
other modifications, like concurrent setting of properties still require
|
|
|
|
locking.
|
|
|
|
|
|
|
|
* g_convert() and related character set conversion functions have been
|
|
|
|
fixed to emit pending shift states and to not cache iconv descriptors
|
|
|
|
across multiple calls, since that is problematic for some encodings.
|
|
|
|
Note that these functions are not suitable for streaming conversions;
|
|
|
|
use g_iconv() to do streaming conversion.
|
|
|
|
|
|
|
|
|
|
|
|
Release notes for 2.6
|
|
|
|
=====================
|
2002-03-08 20:00:44 +00:00
|
|
|
|
2007-05-24 05:51:56 +00:00
|
|
|
* GTK+ 2.6 supports clipboard persistency. To make use of this feature,
|
2004-12-16 18:21:44 +00:00
|
|
|
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
|
|
|
|
is available at
|
|
|
|
http://people.imendio.com/andersca/archives/clipboard-manager-0.3.tar.gz
|
|
|
|
Applications can use the function gdk_display_supports_clipboard_persistence()
|
|
|
|
to find out if clipboard persistence is available.
|
|
|
|
|
|
|
|
* Notification on clipboard ownership changes via GdkOwnerChange events
|
|
|
|
requires the XFIXES X extension. Applications can use the function
|
2007-05-24 05:51:56 +00:00
|
|
|
gdk_display_supports_selection_notification() to find out if ownerchip
|
2004-12-16 18:21:44 +00:00
|
|
|
change notification is available.
|
|
|
|
|
|
|
|
* The icon theme code in GTK+ 2.6 follows the freedesktop.org icon theme
|
2007-05-24 05:51:56 +00:00
|
|
|
specification. Setting the XDG_DATA_DIRS environtment variable may be
|
2004-12-16 18:21:44 +00:00
|
|
|
necessary if your icons aren't installed in the default location
|
|
|
|
/usr/share/icons.
|
|
|
|
|
|
|
|
* The icon theme code in GTK+ 2.6 can make use of mmap()able cache files
|
|
|
|
to avoid a lot of disk searching overhead. GTK+ includes a utility named
|
|
|
|
gtk-update-icon-cache to generate these cache files. For further details,
|
|
|
|
see the gtk-update-icon-cache man page or the GTK+ documentation.
|
|
|
|
|
|
|
|
* To reduce code size and improve efficiency, GTK+, when compiled
|
2007-05-24 05:51:56 +00:00
|
|
|
with the GNU toolchain, has separate internal and external entry
|
2004-12-16 18:21:44 +00:00
|
|
|
points for exported functions. The internal names, which begin with
|
|
|
|
IA__, may be seen when debugging a GTK+ program.
|
|
|
|
|
|
|
|
* The following functions have been deprecated in GTK+ 2.6:
|
|
|
|
gdk_pango_context_set_colormap
|
|
|
|
gtk_cell_renderer_editing_canceled
|
|
|
|
|
2004-03-16 20:22:55 +00:00
|
|
|
* The new GtkFileChooser widget emphasizes simplicity and thus does
|
|
|
|
not provide a navigation entry by default when opening files.
|
|
|
|
Experienced command line users will likely want to make heavy use of
|
|
|
|
the location dialog brought up by the Control-L key shortcut.
|
|
|
|
|
2002-03-08 20:00:44 +00:00
|
|
|
* The GTK+ libraries use an '_' prefix to indicate private symbols that
|
2002-12-21 01:59:14 +00:00
|
|
|
must not be used by applications. On some platforms, symbols beginning
|
|
|
|
with prefixes such as _gtk, _gdk, and _pango will be exported
|
|
|
|
from the library, on others not. In no case can applications
|
2004-12-16 18:21:44 +00:00
|
|
|
use these private symbols. In addition to that, GTK+ 2.6 makes several
|
|
|
|
symbols private which were not in any installed header files and
|
|
|
|
were never intended to be exported.
|
|
|
|
|
|
|
|
* The gdk_pixbuf_xlib library included in the contrib/ directory
|
|
|
|
and the framebuffer GDK backend included in the gdk/linux-fb directory
|
|
|
|
of GTK+ are provided on an as-is basis and have not been tested at all.
|
|
|
|
No guarantees about the degree of workingness or about future
|
2002-03-08 20:00:44 +00:00
|
|
|
compatibility are provided.
|
|
|
|
|
2004-12-16 18:21:44 +00:00
|
|
|
* On Unix, the assumption of GLib and GTK+ by default is that filenames on
|
2007-05-24 05:51:56 +00:00
|
|
|
the filesystem are encoded in UTF-8 rather than the encoding of the locale;
|
2004-03-16 20:22:55 +00:00
|
|
|
the GTK+ developers consider that having filenames whose interpretation
|
2002-03-08 20:00:44 +00:00
|
|
|
depends on the current locale is fundamentally a bad idea.
|
|
|
|
|
2004-12-16 18:21:44 +00:00
|
|
|
If you have filenames encoded in the encoding of your locale, then you
|
|
|
|
may want to set the G_FILENAME_ENCODING environment variable:
|
2002-03-08 20:00:44 +00:00
|
|
|
|
2005-01-08 07:50:46 +00:00
|
|
|
G_FILENAME_ENCODING=@locale
|
2004-03-16 20:22:55 +00:00
|
|
|
export G_FILENAME_ENCODING
|
2002-03-08 20:00:44 +00:00
|
|
|
|
2004-12-16 18:21:44 +00:00
|
|
|
(Earlier versions of GLib 2.x required a different environment variable
|
2004-03-16 20:22:55 +00:00
|
|
|
setting; G_BROKEN_FILENAMES=1 to achieve the same effect; this
|
|
|
|
is still supported, but G_FILENAME_ENCODING is preferred.)
|
2004-12-16 18:21:44 +00:00
|
|
|
Best integration of GTK+ 2.6 with the environment is achieved by
|
2002-03-08 20:00:44 +00:00
|
|
|
using a UTF-8 locale.
|
|
|
|
|
2004-12-16 18:21:44 +00:00
|
|
|
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+
|
2007-05-24 05:51:56 +00:00
|
|
|
where the system codepage was used. As in GLib, for DLL ABI
|
2004-12-16 18:21:44 +00:00
|
|
|
stability, applications built against previous versions of GTK+ will
|
|
|
|
use entry points providing the old semantics.
|
|
|
|
|
|
|
|
When compiling against GTK+ 2.6, applications intended to be
|
|
|
|
portable to Windows must take the UTF-8 file name encoding into
|
|
|
|
consideration, and use the gstdio wrappers to access files whose
|
|
|
|
names have been constructed from strings returned from GTK+ or GLib.
|
|
|
|
|
2006-07-03 06:07:00 +00:00
|
|
|
|
1998-04-10 04:32:15 +00:00
|
|
|
How to report bugs
|
|
|
|
==================
|
|
|
|
|
2002-03-08 20:00:44 +00:00
|
|
|
Bugs should be reported to the GNOME bug tracking system.
|
|
|
|
(http://bugzilla.gnome.org, product gtk+.) You will need to create an
|
|
|
|
account for yourself.
|
2001-04-17 23:21:18 +00:00
|
|
|
|
|
|
|
In the bug report please include:
|
|
|
|
|
1998-04-10 04:32:15 +00:00
|
|
|
* Information about your system. For instance:
|
|
|
|
|
|
|
|
- What operating system and version
|
|
|
|
- What version of X
|
|
|
|
- For Linux, what version of the C library
|
|
|
|
|
|
|
|
And anything else you think is relevant.
|
|
|
|
|
|
|
|
* How to reproduce the bug.
|
|
|
|
|
2004-12-16 18:21:44 +00:00
|
|
|
If you can reproduce it with one of the tests or demos built with GTK+,
|
|
|
|
such as demos/gtk-demo/gtk-demo, that would be most convenient. Otherwise,
|
|
|
|
please include a short test program that exhibits the behavior. As a
|
|
|
|
last resort, you can also provide a pointer to a larger piece of software
|
2002-03-08 20:00:44 +00:00
|
|
|
that can be downloaded.
|
1998-04-10 04:32:15 +00:00
|
|
|
|
2002-03-08 20:00:44 +00:00
|
|
|
* If the bug was a crash, the exact text that was printed out when the
|
2007-05-24 05:51:56 +00:00
|
|
|
crash occured.
|
1998-04-10 04:32:15 +00:00
|
|
|
|
2002-03-08 20:00:44 +00:00
|
|
|
* 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,
|
|
|
|
it will be more useful if the stacktrace is produced running the test
|
|
|
|
program with the --sync command line option.
|
1998-04-10 04:32:15 +00:00
|
|
|
|
2006-07-03 06:07:00 +00:00
|
|
|
|
1998-04-10 04:32:15 +00:00
|
|
|
Patches
|
|
|
|
=======
|
|
|
|
|
2002-03-08 20:00:44 +00:00
|
|
|
Patches should also be submitted to bugzilla.gnome.org. If the patch
|
|
|
|
fixes an existing bug, add the patch as an attachment to that bug
|
|
|
|
report.
|
2001-04-17 23:21:18 +00:00
|
|
|
|
2002-03-08 20:00:44 +00:00
|
|
|
Otherwise, enter a new bug report that describes the patch, and attach
|
|
|
|
the patch to that bug report.
|
1998-04-10 04:32:15 +00:00
|
|
|
|
2007-05-24 05:51:56 +00:00
|
|
|
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.
|
2001-04-17 23:21:18 +00:00
|
|
|
|
2002-03-08 20:00:44 +00:00
|
|
|
Patches should be in unified diff form. (The -u option to GNU diff.)
|