GTK is a multi-platform toolkit for creating graphical user interfaces.
Go to file
Alexander Larsson e7d4a7f90d Document expose event->region change and that gtk_widget_event doesn't
2001-03-09  Alexander Larsson  <alexl@redhat.com>

	* docs/Changes-2.0.txt:
	Document expose event->region change and that gtk_widget_event
	doesn't allow passing expose events.

	* gdk/gdkevents.h:
	Add region to expose event.

	* gdk/gdkevents.c:
	Handle event->region in gdk_event_copy() and gdk_event_free().

	* gdk/gdkwindow.c (gdk_window_process_updates_internal):
	Generate expose_event->region when creating expose events.

	* gdk/x11/gdkevents-x11.c:
	Generate expose events with regions when translating X events.

	* gtk/gtkcontainer.[ch]:
	Default expose handler that propagates expose events to NO_WINDOW
	children. New function gtk_container_propagate_expose()

	* gtk/gtkwidget.[ch]:
	Moved gtk_widget_event implementation to gtk_widget_event_internal.
	gtk_widget_event calls gtk_widget_event_internal but doesn't allow
	expose events. New function gtk_widget_send_expose() to send expose
	events. New function gtk_widget_region_intersect() to calculate
	window/region intersections.

	* gtk/gtkmain.c (gtk_main_do_event):
	Use gdk_window_begin_paint_region() instead of gdk_window_begin_paint_rect().
	Use gtk_widget_send_expose() to send expose events.

	* gtk/gtkbin.c:
	* gtk/gtkbox.c:
	* gtk/gtkfixed.c:
	* gtk/gtkimagemenuitem.c:
	* gtk/gtklist.c:
	* gtk/gtkpacker.c:
	* gtk/gtktable.c:
	* gtk/gtktree.c:
	Remove expose handler, using the default container implementation
	instead.

	* gtk/gtkbutton.c:
	* gtk/gtkcheckbutton.c:
	* gtk/gtkeventbox.c:
	* gtk/gtkfixed.c:
	* gtk/gtkhandlebox.c:
	* gtk/gtklayout.c:
	* gtk/gtklistitem.c:
	* gtk/gtkmenu.c:
	* gtk/gtkmenubar.c:
	* gtk/gtkmenuitem.c:
	* gtk/gtknotebook.c:
	* gtk/gtkoptionmenu.c:
	* gtk/gtkpaned.c:
	* gtk/gtkscrolledwindow.c:
	* gtk/gtktogglebutton.c:
	* gtk/gtktoolbar.c:
	* gtk/gtktreeitem.c:
	* gtk/gtkviewport.c:
	Chain expose handler to parent class handler. Use
	gtk_container_propagate_expose() to propagate exposes.

	* gtk/gtkclist.c (check_exposures):
	* gtk/gtktext.c (process_exposes):
	Use gtk_widget_send_expose instead of gtk_widget_event.
