Improve repaint functions

It is sometimes useful to be able to have better control on when a
repaint function is called. Currently, all repaint functions are called
prior to the stages update phase of the frame processing.

We can introduce flags to represent the point in the frame update
process in which we wish Clutter called the repaint function.

As a bonus, we can also add a flag that causes adding a repaint function
to spin the master clock.

doc/reference/clutter/clutter-sections.txt

@@ -1296,6 +1296,7 @@ clutter_threads_add_timeout_full
 clutter_threads_add_frame_source
 clutter_threads_add_frame_source_full
 clutter_threads_add_repaint_func
+clutter_threads_add_repaint_func_full
 clutter_threads_remove_repaint_func
 
 <SUBSECTION>