[clutter/wip/backend-next] docs: Update the release notes in the README

[Emmanuele Bassi <ebassi src gnome org>]

commit 2dac5370ed207cf51f319d279d97a7ecb1ee8ad2
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Mon Nov 7 19:06:22 2011 +0000

    docs: Update the release notes in the README

 README.in |   79 +++++++++++++++++++++++++++++++++++++++++++++++++++++-------
 1 files changed, 69 insertions(+), 10 deletions(-)
---
diff --git a/README.in b/README.in
index 3a10eae..8d2c466 100644
--- a/README.in
+++ b/README.in
@@ -16,7 +16,7 @@ Clutter currently requires:
   â Cairo â @CAIRO_REQ_VERSION@
   â PangoCairo â @PANGO_REQ_VERSION@
 
-On X11, Clutter depends on the following extensions
+When building the X11 backend, Clutter depends on the following extensions:
 
   â XComposite â @XCOMPOSITE_REQ_VERSION@
   â XDamage
@@ -25,6 +25,19 @@ On X11, Clutter depends on the following extensions
   â XInput (1.x or 2.x)
   â XKB
 
+When building the Wayland backend, Clutter also depends on:
+
+  â wayland-client
+  â xkbcommon
+
+When building the GDK backend, Clutter also depends on:
+
+  â gdk-3.0 > @GDK_REQ_VERSION@
+
+When building the CEx100 backend, Clutter also depends on:
+
+  â libgdl
+
 If you are building the API reference you will also need:
 
   â GTK-Doc â @GTK_DOC_REQ_VERSION@
@@ -109,7 +122,7 @@ See also the wiki page:
 
 Clutter has additional command line options for the configure script:
 
- --enable-debug=[no/minimum/yes/error]
+ --enable-debug=[no/minimum/yes]
 	Controls Clutter debugging level:
 
 	yes:
@@ -170,19 +183,19 @@ Clutter has additional command line options for the configure script:
         Enable the GDK backend. (default=check)
 
  --enable-wayland-backend=[yes/no]
-        Enable the Wayland client backend. (default=no)
+        Enable the Wayland client backend. (default=no) [EXPERIMENTAL]
+
+ --enable-cex100-backend=[yes/no]
+        Enable the CEx100 platform backend. (default=no) [EXPERIMENTAL]
 
  --enable-egl-backend=[yes/no]
         Enable the EGL framebuffer backend. (default=no)
 
- --with-tslib=[yes/no]
-        Use TSLib for the input events. (default=yes)
-
- --with-evdev=[yes/no]
-        Use evdev for the input events. (default=yes)
+ --enable-tslib-input=[yes/no]
+        Enable the TSLib input backend. (default=no) [EXPERIMENTAL]
 
- --with-gdl=[yes/no]
-        Use libgdl for CEx100 platforms. (default=no)
+ --enable-evdev-input=[yes/no/check]
+        Enable the evdev input backend. (default=check) [EXPERIMENTAL]
 
 See also the INSTALL file generated by autotools for further information.
 
@@ -273,6 +286,52 @@ Relevant information for developers with existing Clutter applications
 wanting to port to newer releases (see NEWS for general information on new
 features).
 
+Release Notes for Clutter 1.10
+-------------------------------------------------------------------------------
+
+â Clutter can support multiple backends in the same shared library. Only one
+  windowing or input backend can be used at run time. As a result of this
+  change, the shared library name used by Clutter has changed from:
+
+        libclutter-<flavour>-<API version>.so
+
+  to:
+
+        libclutter-<API version>.so
+
+  The pkg-config file has been updated accordingly. Until the next major API
+  break, Clutter will ship compatibility links for all the previous "flavours"
+  that were available in versions < 1.10; this allows applications dynamically
+  linking against Clutter, or using dlopen(), to keep working. For libraries
+  and applications dynamically linking against Clutter, though, it is still
+  recommended to recompile to make sure that the most recent version is being
+  used. Language bindings using GObject Introspection will automatically use
+  the new shared library without requiring any change.
+
+â The windowing system backend for the CE3100 and CE4100 platforms using the
+  libgdl library is now implemented as a separate backend instance, instead
+  of being a sub-flavour of the EGL native framebuffer backend. This change
+  introduces a new header file, under $includedir/clutter-1.0/clutter/cex100,
+  which should be included to access the CEx100-specific API. The API and
+  ABI of the platform API has not been changed, though it should still be
+  considered experimental.
+
+â As of 1.10 it is not necessary any more to call clutter_threads_init() to
+  initialize threading support in Clutter; after the changes in GLib 2.32,
+  threading support in Clutter is always enabled. The rules on how to use
+  Clutter from multiple threads haven't changed.
+
+â Deprecated API is now marked using the CLUTTER_DEPRECATED and the
+  CLUTTER_DEPRECATED_FOR annotations; these two annotations will result in
+  compiler warnings when attempting to use the deprecated API. It is possible
+  to disable deprecation warnings for Clutter by defining the
+  CLUTTER_DISABLE_DEPRECATION_WARNINGS symbol when compiling. The previous
+  deprecation symbol, CLUTTER_DISABLE_DEPRECATED, is only used for macros.
+
+â Deprecated functionality has been moved to separate header files, installed
+  under the $includedir/clutter-1.0/clutter/deprecated directory. These files
+  are still included by default by clutter/clutter.h.
+
 Release Notes for Clutter 1.8
 -------------------------------------------------------------------------------