From 89644ae0488951015e44e864a3cc6840c207357c Mon Sep 17 00:00:00 2001 From: Emmanuele Bassi Date: Mon, 7 Nov 2011 19:06:22 +0000 Subject: [PATCH] docs: Update the release notes in the README --- README.in | 79 +++++++++++++++++++++++++++++++++++++++++++++++++++++++-------- 1 file 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--.so + + to: + + libclutter-.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 ------------------------------------------------------------------------------- -- 2.7.4