diff --git a/src/lib/ector/ector_renderer.eo b/src/lib/ector/ector_renderer.eo
index e14f9633a3..d742be1c98 100644
--- a/src/lib/ector/ector_renderer.eo
+++ b/src/lib/ector/ector_renderer.eo
@@ -28,22 +28,24 @@ abstract Ector.Renderer (Efl.Object)
 	 }
       }
       @property transformation {
+      	 [[Transformation property]]
          set {
 	 }
 	 get {
 	 }
 	 values {
-	    m: ptr(const(Eina.Matrix3));
+	    m: ptr(const(Eina.Matrix3)); [[Transformation matrix]]
 	 }
       }
       @property origin {
+      	 [[Renderer origin]]
          set {
 	 }
 	 get {
 	 }
 	 values {
-	    x: double;
-	    y: double;
+	    x: double; [[X coordinate]]
+	    y: double; [[Y coordinate]]
 	 }
       }
       @property visibility {
@@ -53,7 +55,7 @@ abstract Ector.Renderer (Efl.Object)
 	 get {
 	 }
 	 values {
-	    v: bool; [[true if to make the object visible, false otherwise]]
+	    v: bool; [[$true if to make the object visible, $false otherwise]]
 	 }
       }
       @property color {
@@ -80,12 +82,13 @@ abstract Ector.Renderer (Efl.Object)
 	 }
       }
       @property mask {
+      	 [[Rendering mask]]
          set {
 	 }
 	 get {
 	 }
 	 values {
-	    r: Ector.Renderer;
+	    r: Ector.Renderer; [[Rendering mask]]
 	 }
       }
       @property quality {
@@ -111,20 +114,21 @@ abstract Ector.Renderer (Efl.Object)
 	 }
       }
       draw @virtual_pure {
-         return: bool;
+      	 [[Actual draw operation]]
+         return: bool; [[$true on success, $false otherwise]]
 	 params {
-	    @in op: Efl.Gfx.Render_Op;
-	    @in clips: array<ptr(Eina.Rectangle)>; [[array of @Eina.Rectangle clip]]
-	    @in mul_col: uint;
+	    @in op: Efl.Gfx.Render_Op; [[Renderer operation]]
+	    @in clips: array<ptr(Eina.Rectangle)>; [[Array of @Eina.Rectangle clip]]
+	    @in mul_col: uint; [[Premultiplied color]] 
 	 }
       }
       prepare {
-         return: bool;
-	 params {
-	 }
+      	 [[Prepare for rendering]]
+         return: bool; [[$true on success, $false otherwise]]
       }
       done @virtual_pure {
-         return: bool;
+      	 [[Done with rendering]]
+         return: bool; [[$true on success, $false otherwise]]
       }
    }
    implements {
diff --git a/src/lib/ector/ector_renderer_buffer.eo b/src/lib/ector/ector_renderer_buffer.eo
index 27e1eb5c5c..58bd90282b 100644
--- a/src/lib/ector/ector_renderer_buffer.eo
+++ b/src/lib/ector/ector_renderer_buffer.eo
@@ -7,7 +7,7 @@ mixin Ector.Renderer.Buffer (Efl.Interface, Ector.Renderer, Efl.Gfx.Fill)
 	 set { [[Sets the source buffer for this renderer, adds a ref]] }
 	 get { [[Return the current source, no ref change]] }
 	 values {
-	    buf: Ector.Buffer;
+	    buf: Ector.Buffer; [[Buffer]]
 	 }
       }
    }
diff --git a/src/lib/ector/ector_renderer_shape.eo b/src/lib/ector/ector_renderer_shape.eo
index c030c3f98e..73d1676c9c 100644
--- a/src/lib/ector/ector_renderer_shape.eo
+++ b/src/lib/ector/ector_renderer_shape.eo
@@ -6,30 +6,33 @@ mixin Ector.Renderer.Shape (Efl.Gfx.Shape)
    eo_prefix: ector_renderer_shape;
    methods {
       @property fill {
+      	 [[Fill property]]
          set {
 	 }
 	 get {
 	 }
 	 values {
-	    r: const(Ector.Renderer);
+	    r: const(Ector.Renderer); [[Ector fill renderer]]
 	 }
       }
       @property stroke_fill {
+      	 [[Stroke fill property]]
          set {
 	 }
 	 get {
 	 }
 	 values {
-	    r: const(Ector.Renderer);
+	    r: const(Ector.Renderer); [[Ector stroke fill renderer]]
 	 }
       }
       @property stroke_marker {
+      	 [[Stroke marker property]]
          set {
 	 }
 	 get {
 	 }
 	 values {
-	    r: const(Ector.Renderer);
+	    r: const(Ector.Renderer); [[Ector stroke marker renderer]]
 	 }
       }
    }
diff --git a/src/lib/ector/ector_surface.eo b/src/lib/ector/ector_surface.eo
index da4eea44bd..228a2d130b 100644
--- a/src/lib/ector/ector_surface.eo
+++ b/src/lib/ector/ector_surface.eo
@@ -16,9 +16,9 @@ mixin Ector.Surface (Ector.Buffer)
       }
       renderer_factory_new @virtual_pure {
          [[Create a new renderer factory for the given type]]
-         return: Efl.Object; /* FIXME: Should be a more restricted type, only here for cyclic. */
+         return: Efl.Object; [[Renderer factory object]] /* FIXME: Should be a more restricted type, only here for cyclic. */
          params {
-            @in type: const(Efl.Class) @nonull; /* FIXME: Should probably be a more restricted type */
+            @in type: const(Efl.Class) @nonull; [[Efl class]] /* FIXME: Should probably be a more restricted type */
          }
       }
    }
diff --git a/src/lib/evas/include/evas_ector_buffer.eo b/src/lib/evas/include/evas_ector_buffer.eo
index 1edac4b64d..573351098b 100644
--- a/src/lib/evas/include/evas_ector_buffer.eo
+++ b/src/lib/evas/include/evas_ector_buffer.eo
@@ -4,6 +4,7 @@ import evas_canvas;
 
 interface Evas.Ector.Buffer
 {
+   [[Evas ector buffer interface]]
    methods {
       @property engine_image {
          get {}