cedric pushed a commit to branch master.
http://git.enlightenment.org/core/efl.git/commit/?id=cee4d928cf94d9a97c8a21ac36483e6a70a0745c
commit cee4d928cf94d9a97c8a21ac36483e6a70a0745c
Author: Bryce Harrington <br...@osg.samsung.com>
Date: Mon May 8 15:25:12 2017 -0700
examples/evas: streamline the intro description statement for examples
Summary:
For people browing through the examples, having the opening statement be
concise and consistent will help them more quickly find what they're
looking for.
Signed-off-by: Bryce Harrington <br...@osg.samsung.com>
Test Plan:
Some of the examples had identical opening statements (e.g. the image
object examples). I've tried to give each a unique description defining
what they are demonstrating, but you may want to doublecheck I got these
correct. Of particular note, to me evas-images5.c looks like just a
fixup to evas-images4.c, so I'm not sure what makes these two distinct.
Subscribers: cedric, jpeg
Differential Revision: https://phab.enlightenment.org/D4861
Signed-off-by: Cedric BAIL <ced...@osg.samsung.com>
---
src/examples/evas/evas-3d-aabb.c | 2 +-
src/examples/evas/evas-3d-blending.c | 5 +++--
src/examples/evas/evas-3d-colorpick.c | 3 ++-
src/examples/evas/evas-3d-cube-rotate.c | 2 +-
src/examples/evas/evas-3d-cube.c | 2 +-
src/examples/evas/evas-3d-cube2.c | 3 +--
src/examples/evas/evas-3d-eet.c | 2 +-
src/examples/evas/evas-3d-fog.c | 2 +-
src/examples/evas/evas-3d-frustum.c | 3 ++-
src/examples/evas/evas-3d-hull.c | 8 +++++---
src/examples/evas/evas-3d-md2.c | 2 +-
src/examples/evas/evas-3d-mmap-set.c | 2 +-
src/examples/evas/evas-3d-obj.c | 3 ++-
src/examples/evas/evas-3d-parallax-occlusion.c | 2 +-
src/examples/evas/evas-3d-pick.c | 2 +-
src/examples/evas/evas-3d-ply.c | 2 +-
src/examples/evas/evas-3d-proxy.c | 2 +-
src/examples/evas/evas-3d-shadows.c | 3 +++
src/examples/evas/evas-3d-static-lod.c | 3 ++-
src/examples/evas/evas-aspect-hints.c | 2 +-
src/examples/evas/evas-box.c | 2 +-
src/examples/evas/evas-buffer-simple.c | 2 +-
src/examples/evas/evas-events.c | 3 +--
src/examples/evas/evas-gl.c | 2 +-
src/examples/evas/evas-hints.c | 6 ++++--
src/examples/evas/evas-images.c | 2 +-
src/examples/evas/evas-images2.c | 2 +-
src/examples/evas/evas-images3.c | 2 +-
src/examples/evas/evas-images4.c | 2 +-
src/examples/evas/evas-images5.c | 2 +-
src/examples/evas/evas-init-shutdown.c | 9 +++++----
src/examples/evas/evas-map-aa-eo.c | 3 +--
src/examples/evas/evas-map-aa.c | 3 +--
src/examples/evas/evas-map-utils-eo.c | 2 +-
src/examples/evas/evas-map-utils.c | 2 +-
src/examples/evas/evas-multi-touch.c | 2 +-
src/examples/evas/evas-multiseat-events.c | 4 +++-
src/examples/evas/evas-object-manipulation-eo.c | 5 +----
src/examples/evas/evas-object-manipulation.c | 2 +-
src/examples/evas/evas-smart-interface.c | 2 +-
src/examples/evas/evas-smart-object.c | 2 +-
src/examples/evas/evas-stacking.c | 3 +--
src/examples/evas/evas-table.c | 2 +-
src/examples/evas/evas-text.c | 2 +-
src/examples/evas/evas-textblock-obstacles.c | 2 +-
src/examples/evas/evas-transparent.c | 2 +-
src/examples/evas/evas-vg-batman.c | 2 +-
src/examples/evas/evas-vg-simple.c | 2 +-
48 files changed, 69 insertions(+), 62 deletions(-)
diff --git a/src/examples/evas/evas-3d-aabb.c b/src/examples/evas/evas-3d-aabb.c
index 15dc67f..3b91bff 100644
--- a/src/examples/evas/evas-3d-aabb.c
+++ b/src/examples/evas/evas-3d-aabb.c
@@ -1,5 +1,5 @@
/**
- * This example shows how to get and draw axis-aligned bounding box.
+ * Example of getting and drawing an axis-aligned bounding box in Evas-3D.
*
* @see _redraw_aabb();
* Rotate axes (keys 1-4) for model and bounding box view from another angle.
diff --git a/src/examples/evas/evas-3d-blending.c
b/src/examples/evas/evas-3d-blending.c
index 9997e8a..1c03cf2 100644
--- a/src/examples/evas/evas-3d-blending.c
+++ b/src/examples/evas/evas-3d-blending.c
@@ -1,5 +1,7 @@
/**
- * Example illustrating usage of blending modes. Press "Up" or "Down" key for
change source blending factor.
+ * Example of different blending modes in Evas-3D.
+ *
+ * Press "Up" or "Down" key for change source blending factor.
* Press "Left" or "Right" for change destination blending factors.
* For more details see
https://www.opengl.org/sdk/docs/man2/xhtml/glBlendFunc.xml
*
@@ -8,7 +10,6 @@
* @endverbatim
*/
-
#ifdef HAVE_CONFIG_H
#include "config.h"
#else
diff --git a/src/examples/evas/evas-3d-colorpick.c
b/src/examples/evas/evas-3d-colorpick.c
index 2b04e64..83dd623 100644
--- a/src/examples/evas/evas-3d-colorpick.c
+++ b/src/examples/evas/evas-3d-colorpick.c
@@ -1,5 +1,6 @@
/**
- * This example shows how to use color pick algorithm for finding node at
scene.
+ * Example of finding nodes by color or geometry in an Evas-3D scene.
+ *
* Enable color pick mode of meshes and scene objects.
* Click (left for color pick, right for geometry pick) on 3D object and see
* in terminal time response of the found node.
diff --git a/src/examples/evas/evas-3d-cube-rotate.c
b/src/examples/evas/evas-3d-cube-rotate.c
index 3e38bd0..e2946e9 100644
--- a/src/examples/evas/evas-3d-cube-rotate.c
+++ b/src/examples/evas/evas-3d-cube-rotate.c
@@ -1,5 +1,5 @@
/**
- * This example shows how the work of events with callback of the mouse could
be useful in node rotation.
+ * Example of using mouse callback events for node rotation in Evas-3D.
*
* After clicking the mouse on cube callbacks began to emit automatically,
* depending on mouse's position change the cube rotates with a certain
diff --git a/src/examples/evas/evas-3d-cube.c b/src/examples/evas/evas-3d-cube.c
index 49377cb..3d6bef1 100644
--- a/src/examples/evas/evas-3d-cube.c
+++ b/src/examples/evas/evas-3d-cube.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas-3D example illustrating how to create simple mesh without any
loading.
+ * Example of creating simple meshes in Evas-3D.
*
* This example is the best to start introduction to usage of Evas-3D.
*
diff --git a/src/examples/evas/evas-3d-cube2.c
b/src/examples/evas/evas-3d-cube2.c
index a9d69f2..8c7cbd3 100644
--- a/src/examples/evas/evas-3d-cube2.c
+++ b/src/examples/evas/evas-3d-cube2.c
@@ -1,6 +1,5 @@
/**
- * Simple Evas-3D example illustrating usage of normal mapping and animation
created
- * by interpolation between frames.
+ * Example of frame interpolation animation with normal mapping in Evas 3D.
*
* @verbatim
* gcc -o evas-3d-cube2 evas-3d-cube2.c `pkg-config --libs --cflags efl evas
ecore ecore-evas eo` -lm
diff --git a/src/examples/evas/evas-3d-eet.c b/src/examples/evas/evas-3d-eet.c
index 1a17f66..b99b2ce 100644
--- a/src/examples/evas/evas-3d-eet.c
+++ b/src/examples/evas/evas-3d-eet.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating .eet import/export
+ * Example of .eet file format import/export in Evas-3D.
*
* Take mesh from md2.
* Set material to it.
diff --git a/src/examples/evas/evas-3d-fog.c b/src/examples/evas/evas-3d-fog.c
index 1000aee..f675638 100644
--- a/src/examples/evas/evas-3d-fog.c
+++ b/src/examples/evas/evas-3d-fog.c
@@ -1,5 +1,5 @@
/**
- * Example illustrating usage of fog effect.
+ * Example of applying a fog effect in Evas-3D.
*
* @verbatim
* gcc -o evas-3d-fog evas-3d-fog.c `pkg-config --libs --cflags efl evas ecore
ecore-evas eo` -lm
diff --git a/src/examples/evas/evas-3d-frustum.c
b/src/examples/evas/evas-3d-frustum.c
index a9b60fb..7515dad 100644
--- a/src/examples/evas/evas-3d-frustum.c
+++ b/src/examples/evas/evas-3d-frustum.c
@@ -1,5 +1,6 @@
/**
- * This example shows how to work frustum culling.
+ * Example of frustum culling in Evas-3D.
+ *
* Use 'w'/'s' key to move far frustum plane from/to the camera.
* Use 't'/'g' key to move near frustum plane from/to the camera.
* Use '1'/'2' key to set camera to the first/second position.
diff --git a/src/examples/evas/evas-3d-hull.c b/src/examples/evas/evas-3d-hull.c
index 2c35490..b741599 100644
--- a/src/examples/evas/evas-3d-hull.c
+++ b/src/examples/evas/evas-3d-hull.c
@@ -1,7 +1,9 @@
/**
- * This example is a testing example, first model (from the right side) is
- * original model, the second one is convex hull made in evas-3d,
- * the third one is convex hull made in blender.
+ * Example to test convex hull models made in Evas-3D vs. Blender.
+ *
+ * The first model (from the right side) is the original model, the
+ * second one is a convex hull made in Evas-3D, and the third one is a
+ * convex hull made in Blender.
*
* Press "Right" or "Left" to switch models, the result of test (vertex count)
* will be printed in console window.
diff --git a/src/examples/evas/evas-3d-md2.c b/src/examples/evas/evas-3d-md2.c
index 36354ce..d01f19b 100644
--- a/src/examples/evas/evas-3d-md2.c
+++ b/src/examples/evas/evas-3d-md2.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas-3D example illustrating import from .md2 format.
+ * Example of .md2 file format import in Evas-3D.
*
* @verbatim
* gcc -o evas-3d-md2 evas-3d-md2.c `pkg-config --libs --cflags efl evas ecore
ecore-evas eo`
diff --git a/src/examples/evas/evas-3d-mmap-set.c
b/src/examples/evas/evas-3d-mmap-set.c
index 36ee9b7..50d0e9a 100644
--- a/src/examples/evas/evas-3d-mmap-set.c
+++ b/src/examples/evas/evas-3d-mmap-set.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating import from mmap.
+ * Example of mmap import in Evas-3D.
*
* Open files to Eina_Files.
* Read meshes from Eina_Files.
diff --git a/src/examples/evas/evas-3d-obj.c b/src/examples/evas/evas-3d-obj.c
index 262dc9e..3b96e22 100644
--- a/src/examples/evas/evas-3d-obj.c
+++ b/src/examples/evas/evas-3d-obj.c
@@ -1,5 +1,6 @@
/**
- * Simple Evas example illustrating import/export of .obj format.
+ * Example of .obj file format import in Evas-3D.
+ *
* Example demonstrates possibility to load and save mesh without tex_coords
or/and normals.
*
* Read mesh from "sweet_home(parameters).obj".
diff --git a/src/examples/evas/evas-3d-parallax-occlusion.c
b/src/examples/evas/evas-3d-parallax-occlusion.c
index 764f824..457c697 100644
--- a/src/examples/evas/evas-3d-parallax-occlusion.c
+++ b/src/examples/evas/evas-3d-parallax-occlusion.c
@@ -1,5 +1,5 @@
/**
- * Example illustrating usage of parallax occlusion shading and texture
animation.
+ * Example of parallax occlusion shading and texture animation in Evas-3D.
*
* Press "n" for use normal mapping shading. Pres "p" for use parallax
occlusion mapping shading.
*
diff --git a/src/examples/evas/evas-3d-pick.c b/src/examples/evas/evas-3d-pick.c
index 095c43a..c57a960 100644
--- a/src/examples/evas/evas-3d-pick.c
+++ b/src/examples/evas/evas-3d-pick.c
@@ -1,5 +1,5 @@
/**
- * This example shows how to attach mechanism of pick.
+ * Example of picking nodes and meshes by screen coordinates using Evas-3D.
*
* Here shown which transformation should be applied to event_info of
* _on_mouse_down to make them usable in evas_canvas3d_scene_pick()
diff --git a/src/examples/evas/evas-3d-ply.c b/src/examples/evas/evas-3d-ply.c
index 6a5c748..0445fc6 100644
--- a/src/examples/evas/evas-3d-ply.c
+++ b/src/examples/evas/evas-3d-ply.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating import/export of .ply format.
+ * Example of .ply file format import/export in Evas-3D.
*
* Read meshes from "tested_man_all_with_mods.ply",
"tested_man_only_geometry.ply" and "tested_man_without_UVs.ply".
* After that change some properties of material.
diff --git a/src/examples/evas/evas-3d-proxy.c
b/src/examples/evas/evas-3d-proxy.c
index d0be4f3..d73e806 100644
--- a/src/examples/evas/evas-3d-proxy.c
+++ b/src/examples/evas/evas-3d-proxy.c
@@ -1,5 +1,5 @@
/**
- * Evas-3D example illustrating usage of evas_canvas3d_texture_source_set()
+ * Example of setting the texture source of an object in Evas-3D.
*
* Data which will be used as texture can be generated directly in application.
*
diff --git a/src/examples/evas/evas-3d-shadows.c
b/src/examples/evas/evas-3d-shadows.c
index b1f5ba9..e145404 100644
--- a/src/examples/evas/evas-3d-shadows.c
+++ b/src/examples/evas/evas-3d-shadows.c
@@ -1,6 +1,9 @@
/**
+ * Example of setting up an animated Evas-3D scene with lighting and
anti-aliasing.
+ *
* This example illustrates use of shadows, callbacks(clicked, collision),
* technic of the billboard and post proccesing render with anti-aliasing.
+ *
* Model and cube are clickable. Model detects collision with sphere.
* Cube detects collision with sphere, model and cone. Model and cude are
moveable.
* @see evas_canvas3d_scene_shadows_enable_set(Eina_Bool _shadows_enabled)
diff --git a/src/examples/evas/evas-3d-static-lod.c
b/src/examples/evas/evas-3d-static-lod.c
index 0a77503..81dc993 100644
--- a/src/examples/evas/evas-3d-static-lod.c
+++ b/src/examples/evas/evas-3d-static-lod.c
@@ -1,5 +1,6 @@
/**
- * This example illustrates using static LOD technic.
+ * Example of static LOD techniques in Evas-3D.
+ *
* Main idea using several meshes with different quantity of polygons,
* render mesh depends on distance to the camera node.
* Use key up/down to change animtion style:
diff --git a/src/examples/evas/evas-aspect-hints.c
b/src/examples/evas/evas-aspect-hints.c
index f5caf43..f05a932 100644
--- a/src/examples/evas/evas-aspect-hints.c
+++ b/src/examples/evas/evas-aspect-hints.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating aspect control hints on objects.
+ * Example of aspect control hints on objects in Evas.
*
* You'll need at least one engine built for it (excluding the buffer
* one) and the png image loader also built. See stdout/stderr for
diff --git a/src/examples/evas/evas-box.c b/src/examples/evas/evas-box.c
index b6472d6..0193c6d 100644
--- a/src/examples/evas/evas-box.c
+++ b/src/examples/evas/evas-box.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating a custom Evas box object
+ * Example of custom box objects in Evas.
*
* You'll need at least one engine built for it (excluding the buffer
* one). See stdout/stderr for output.
diff --git a/src/examples/evas/evas-buffer-simple.c
b/src/examples/evas/evas-buffer-simple.c
index ea25e93..e2d02e9 100644
--- a/src/examples/evas/evas-buffer-simple.c
+++ b/src/examples/evas/evas-buffer-simple.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example using the Buffer engine.
+ * Example of using the buffer engine in Evas.
*
* You must have Evas compiled with the buffer engine, and have the
* evas-software-buffer pkg-config files installed.
diff --git a/src/examples/evas/evas-events.c b/src/examples/evas/evas-events.c
index 6a978e5..5c4bae2 100644
--- a/src/examples/evas/evas-events.c
+++ b/src/examples/evas/evas-events.c
@@ -1,6 +1,5 @@
/**
- * Simple Evas example illustrating how to interact with canvas' (and
- * its objects') events and other canvas operations.
+ * Example of using callbacks to interact with the canvas and its objects in
Evas.
*
* You'll need at least one engine built for it (excluding the buffer
* one) and the png image loader also built. See stdout/stderr for
diff --git a/src/examples/evas/evas-gl.c b/src/examples/evas/evas-gl.c
index a11a51f..9bcfdca 100644
--- a/src/examples/evas/evas-gl.c
+++ b/src/examples/evas/evas-gl.c
@@ -1,5 +1,5 @@
/**
- * Evas example illustrating work with GL APIs.
+ * Example of working with OpenGL APIs in Evas.
*
* Evas_GL.h should be added for Evas GL APIs access.
*
diff --git a/src/examples/evas/evas-hints.c b/src/examples/evas/evas-hints.c
index c9480e4..1dfb35f 100644
--- a/src/examples/evas/evas-hints.c
+++ b/src/examples/evas/evas-hints.c
@@ -1,6 +1,8 @@
/**
- * Simple Evas example illustrating <b>alignment, minimum size, maximum
- * size, padding and weight</b> hints on objects.
+ * Example of setting hints on objects in Evas.
+ *
+ * Object hints shown include <b>alignment, minimum size, maximum size,
+ * padding and weight</b>.
*
* To exemplify those hints, whe use the Evas box object, one of the
* managers using size hints to layout its children.
diff --git a/src/examples/evas/evas-images.c b/src/examples/evas/evas-images.c
index c20d250..8b9bfca 100644
--- a/src/examples/evas/evas-images.c
+++ b/src/examples/evas/evas-images.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating some image objects functions
+ * Example of changing fills and borders for image objects in Evas.
*
* You'll need at least one engine built for it (excluding the buffer
* one) and the png image loader also built. See stdout/stderr for
diff --git a/src/examples/evas/evas-images2.c b/src/examples/evas/evas-images2.c
index 58ffc37..60f0563 100644
--- a/src/examples/evas/evas-images2.c
+++ b/src/examples/evas/evas-images2.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating some image objects functions
+ * Example of handling events for image objects in Evas.
*
* You'll need at least one engine built for it (excluding the buffer
* one) and the png image loader/saver also built. See stdout/stderr
diff --git a/src/examples/evas/evas-images3.c b/src/examples/evas/evas-images3.c
index fcbaa87..51e6ecb 100644
--- a/src/examples/evas/evas-images3.c
+++ b/src/examples/evas/evas-images3.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating some image objects functions
+ * Example saving data for modified image objects to disk with Evas.
*
* You'll need at least one engine built for it (excluding the buffer
* one) and the png image loader/saver also built. See stdout/stderr
diff --git a/src/examples/evas/evas-images4.c b/src/examples/evas/evas-images4.c
index d8b221d..94b2eeb 100644
--- a/src/examples/evas/evas-images4.c
+++ b/src/examples/evas/evas-images4.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating some image objects functions
+ * Example of rotating and flipping image objects in Evas.
*
* You'll need at least one engine built for it (excluding the buffer
* one) and the png image loader/saver also built. See stdout/stderr
diff --git a/src/examples/evas/evas-images5.c b/src/examples/evas/evas-images5.c
index 289cd8a..51b67f2 100644
--- a/src/examples/evas/evas-images5.c
+++ b/src/examples/evas/evas-images5.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating some image objects functions
+ * Example of rotating and flipping image objects in Evas.
*
* You'll need at least one engine built for it (excluding the buffer
* one) and the png image loader/saver also built. See stdout/stderr
diff --git a/src/examples/evas/evas-init-shutdown.c
b/src/examples/evas/evas-init-shutdown.c
index 3d1adfd..40263ce 100644
--- a/src/examples/evas/evas-init-shutdown.c
+++ b/src/examples/evas/evas-init-shutdown.c
@@ -1,8 +1,9 @@
/**
- * Simple example illustrating usage of evas_init() and
- * evas_shutdown(). Usually one would instantiate a canvas to have
- * something useful out of Evas. For an example of this kind, see the
- * @ref Example_Evas_Buffer_Simple.
+ * Example of initializing and shutting down Evas.
+ *
+ * Usually one would instantiate a canvas to have something useful out
+ * of Evas. For an example of this kind, see the @ref
+ * Example_Evas_Buffer_Simple.
*
* Here, we are just listing the engine Evas was compiled with support
* to.
diff --git a/src/examples/evas/evas-map-aa-eo.c
b/src/examples/evas/evas-map-aa-eo.c
index 00a5bfd..12bcdfe 100644
--- a/src/examples/evas/evas-map-aa-eo.c
+++ b/src/examples/evas/evas-map-aa-eo.c
@@ -1,6 +1,5 @@
/**
- * Example showing the difference between Evas Map with and without
- * anti-aliasing (AA).
+ * Example comparing map with and without anti-aliasing (AA) with an Eo-styled
Evas API.
*
* @verbatim
* gcc -o evas_map_aa_eo evas-map-aa-eo.c `pkg-config --libs --cflags evas
ecore ecore-evas eina`
diff --git a/src/examples/evas/evas-map-aa.c b/src/examples/evas/evas-map-aa.c
index 61413e9..3e65606 100644
--- a/src/examples/evas/evas-map-aa.c
+++ b/src/examples/evas/evas-map-aa.c
@@ -1,6 +1,5 @@
/**
- * Example showing the difference between Evas Map with and without
- * anti-aliasing (AA).
+ * Example comparing map with and without anti-aliasing (AA) in Evas.
*
* @verbatim
* gcc -o evas-map-aa evas-map-aa.c `pkg-config --libs --cflags evas ecore
ecore-evas eina`
diff --git a/src/examples/evas/evas-map-utils-eo.c
b/src/examples/evas/evas-map-utils-eo.c
index 0894518..adf23a3 100644
--- a/src/examples/evas/evas-map-utils-eo.c
+++ b/src/examples/evas/evas-map-utils-eo.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating basic map utils.
+ * Example of basic map utils with an Eo-styled Evas API.
*
* You'll need at least one engine built for it (excluding the buffer
* one). See stdout/stderr for output.
diff --git a/src/examples/evas/evas-map-utils.c
b/src/examples/evas/evas-map-utils.c
index 766cf11..1ea9015 100644
--- a/src/examples/evas/evas-map-utils.c
+++ b/src/examples/evas/evas-map-utils.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating basic map utils.
+ * Example of basic map utils in Evas.
*
* You'll need at least one engine built for it (excluding the buffer
* one). See stdout/stderr for output.
diff --git a/src/examples/evas/evas-multi-touch.c
b/src/examples/evas/evas-multi-touch.c
index 083e3cb..51543ce 100644
--- a/src/examples/evas/evas-multi-touch.c
+++ b/src/examples/evas/evas-multi-touch.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating usage of multi touch.
+ * Example of multi-touch in Evas.
*
* You'll need at least one engine built for it (excluding the buffer
* one) and the png image loader also built.
diff --git a/src/examples/evas/evas-multiseat-events.c
b/src/examples/evas/evas-multiseat-events.c
index cc34322..260730a 100644
--- a/src/examples/evas/evas-multiseat-events.c
+++ b/src/examples/evas/evas-multiseat-events.c
@@ -1,5 +1,7 @@
/**
- * Evas example illustrating how to handle events with multiseat information:
+ * Example of handling events with multiseat information in Evas.
+ *
+ * Illustrates handling of:
* * mouse events
* * keyboard events
* * focus events
diff --git a/src/examples/evas/evas-object-manipulation-eo.c
b/src/examples/evas/evas-object-manipulation-eo.c
index 4c5c444..a8dc9eb 100644
--- a/src/examples/evas/evas-object-manipulation-eo.c
+++ b/src/examples/evas/evas-object-manipulation-eo.c
@@ -1,8 +1,5 @@
/**
- * Porting evas-object-manipulation.c example
- * to use Eo-styled Evas API.
- *
- * Simple Evas example illustrating basic objects manipulation.
+ * Example of basic object manipulation with an Eo-styled Evas API.
*
* You'll need at least one engine built for it (excluding the buffer
* one) and the png image loader also built. See stdout/stderr for
diff --git a/src/examples/evas/evas-object-manipulation.c
b/src/examples/evas/evas-object-manipulation.c
index 48763db..9f37467 100644
--- a/src/examples/evas/evas-object-manipulation.c
+++ b/src/examples/evas/evas-object-manipulation.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating basic objects manipulation.
+ * Example of basic object manipulation in Evas.
*
* You'll need at least one engine built for it (excluding the buffer
* one) and the png image loader also built. See stdout/stderr for
diff --git a/src/examples/evas/evas-smart-interface.c
b/src/examples/evas/evas-smart-interface.c
index 343842f..b6669c9 100644
--- a/src/examples/evas/evas-smart-interface.c
+++ b/src/examples/evas/evas-smart-interface.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating Evas smart interfaces
+ * Example of smart interfaces in Evas.
*
* You'll need at least one engine built for it (excluding the buffer
* one). See stdout/stderr for output.
diff --git a/src/examples/evas/evas-smart-object.c
b/src/examples/evas/evas-smart-object.c
index a419570..94f2188 100644
--- a/src/examples/evas/evas-smart-object.c
+++ b/src/examples/evas/evas-smart-object.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating a custom Evas smart object
+ * Example of custom smart objects in Evas.
*
* You'll need at least one engine built for it (excluding the buffer
* one). See stdout/stderr for output.
diff --git a/src/examples/evas/evas-stacking.c
b/src/examples/evas/evas-stacking.c
index 444e2b2..523d44e 100644
--- a/src/examples/evas/evas-stacking.c
+++ b/src/examples/evas/evas-stacking.c
@@ -1,6 +1,5 @@
/**
- * Simple Evas example illustrating <b>objects stacking</b> and
- * <b>canvas layers</b>.
+ * Example of <b>object stacking</b> and <b>canvas layers</b> in Evas.
*
* You'll need at least one engine built for it (excluding the buffer
* one) and the png image loader also built. See stdout/stderr for
diff --git a/src/examples/evas/evas-table.c b/src/examples/evas/evas-table.c
index f3f5d6c..71213a4 100644
--- a/src/examples/evas/evas-table.c
+++ b/src/examples/evas/evas-table.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating usage of table object.
+ * Example of table objects in Evas.
*
* You'll need at least one engine built for it (excluding the buffer
* one) and the png image loader also built.
diff --git a/src/examples/evas/evas-text.c b/src/examples/evas/evas-text.c
index f58563e..e88070c 100644
--- a/src/examples/evas/evas-text.c
+++ b/src/examples/evas/evas-text.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating text objects
+ * Example of text objects in Evas.
*
* You'll need at least one engine built for it (excluding the buffer
* one). See stdout/stderr for output.
diff --git a/src/examples/evas/evas-textblock-obstacles.c
b/src/examples/evas/evas-textblock-obstacles.c
index c466775..fa60e0f 100644
--- a/src/examples/evas/evas-textblock-obstacles.c
+++ b/src/examples/evas/evas-textblock-obstacles.c
@@ -1,5 +1,5 @@
/**
- * Evas textblock example for obstacles feature
+ * Example of textblock obstacles in Evas.
*
* You'll need at least one engine built for it (excluding the buffer
* one). See stdout/stderr for output.
diff --git a/src/examples/evas/evas-transparent.c
b/src/examples/evas/evas-transparent.c
index 720d20d..fccecc2 100644
--- a/src/examples/evas/evas-transparent.c
+++ b/src/examples/evas/evas-transparent.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating a trasnparent window
+ * Example of transparent windows in Evas.
*
* @verbatim
* gcc -o evas-transparent evas-transparent.c `pkg-config --libs --cflags evas
ecore ecore-evas eina`
diff --git a/src/examples/evas/evas-vg-batman.c
b/src/examples/evas/evas-vg-batman.c
index c125b24..b9990a7 100644
--- a/src/examples/evas/evas-vg-batman.c
+++ b/src/examples/evas/evas-vg-batman.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating the use of Evas_VG animation
+ * Example of animation using Evas_VG.
*
* You'll need at least one engine built for it (excluding the buffer
* one). See stdout/stderr for output.
diff --git a/src/examples/evas/evas-vg-simple.c
b/src/examples/evas/evas-vg-simple.c
index 9524e94..da02ec5 100644
--- a/src/examples/evas/evas-vg-simple.c
+++ b/src/examples/evas/evas-vg-simple.c
@@ -1,5 +1,5 @@
/**
- * Simple Evas example illustrating a Evas_VG basic node usage.
+ * Example of basic nodes in Evas_VG.
*
* You'll need at least one engine built for it (excluding the buffer
* one). See stdout/stderr for output.
--
