From fab38ef58bd90a7c644e292cad9430291cf9f9ba Mon Sep 17 00:00:00 2001
From: Carsten Haitzler <raster@rasterman.com>
Date: Mon, 9 Dec 2002 23:00:10 +0000
Subject: [PATCH] update todo...

SVN revision: 6483
---
 legacy/evas/evas.c.in                  |  6 ++++--
 legacy/evas/src/lib/canvas/evas_clip.c | 22 ++++++++++++++++++++++
 2 files changed, 26 insertions(+), 2 deletions(-)

diff --git a/legacy/evas/evas.c.in b/legacy/evas/evas.c.in
index a3b97af124..0e16079602 100644
--- a/legacy/evas/evas.c.in
+++ b/legacy/evas/evas.c.in
@@ -238,6 +238,8 @@ To be documented...
 
 
 @todo Document API
+@todo Add callback "piggyback" handlers for move, resize, show and hide
+@todo Add generic object method call system
 @todo Add keyboard callbacks/event feeds and focus
 @todo Make freetype optional and put in optional graymap font engine
 @todo Add ability to check image comments & disk format
@@ -250,8 +252,8 @@ To be documented...
 @todo Add memory use reduction code if any allocations fail
 @todo If image loads fails due to memory allocatue failure, load reduced res version
 @todo If image load fails due to memory allocation failure, try split it up into tiles and demand-load them
-@todo Add auto-detection of what engines to build based on system/libs etc.
-@todo Add overall engine configure parameters (so you can configure an engine with defaults with 1 configure option)
+@todo Add auto-detection of what engines to build based on system/libs etc. for configure script
+@todo Add overall engine configure parameters (so you can configure an engine with defaults with 1 configure option) to configure script
 @todo Document Engine API
 @todo Add external image loaders (application provided callbacks to load)
 @todo Add loadable image loader module support (evas loads file.so)
diff --git a/legacy/evas/src/lib/canvas/evas_clip.c b/legacy/evas/src/lib/canvas/evas_clip.c
index 5a53820307..2b1d5b8a50 100644
--- a/legacy/evas/src/lib/canvas/evas_clip.c
+++ b/legacy/evas/src/lib/canvas/evas_clip.c
@@ -84,6 +84,28 @@ evas_object_clippers_was_visible(Evas_Object *obj)
 
 /* public functions */
 
+/**
+ * Clip one object to another
+ * @param obj The object to be clipped
+ * @param clip The object to clip @p obj by
+ * 
+ * This function will clip the object @p obj to the area occupied by the
+ * object @p clipper.
+ * 
+ * Example:
+ * @code
+ * extern Evas *evas;
+ * extern Evas_Object *obj;
+ * Evas_Object *clipper;
+ * 
+ * clipper = evas_object_rectangle_add(evas);
+ * evas_object_color_ser(clipper, 255, 255, 255, 255);
+ * evas_object_move(clipper, 10, 10);
+ * evas_object_resize(clipper, 20, 50);
+ * evas_object_clip_set(obj, clipper);
+ * evas_object_show(clipper);
+ * @endcode
+ */
 void
 evas_object_clip_set(Evas_Object *obj, Evas_Object *clip)
 {