0
@@ -2,4 +2,5 @@ Matthew Allum <mallum@o-hand.com> - primary authour
0
 Emmanuele Bassi <ebassi@o-hand.com> - python bindings, gobject/glib mastery
0
 Iain Holmes <iain@o-hand.com> - GTK Clutter widget
0
 Jorn Baayen <jorn@o-hand.com> - Gstreamer bits
0
-Tomas Frydrych <tf@o-hand.com> - Fixed point magic
0
+Tomas Frydrych <tf@o-hand.com> - Fixed point + behaviour + maths magic
0
+Neil Patel <neil@o-hand.com> - ClutterEntry, lots of API stress testing.
0
\ No newline at end of file

0
@@ -1,3 +1,13 @@
0
+2007-07-30  Matthew Allum  <mallum@openedhand.com>
0
+
0
+	* AUTHORS:
0
+	* HACKING:
0
+	* README:
0
+	Various updates and improvements.
0
+
0
+	* configure.ac:
0
+	Remove --disable-fast-fp-conversions
0
+
0
 2007-07-30  Tomas Frydrych  <tf@openedhand.com>
0
 
0
   * clutter/clutter-behaviour-ellipse:

0
@@ -1,9 +1,14 @@
0
+GENERAL
0
+=======
0
+
0
 General notes and rules on clutter core hacking;
0
 
0
  - GNU style indentation, please wrap at 80 chars. 
0
 
0
+ - All non static public API funcs should be documented in the .c via gtk-doc
0
+
0
  - All public functions with float parameters should also provide a fixed
0
-   point version.
0
+   point version. Fixed point should be used internally.
0
 
0
  - Propertys should always be float (never fixed). 
0
 
0
@@ -13,3 +18,34 @@ General notes and rules on clutter core hacking;
0
 
0
  - Dont add direct GL calls but wrap with cogl (also adding GL ES Version)
0
 
0
+ - Use CLUTTER_NOTE() macro for debug statements.
0
+
0
+ - New features should also include an exhaustive test in tests/
0
+
0
+
0
+RELEASES
0
+========
0
+
0
+In making a new release;
0
+
0
+ - Check out a fresh copy from SVN.
0
+
0
+ - verify versioning in configure.ac, increasing relevant
0
+   clutter_major_version/clutter_minor_version/clutter_micro_version
0
+   value.
0
+
0
+ - Update NEWS (New feature details, bug #'s), README (Any API changes
0
+   relevant to developers + version), AUTHORS if relevant.
0
+
0
+ - Add a Release entry to the ChangeLog noting version.
0
+
0
+ - make distcheck and fix if fails. 
0
+
0
+ - commit.
0
+
0
+ - Make tarballs, upload.
0
+ 
0
+ - Announce release to waiting world on blog and mailing list.
0
+
0
+ - Release any dependant add-ons following similar rules to above. 
0
+   Dont forget to check *.pc file version deps!
0
\ No newline at end of file

0
@@ -25,15 +25,109 @@ New bug page on Bugzilla:
0
 
0
 Clutter is LGPL licensed.
0
 
0
+
0
 INSTALLATION
0
 ====
0
-See the INSTALL file
0
+
0
+See the INSTALL file. Info on specific Clutter options;
0
+
0
+ --enable-debug=[no/minimum/yes]
0
+	Turn on debugging (default=yes):
0
+	  yes: All glib asserts, checks and runtime clutter verbose messages. 
0
+          minimum: Just glib cast checks and runtime clutter verbose messagaes.
0
+          no: No glib asserts or checks and no runtime clutter verbose messages
0
+	      (Only really of use in extreme performance cases)
0
+
0
+ --enable-maintainer-flags=[no/yes]
0
+        Use strict compiler flags (default=no)
0
+
0
+ --enable-gtk-doc        
0
+	use gtk-doc to build API documentation (default=no). Requires gtk-doc 
0
+	present on system
0
+
0
+ --enable-manual=[no/yes]
0
+        Build application developers manual. Requires jw and xmlto binaries.
0
+	Presently incomplete.
0
+
0
+  --without-fpu           
0
+	Assume target hardware has no floating point unit. Useful only
0
+	for embedded targets such as ARM.
0
+
0
+  --with-flavour=[glx/eglx/eglnative/sdl]
0
+        Select the Clutter backend: (defualt=glx)
0
+
0
+	  glx: Fully featured GLX backend. Using Open GL.
0
+
0
+	  eglx: EGL/Open GL ES backend for EGL on X windows implementations
0
+		(experimental)
0
+
0
+	  eglnative: EGL/Open GL ES backend on 'native windowing system' - i.e
0
+		     raw framebuffer. Expects EGL implementation to provide a 
0
+		     createNativeWindow () call. Also optionally supports 
0
+		     tslib for touchscreen events.
0
+		     (experimental)
0
+
0
+	  sdl: Basic SDL backend, using Open GL. Should provide portability
0
+	       to windows and possibly other OS's. 
0
+
0
+
0
+VERSIONING
0
+====
0
+
0
+Clutter uses the common "Linux kernel" versioning system, where
0
+even-numbered minor versions are stable and odd-numbered minor
0
+versions are development snapshots.
0
+
0
+Different Minor versions break both API and ABI but are paralell
0
+installable. The same Minor version with differing Micro version is
0
+expected to be ABI compatible with other micro versions. Though this
0
+is not guarenteed, especially for odd numbered minor releases, we'll
0
+try our very hardest (promise).
0
+
0
+
0
+HACKING
0
+====
0
+
0
+If you want to hack on and improve clutter check the contained TODO
0
+file for pending tasks and HACKING for general coding guidelines.
0
+
0
+
0
+BUGS
0
+====
0
+Bugs should be reported to the OpenedHand Bugzilla at:
0
+
0
+  http://bugzilla.o-hand.com/enter_bug.cgi?product=Clutter
0
+
0
+You will need an account.
0
+
0
+In the report you should include:
0
+* what system you're running Clutter on;
0
+* which version of GLib, GdkPixbuf and OpenGL you are using;
0
+* which video card and which drivers you are using, including output of
0
+  glxinfo and xdpyinfo.
0
+* how to reproduce the bug.
0
+
0
+If you cannot reproduce the bug with one of the tests that come with Clutter
0
+source code, you should include a small test case displaying the bad
0
+behaviour.
0
+
0
+If the bug exposes a crash, the exact text printed out and a stack trace
0
+obtained using gdb are greatly appreciated.
0
+
0
+
0
+PATCHES
0
+====
0
+Patches should be submitted using Bugzilla. Patches fixing a bug should be
0
+attached to the bug report; patches for new features or for fixing bugs not
0
+yet reported should be attached to a newly opened bug. Patches should always
0
+be in the unified diff format.
0
+
0
 
