The usual docs unbreaking...
[platform/upstream/glib.git] / README.in
index 9c9a966..8ae830b 100644 (file)
--- a/README.in
+++ b/README.in
@@ -28,7 +28,17 @@ Notes about GLib 2.32
 =====================
 
 * It is no longer necessary to use g_thread_init() or to link against
-  libgthread.  libglib is now always thread-enabled.
+  libgthread.  libglib is now always thread-enabled.  Custom thread
+  system implementations are no longer supported (including errorcheck
+  mutexes).
+
+* The thread and synchronisation APIs have been updated.
+  GMutex and GCond can be statically allocated without explicit
+  initialisation, as can new types GRWLock and GRecMutex.  The
+  GStatic_______ variants of these types have been deprecated.  GPrivate
+  can also be statically allocated and has a nicer API (deprecating
+  GStaticPrivate).  Finally, g_thread_create() has been replaced with a
+  substantially simplified g_thread_new().
 
 * The g_once_init_enter()/_leave() functions have been replaced with
   macros that allow for a pointer to any gsize-sized object, not just a
@@ -36,6 +46,23 @@ Notes about GLib 2.32
   object is being used will not work with generic pointers (ie: (void*)
   and (gpointer) casts) which would have worked with the old version.
 
+* It is now mandatory to include glib.h instead of individual headers.
+
+* The -uninstalled variants of the pkg-config files have been dropped.
+
+* For a long time, gobject-2.0.pc mistakenly declared a public
+  dependency on gthread-2.0.pc (when the dependency should have been
+  private).  This means that programs got away with calling
+  g_thread_init() without explicitly listing gthread-2.0.pc among their
+  dependencies.
+
+  gthread has now been removed as a gobject dependency, which will cause
+  such programs to break.
+
+  The fix for this problem is either to declare an explicit dependency
+  on gthread-2.0.pc (if you care about compatibility with older GLib
+  versions) or to stop calling g_thread_init().
+
 Notes about GLib 2.30
 =====================