2001-03-09 13:28:26 +00:00
contrib Commit missed changelog entry bit. 2001-01-17 19:32:55 +00:00
debian Argh. Missed one dumb space in rules file. Fixed. 1998-11-18 06:25:35 +00:00
demos new function, turns off decorations for a window. 2001-03-07 21:10:44 +00:00
docs Document expose event->region change and that gtk_widget_event doesn't 2001-03-09 13:28:26 +00:00
examples Make gdk_colormap_sync private since it was never exported in a header 2001-02-02 22:19:31 +00:00
gdk Document expose event->region change and that gtk_widget_event doesn't 2001-03-09 13:28:26 +00:00
gdk-pixbuf added accumulator data argument to g_signal_newc() functions. 2001-03-08 16:36:17 +00:00
gtk Document expose event->region change and that gtk_widget_event doesn't 2001-03-09 13:28:26 +00:00
m4macros Really release 1.3.1 2000-07-15 01:07:42 +00:00
modules made the "parent_class" pointer static. 2001-03-05 16:44:18 +00:00
po Updated Norwegian translation. 2001-03-02 21:08:41 +00:00
tests add support for invisible cells. (gtk_tree_view_bin_expose): ditto 2001-03-08 22:38:59 +00:00
.cvsignore shut up CVS 2001-03-05 19:56:46 +00:00
acconfig.h Added ENABLE_SHADOW_FB 2001-01-11 16:39:21 +00:00
acinclude.m4 Merges from gtk-1-2 2000-03-14 19:57:25 +00:00
AUTHORS Incremented version to 1.2.0. -Shawn <amundson@gtk.org> 1999-02-25 21:39:14 +00:00
autogen.sh When doing sanity checking on ACLOCAL_FLAGS, look for glib-2.0.m4 not 2000-11-04 15:14:34 +00:00
ChangeLog Document expose event->region change and that gtk_widget_event doesn't 2001-03-09 13:28:26 +00:00
ChangeLog.pre-1-0 ChangeLog split up into ChangeLog.pre-1-0 and ChangeLog. 1998-04-17 01:07:36 +00:00
ChangeLog.pre-1-2 moved old ChangeLog to ChangeLog.pre-1-2, and started new one. 1999-02-27 00:26:30 +00:00
ChangeLog.pre-2-0 Document expose event->region change and that gtk_widget_event doesn't 2001-03-09 13:28:26 +00:00
ChangeLog.pre-2-2 Document expose event->region change and that gtk_widget_event doesn't 2001-03-09 13:28:26 +00:00
ChangeLog.pre-2-4 Document expose event->region change and that gtk_widget_event doesn't 2001-03-09 13:28:26 +00:00
ChangeLog.pre-2-6 Document expose event->region change and that gtk_widget_event doesn't 2001-03-09 13:28:26 +00:00
ChangeLog.pre-2-8 Document expose event->region change and that gtk_widget_event doesn't 2001-03-09 13:28:26 +00:00
ChangeLog.pre-2-10 Document expose event->region change and that gtk_widget_event doesn't 2001-03-09 13:28:26 +00:00
config.guess Merges from gtk-1-2 2000-03-14 19:57:25 +00:00
config.h.win32.in gtk/gtkmain.c Use the new 2001-01-17 22:26:19 +00:00
config.sub Merges from gtk-1-2 2000-03-14 19:57:25 +00:00
configure.in Remove gdkcc.h reference. 2001-02-13 04:56:07 +00:00
COPYING Changed LGPL address for FSF in all .h and .c files 1998-04-13 02:02:47 +00:00
gdk-2.0.pc.in Adapt to uscore-ification of gtktextiterprivate 2001-01-04 17:48:43 +00:00
gdk-pixbuf-2.0.pc.in Remove spurious const. 2001-03-03 18:39:33 +00:00
gtk-2.0.m4 Really release 1.3.1 2000-07-15 01:07:42 +00:00
gtk-config-2.0.in Really release 1.3.1 2000-07-15 01:07:42 +00:00
gtk+-2.0.pc.in Remove spurious const. 2001-03-03 18:39:33 +00:00
gtk+.spec.in Move gtk-config to gtk-config-2.0 move gtk_.m4 to gtk-2.0.m4 2000-07-14 20:08:10 +00:00
HACKING - GNU autoconf 2.13 - GNU automake 1.4 (Beta releases are at 1999-01-17 16:54:58 +00:00
INSTALL Fix link to PNG home, remove reference to fribidi. 2000-12-05 20:53:30 +00:00
INSTALL.in Add check for db2html 2000-07-06 21:09:25 +00:00
ltconfig Merges from gtk-1-2 2000-03-14 19:57:25 +00:00
ltmain.sh Merges from gtk-1-2 2000-03-14 19:57:25 +00:00
makecopyright Changed LGPL address for FSF in all .h and .c files 1998-04-13 02:02:47 +00:00
Makefile.am use full set, since current set wasn't building on all configs. 2001-03-08 01:33:01 +00:00
NEWS Released 1.3.2 2000-11-18 01:49:13 +00:00
NEWS.pre-1-0 ooops, fogot this on my last commit... 1998-05-07 07:45:04 +00:00
README Fix srcdir != builddir 2000-11-14 16:38:04 +00:00
README.cvs-commits Fixed argument list and return type for non-XIM fallback. 1998-12-09 18:13:52 +00:00
README.in Adapt cast macros to standard. 1999-11-22 21:52:50 +00:00
README.nanox make it possible to configure gtk for different targets on the same 2000-06-07 16:44:29 +00:00
README.win32 Update. Mention the gtk-1-3-win32-production branch. 2001-02-23 03:51:41 +00:00
sanity_check [ Merges from gtk-1-2 ] 1999-09-28 20:19:13 +00:00
TODO Spelling/grammar fixes from Martin Buchholz <martin@xemacs.org> 2000-02-29 13:15:10 +00:00
TODO.xml Another test commit TODO.xml 2000-10-29 02:44:07 +00:00

General Information
===================

This is GTK+ version 1.3.2. GTK+, which stands for the Gimp ToolKit, 
is a library for creating graphical user interfaces for the X Window 
System. It is designed to be small, efficient, and flexible. GTK+ is 
written in C with a very object-oriented approach.

The official ftp site is:
  ftp://ftp.gtk.org/pub/gtk

The official web site is:
  http://www.gtk.org/

A mailing list is located at:
  gtk-list@redhat.com

To subscribe: mail -s subscribe gtk-list-request@redhat.com < /dev/null
(Send mail to gtk-list-request@redhat.com with the subject "subscribe")

Installation
============

See the file 'INSTALL'

How to report bugs
==================

Bugs should be reported to the GNOME bug tracking
system. (http://bugs.gnome.org). To report a problem
about GTK+, send mail to submit@bugs.gnome.org.

The subject of the mail should describe your problem.
In the body of the mail, you should first include
a "pseudo-header" that gives the package and 
version number. This should be separated by a blank
line from the actual headers.

 Package: gtk+
 Version: 1.3.2

[ Please substitute 1.3.2 with the version of GTK+ that
  you have installed ]

Then describe the bug. Include:

* 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. 

  If you can reproduce it with the testgtk program that is built 
  in the gtk/ subdirectory, that will 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 that can be downloaded.

  (Bugs that can be reproduced within the  GIMP are almost as good 
  as bugs that can be reproduced in testgtk. If you are reporting a 
  bug found with the GIMP, please include the version number of the GIMP 
  you are using)

* If the bug was a crash, the exact text that was printed out
  when the 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, it will be more useful if the stacktrace
  is produced running the test program with the --sync command
  line option.

An example of a bug report:

====
To: submit@bugs.gnome.org
From: yourname@your.address.org
Subject: handlebox test in testgtk is misnamed.

Package: gtk+
Version: 1.3.2

When I run gtk/testgtk, the button "handle box"
is misnamed. There are multiple handle boxes in
the demo, so it should be "handle boxes", to
be like "buttons" or "check buttons".
===

Patches
=======

Patches can be uploaded to the incoming/ directory on
ftp.gtk.org.  Please follow the instructions there, and include
your name and email address in the README file.

If the patch fixes a bug, it is usually a good idea to include
all the information described in "How to Report Bugs".