0
 RELEASE NOTES
0
 ====
0
 
0
 Relevant information for developers with existing Clutter applications
0
-wanting to port to newer releases;
0
+wanting to port to newer releases (See NEWS for general new feature info).
0
 
0
 Release Notes for Clutter 0.3.1
0
 -------------------------------
0
@@ -109,35 +203,3 @@ Release Notes for Clutter 0.3
0
   ClutterContainer::actor-added and ClutterContainer::actor-removed should
0
   be used instead.
0
 
0
-HACKING
0
-====
0
-If you want to hack on and improve clutter check the TODO file.
0
-
0
-BUGS
0
-====
0
-Bugs should be reported to the OpenedHand Bugzilla at:
0
-
0
-  http://bugzilla.o-hand.com/enter_bug.cgi?product=Clutter
0
-
0
-You will need an account.
0
-
0
-In the report you should include:
0
-* what system you're running Clutter on;
0
-* which version of GLib, GdkPixbuf and OpenGL you are using;
0
-* which video card and which drivers you are using, including output of
0
-  glxinfo and xdpyinfo.
0
-* how to reproduce the bug.
0
-
0
-If you cannot reproduce the bug with one of the tests that come with Clutter
0
-source code, you should include a small test case displaying the bad
0
-behaviour.
0
-
0
-If the bug exposes a crash, the exact text printed out and a stack trace
0
-obtained using gdb are greatly appreciated.
0
-
0
-PATCHES
0
-====
0
-Patches should be submitted using Bugzilla. Patches fixing a bug should be
0
-attached to the bug report; patches for new features or for fixing bugs not
0
-yet reported should be attached to a newly opened bug. Patches should always
0
-be in the unified diff format.

0
@@ -299,22 +299,6 @@ fi
0
 
0
 AC_SUBST(CLUTTER_DEBUG_CFLAGS)
0
 
0
-dnl = Disable fast floating point conversions ==============================
0
-
0
-AC_ARG_ENABLE(fast-fp-conversions,
0
-              AC_HELP_STRING([--disable-fast-fp-conversions=@<:@no/yes@:>@],
0
-                             [Turn off fast conversion from floating point to int. no: fast floating point conversion are enabled. yes: fast floating point conversions are disabled.  @<:@default=no@:>@]),
0
-,
0
-              enable_fast_fp_conversions=yes)
0
-
0
-if test "x$enable_fast_fp_conversions" = "xno"; then
0
-   FIXED_POINT_CFLAGS="$FIXED_POINT_CFLAGS -DCFX_NO_FAST_CONVERSIONS"
0
-else
0
-   FIXED_POINT_CFLAGS="$FIXED_POINT_CFLAGS -UCFX_NO_FAST_CONVERSIONS"
0
-fi
0
-
0
-AC_SUBST(FIXED_POINT_CFLAGS)
0
-
0
 dnl = Enable strict compiler flags =========================================
0
 
0
 # use strict compiler flags only on development releases
0
@@ -360,9 +344,7 @@ dnl ========================================================================
0
 
0
 AC_SUBST(GCC_FLAGS)
0
 
0
-CLUTTER_CFLAGS="$SDL_CFLAGS $EGL_CFLAGS $GLX_CFLAGS $CLUTTER_DEPS_CFLAGS \
0
-                $FIXED_POINT_CFLAGS"
0
-
0
+CLUTTER_CFLAGS="$SDL_CFLAGS $EGL_CFLAGS $GLX_CFLAGS $CLUTTER_DEPS_CFLAGS "
0
 CLUTTER_LIBS="$SDL_LIBS $EGL_LIBS $GLX_LIBS $CLUTTER_DEPS_LIBS"
0
 
0
 AC_SUBST(CLUTTER_CFLAGS)