Additions.
[platform/upstream/glib.git] / README.in
index e530b0d..56ab9aa 100644 (file)
--- a/README.in
+++ b/README.in
@@ -24,26 +24,26 @@ Installation
 
 See the file 'INSTALL'
 
-Notes about GLib-2.0.0
+Notes about GLib-2.2.0
 ======================
 
-* On systems without the libintl from GNU gettext() or a recent version
-  of the GNU C library, the encoding of translated error messages will be 
-  incorrect (they should be in UTF-8). A workaround for this is to install 
-  GNU gettext and use that libintl. This is expected to be fixed in GLib-2.0.1.
-  Application programmers should not call g_locale_to_utf8() on these
-  strings.
+* 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:
 
-* The results of g_strerror() are currently in the encoding of the locale
-  rather than in UTF-8. Again, this is a bug, and not behavior that
-  should be relied upon.
+          http://www.math.keio.ac.jp/~matumoto/emt.html
 
-* Similarly, the GLib error logging functions such as g_print(), g_warning(),
-  g_error(), currently do not convert the strings they are passed from
-  UTF-8 to the encoding of the locale, or check that the strings they
-  are passed are valid UTF-8. They should, despite this, be assumed to take
-  UTF-8 arguments.
+  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
 ==================