README

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

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