GTK is a multi-platform toolkit for creating graphical user interfaces.
Go to file
Havoc Pennington fde4fecfd2 Port to GObject, can go back in gdk-pixbuf after setting up a
2000-12-16  Havoc Pennington  <hp@pobox.com>

* gtk/gdk-pixbuf-loader.h, gtk/gdk-pixbuf-loader.c:
Port to GObject, can go back in gdk-pixbuf after setting up
a gdk-pixbuf-marshal.h header over there.

* gtk/gtktreeview.c: s/SEPERATOR/SEPARATOR/g;
(gtk_tree_view_class_init): specify GTK_TYPE_ADJUSTMENT for signal
args
(gtk_tree_view_init): don't unset GTK_NO_WINDOW, it shouldn't be
set
(gtk_tree_view_realize_buttons): don't gtk_widget_show() buttons
here, do it when we create the buttons later
(gtk_tree_view_realize_buttons): add some g_return_if_fail
(gtk_tree_view_map): paranoia checks that column->button is shown
and unmapped
(gtk_tree_view_size_request): only request visible children.
Move header size calculation in here, for cleanliness, and
to maintain invariants for child widgets if we eventually
let users set different children inside the buttons
(gtk_tree_view_map_buttons): factor out code to map buttons,
since it was being called several times
(gtk_tree_view_size_allocate_buttons): move_resize the drag
windows instead of just moving them; their height may change
if we allow random widgets in there, or the theme changes.
(gtk_tree_view_size_allocate): move button size allocation
above emitting the scroll signals, to ensure a sane state when we
hit user code
(gtk_tree_view_button_release): remove queue_resize after
tree_view_set_size(), set_size() will handle any resize queuing
that's needed
(gtk_tree_view_focus_in): just queue a draw, don't fool with
draw_focus goo
(gtk_tree_view_focus): use gtk_get_current_event() and
gdk_event_get_state()
(gtk_tree_view_deleted): don't queue_resize() after calling set_size()
(gtk_tree_view_build_tree): fix a "if (foo); {}" bug - i.e. remove
semicolon
(gtk_tree_view_create_button): show the button here
(gtk_tree_view_button_clicked): actually emit the clicked signal
on the column
(_gtk_tree_view_set_size): return right away if the size is
unchanged, as a cheesy optimization
(gtk_tree_view_setup_model): rename set_model_realized to
setup_model to match the flag that indicates whether we've
called it
(gtk_tree_view_get_hadjustment): create adjustment if it doesn't
exist, because set_scroll_adjustment does that and it shouldn't
matter what order you call these in
(gtk_tree_view_get_vadjustment): ditto
(gtk_tree_view_set_headers_visible): canonicalize the bool,
for paranoia
(gtk_tree_view_set_headers_visible): call
gtk_tree_view_map_buttons() instead of using cut-and-paste code
(gtk_tree_view_append_column): clarify whether the return value
is the count of columns before or after, and do the increment
separately from the return statement so you can tell from the code.
(gtk_tree_view_remove_column): ditto
(gtk_tree_view_insert_column): ditto
(gtk_tree_view_get_column): remove g_return_if_fail for columns
outside the existing range, the docs say that outside-range
columns are allowed, so we handle them as documented. (Presumably
this allows a nice loop with column != NULL as test.)
(gtk_tree_view_move_to): document what 0.0, 0.5, 1.0 alignments
mean (left/right/center etc.).
(gtk_tree_view_collapse_all): only queue a draw if we're mapped
(gtk_tree_view_expand_row): add docs
(gtk_tree_view_collapse_row): add docs

* gtk/gtktreeviewcolumn.c (gtk_tree_view_column_clicked): new
function to emit the clicked signal on a column

* gdk/gdkevents.c (gdk_event_get_state): new function, to get the
state of an event
(gdk_event_get_time): don't treat GDK_SCROLL
as a button event, remove default case from switch so gcc
will whine if we don't explicitly handle all event types

* gtk/gtktreeselection.h: added some FIXME

* gtk/gtktreeprivate.h (struct _GtkTreeViewPrivate): rename
"columns" to "n_columns" and "column" to "columns" for clarity
2000-12-17 23:50:00 +00:00
contrib Massive .cvsignore updates 2000-10-23 14:43:16 +00:00
debian Argh. Missed one dumb space in rules file. Fixed. 1998-11-18 06:25:35 +00:00
demos General cleanup of the log attr iteration stuff. This should make e.g. the 2000-12-16 07:01:48 +00:00
docs Add support for ps2 intellimouse. 2000-12-13 10:03:16 +00:00
examples New section on GtkCalendar Update example code 2000-02-23 10:59:21 +00:00
gdk Port to GObject, can go back in gdk-pixbuf after setting up a 2000-12-17 23:50:00 +00:00
gdk-pixbuf Port to GObject, can go back in gdk-pixbuf after setting up a 2000-12-17 23:50:00 +00:00
gtk Port to GObject, can go back in gdk-pixbuf after setting up a 2000-12-17 23:50:00 +00:00
m4macros Really release 1.3.1 2000-07-15 01:07:42 +00:00
modules Add focus_in and focus_out implementation to im_context_class as 2000-12-09 01:06:55 +00:00
po Simplify, now that the .po files are already in UTF-8. 2000-12-14 21:15:05 +00:00
tests General cleanup of the log attr iteration stuff. This should make e.g. the 2000-12-16 07:01:48 +00:00
.cvsignore Massive .cvsignore updates 2000-10-23 14:43:16 +00:00
acconfig.h Add two virtualized functions gdk_drawable_get_clip_region - to get the 2000-12-15 01:46:41 +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 Port to GObject, can go back in gdk-pixbuf after setting up a 2000-12-17 23:50:00 +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 Port to GObject, can go back in gdk-pixbuf after setting up a 2000-12-17 23:50:00 +00:00
ChangeLog.pre-2-2 Port to GObject, can go back in gdk-pixbuf after setting up a 2000-12-17 23:50:00 +00:00
ChangeLog.pre-2-4 Port to GObject, can go back in gdk-pixbuf after setting up a 2000-12-17 23:50:00 +00:00
ChangeLog.pre-2-6 Port to GObject, can go back in gdk-pixbuf after setting up a 2000-12-17 23:50:00 +00:00
ChangeLog.pre-2-8 Port to GObject, can go back in gdk-pixbuf after setting up a 2000-12-17 23:50:00 +00:00
ChangeLog.pre-2-10 Port to GObject, can go back in gdk-pixbuf after setting up a 2000-12-17 23:50:00 +00:00
config.guess Merges from gtk-1-2 2000-03-14 19:57:25 +00:00
config.h.win32 Guard definition of alloca(). glib.h now handles that. 2000-10-03 21:00:49 +00:00
config.sub Merges from gtk-1-2 2000-03-14 19:57:25 +00:00
configure.in only AC_DEFINE(HAVE_XFT) if we actually determined that we have Xrender 2000-12-15 03:16:35 +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 New function to create a pixbuf pointing to a subregion of another pixbuf. 2000-11-01 07:07:46 +00:00
gdk-pixbuf-2.0.pc.in Put the pkg-config scripts back to the correct pkg-config syntax 2000-09-30 02:14:04 +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 Put the pkg-config scripts back to the correct pkg-config syntax 2000-09-30 02:14:04 +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 Released 1.3.2 2000-11-18 01:49:13 +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. 2000-10-09 19:49:42 +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".