]> Pileus Git - ~andy/gtk/blob - README
Final updates for 2.0.0
[~andy/gtk] / README
1 General Information
2 ===================
3
4 This is GTK+ version 2.0.0. GTK+ is a multi-platform toolkit
5 for creating graphical user interfaces. Offering a complete set of
6 widgets, GTK+ is suitable for projects ranging from small one-off
7 projects to complete application suites.
8
9 GTK+ is free software and part of the GNU Project. However, the
10 licensing terms for GTK+, the GNU LGPL, allow it to be used by all
11 developers, including those developing proprietary software, without
12 any license fees or royalties.
13
14 The official ftp site is:
15   ftp://ftp.gtk.org/pub/gtk
16
17 The official web site is:
18   http://www.gtk.org/
19
20 Information about mailing lists can be found at
21   http://www.gtk.org/mailinglists.html
22
23 Installation
24 ============
25
26 See the file 'INSTALL'
27
28 How to report bugs
29 ==================
30
31 Bugs should be reported to the GNOME bug tracking system. 
32 (http://bugzilla.gnome.org, product gtk+.) You will need
33 to create an account for yourself.
34   
35 In the bug report please include:
36   
37 * Information about your system. For instance:
38
39    - What operating system and version
40    - What version of X
41    - For Linux, what version of the C library
42
43   And anything else you think is relevant.
44
45 * How to reproduce the bug. 
46
47   If you can reproduce it with the testgtk program that is built 
48   in the gtk/ subdirectory, that will be most convenient.  Otherwise, 
49   please include a short test program that exhibits the behavior. 
50   As a last resort, you can also provide a pointer to a larger piece 
51   of software that can be downloaded.
52
53 * If the bug was a crash, the exact text that was printed out
54   when the crash occured.
55
56 * Further information such as stack traces may be useful, but
57   is not necessary. If you do send a stack trace, and the error
58   is an X error, it will be more useful if the stacktrace
59   is produced running the test program with the --sync command
60   line option.
61
62 Patches
63 =======
64
65 Patches should also be submitted to bugzilla.gnome.org. If the
66 patch fixes an existing bug, add the patch as an attachment
67 to that bug report.
68
69 Otherwise, enter a new bug report that describes the patch,
70 and attach the patch to that bug report.
71
72 Bug reports containing patches should include the PATCH keyword
73 in their keyword fields. If the patch adds to or changes the GTK
74 programming interface, the API keyword should also be included.
75   
76 Patches should be in unified diff form. (The -u option to GNU
77 diff.)