# HG changeset patch
# User Thinker K.F. Li <thinker@branda.to>
# Date 1248593500 -28800
# Node ID 5791263ebe7bb8b199ad18627631516b55299696
# Parent  fef1b8076041e4c544c945e53b90afb82ea1d758
Document for why a shape should be managed by the redraw manager.

diff -r fef1b8076041 -r 5791263ebe7b include/mb_shapes.h
--- a/include/mb_shapes.h	Sun Jul 26 15:31:40 2009 +0800
+++ b/include/mb_shapes.h	Sun Jul 26 15:31:40 2009 +0800
@@ -41,6 +41,15 @@
  * redraw_man.c::clean_shape().  It's task is to update \ref geo_t of the
  * shape object.  In most situtation, it call geo_from_positions() to
  * update geo_t.
+ *
+ * \section rdman_man_shape Make a redraw manager managing a shape.
+ * 
+ * It means managing life cycle of a shape to make a redraw manager
+ * managing a shape.  Shapes are referenced by a redraw manager to
+ * update output device.  So, a redraw manager must make sure all
+ * shapes are valid when they are needed to update output.  To make sure
+ * lifecycle of shapes are synchronized with status of a redraw manager,
+ * lifecycle of shapes are managed by associated redraw manager.
  * 
  */