Include gdkprivate.h withouh gdk/ path, as it shouldn't be in the common

[~andy/gtk] / README

diff --git a/README b/README
index b5f8e4bbd2381f75ab7381407fafff2ef9254aa2..cdba4eb96192a8a383c330cbeb3895580f6bf8fe 100644 (file)
--- a/README
+++ b/README
@@ -1,14 +1,16 @@
 General Information
 ===================
 
-This is GTK+ version 1.0.0.   GTK, which stands for the Gimp ToolKit, 
-is a library for creating graphical user interfaces.  
+This is GTK+ version 1.2.0.   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.gimp.org/pub/gtk
+  ftp://ftp.gtk.org/pub/gtk
 
 The official web site is:
-  http://www.gimp.org/gtk
+  http://www.gtk.org/
 
 A mailing list is located at:
   gtk-list@redhat.com
@@ -24,13 +26,23 @@ See the file 'INSTALL'
 How to report bugs
 ==================
 
-To report a bug, send mail either to gtk-list, as mentioned
-above, or to gtk-bugs@gtk.org. If you send mail to gtk-list, you
-must be subscribed yourself.
+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.
 
-In the mail include:
+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.
 
-* The version of GTK
+ Package: gtk+
+ Version: 1.2.0
+
+[ Please substitute 1.2.0 with the version of GTK+ that
+  you have installed ]
+
+Then describe the bug. Include:
 
 * Information about your system. For instance:
 
@@ -62,6 +74,22 @@ In the mail include:
   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.2.0
+
+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
 =======
 
@@ -70,4 +98,4 @@ 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".
\ No newline at end of file
+all the information described in "How to Report Bugs".