1 files changed, 61 insertions, 0 deletions
diff --git a/doc/API b/doc/API
new file mode 100644
index 000000000..129faa6b6
--- /dev/null
+++ b/doc/API
@@ -0,0 +1,61 @@
+
+Sodipodi API's
+--------------
+
+This file identifies and discusses various Application Programming
+Interfaces (API's) that exist in the codebase.  This is not intended to
+serve as a complete reference but as a high level overview; details
+should be sought from the appropriate code units.
+
+Stable API's
+============
+
+
+Unstable API's
+==============
+Objects and API-s mentioned here, even if implemented,
+may change without notice.
+
+Special item classes
+~~~~~~~~~~~~~~~~~~~~
+SPGroup::SPBinder
+A group with special children
+For example - blender
+1. first
+2. second
+3... intermediate
+
+Sodipodi New Object Tree TM
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Caution: This does not follow necessarily the Real (TM) implementation
+logic.  This should be updated to capture the correct stuff.
+
+ SPItem
+ Virtual methods:
+    void update (gdouble affine[]);
+    void bbox ();
+    void print (GnomePrintContext * gpc);
+    gchar * description ();
+    void read ();
+    read_attr (const gchar * attr)
+    GnomeCanvasItem * show (GnomeCanvasGroup * canvas_group, gpointer event_handler);
+    hide (GnomeCanvas * canvas)
+    paint (ArtPixBuf * buf, double affine[]);
+ Signals:
+ Methods:
+    SPRepr * sp_item_repr ()
+    SPItem * sp_item_parent ()
+
+ Constructors:
+    sp_item_new (SPRepr * repr);
+
+ Destructors:
+    sp_item_destroy (SPItem * item);
+
+ Derivatives:
+
+    SPGroup -> SPDocument
+    SPImage
+    SPPath -> SPShape -> SPRect
+                      -> SPEllipse
+		      -> SPChars -> SPText