updated externals
[platform/upstream/glib.git] / README.in
index 5e82ddb..56ab9aa 100644 (file)
--- a/README.in
+++ b/README.in
@@ -1,21 +1,11 @@
- *** IMPORTANT *** 
-
-This is a development version of GLib.  You should be using a stable
-version, which is available at ftp://ftp.gtk.org/pub/gtk/v1.2/.  This
-version is meant for developers of GLib only:
-
- * You should not base stable software on this version of GLib.
- * GNOME developers should use a stable version of GLib.
-
-*** You should be using GLib 1.2 instead. ***
-
-
 General Information
 ===================
 
-This is GLib version @GLIB_VERSION@. GLib is a library which includes support
-routines for C such as lists, trees, hashes, memory allocation, and
-many other things.
+This is GLib version @GLIB_VERSION@. GLib is the low-level core
+library that forms the basis for projects such as GTK+ and GNOME. It
+provides data structure handling for C, portability wrappers, and
+interfaces for such runtime functionality as an event loop, threads,
+dynamic loading, and an object system.
 
 The official ftp site is:
   ftp://ftp.gtk.org/pub/gtk
@@ -34,6 +24,27 @@ Installation
 
 See the file 'INSTALL'
 
+Notes about GLib-2.2.0
+======================
+
+* GLib changed the seeding algorithm for the pseudo-random number
+  generator Mersenne Twister, as used by GRand and GRandom. This was
+  necessary, because some seeds would yield very bad pseudo-random
+  streams. Further information can be found at:
+
+          http://www.math.keio.ac.jp/~matumoto/emt.html
+
+  Also the pseudo-random integers generated by g_rand_int_range and 
+  g_random_int_range will have a slightly better equal distribution
+  with the new version of GLib.
+  The original algorithms, as found in GLib-2.0.x, can be used instead
+  of the new ones by setting the environment variable G_RANDOM_VERSION
+  to the value of "2.0".
+
+  Use the GLib-2.0 algorithms only if you have sequences of numbers
+  generated with Glib-2.0 that you need to reproduce exactly.
+
 How to report bugs
 ==================