General Information

===================

This is GTK+ version 3.22.30. 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.

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

developers, including those developing proprietary software, without any

license fees or royalties.

The official download locations are:

  ftp://ftp.gtk.org/pub/gtk

  http://download.gnome.org/sources/gtk+

The official web site is:

  http://www.gtk.org/

Information about mailing lists can be found at

  http://www.gtk.org/mailing-lists.php

Installation

============

See the file 'INSTALL'

How to report bugs

==================

Bugs should be reported to the GNOME bug tracking system.

(http://bugzilla.gnome.org, product glib.) You will need

to create an account for yourself.

In the bug report please include:

* Information about your system. For instance:

   - What operating system and version

   - 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 one of the test programs that are built

  in the tests/ 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.

* If the bug was a crash, the exact text that was printed out

  when the crash occurred.

* Further information such as stack traces may be useful, but

  is not necessary.

Patches

=======

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.

Otherwise, enter a new bug report that describes the patch,

and attach the patch to that bug report.

Patches should be in unified diff form. (The -up option to GNU diff)

Even better are git-formatted patches. (Use git format-patch)

Release notes

=============

Release notes for releases of GTK+ 3.x are part of the migration

guide in the GTK+ documentation. See

https://developer.gnome.org/gtk3/unstable/gtk-migrating-2-to-3.html