E SVN: sachiel IN trunk/ecore: doc/img src/lib/ecore

[Enlightenment S. <no-...@en...>]

Log:
Diagrams for Ecore_Thread
  
  

Author:       sachiel
Date:         2011-07-19 09:58:15 -0700 (Tue, 19 Jul 2011)
New Revision: 61507
Trac:         http://trac.enlightenment.org/e/changeset/61507

Added:
  trunk/ecore/doc/img/ecore_thread.eps trunk/ecore/doc/img/ecore_thread.png trunk/ecore/doc/img/ecore_thread_feedback.eps trunk/ecore/doc/img/ecore_thread_feedback.png 
Modified:
  trunk/ecore/src/lib/ecore/Ecore.h 


Property changes on: trunk/ecore/doc/img/ecore_thread.png
___________________________________________________________________
Added: svn:mime-type
   + application/octet-stream


Property changes on: trunk/ecore/doc/img/ecore_thread_feedback.png
___________________________________________________________________
Added: svn:mime-type
   + application/octet-stream

Modified: trunk/ecore/src/lib/ecore/Ecore.h
===================================================================
--- trunk/ecore/src/lib/ecore/Ecore.h	2011-07-19 15:21:22 UTC (rev 61506)
+++ trunk/ecore/src/lib/ecore/Ecore.h	2011-07-19 16:58:15 UTC (rev 61507)
@@ -821,11 +821,27 @@
    * a thread as soon as one becomes available and notify the calling user of
    * its completion once the task is done.
    *
+   * The following image shows the flow of a program running four tasks on
+   * a pool of two threads.
+   *
+   * @image html ecore_thread.png
+   * @image rtf ecore_thread.png
+   * @image latex ecore_thread.eps width=\textwidth
+   *
    * For larger tasks that may require continuous communication with the main
    * program, the feedback workers provide the same functionality plus a way
    * for the function running in the thread to send messages to the main
    * thread.
    *
+   * The next diagram omits some details shown in the previous one regarding
+   * how threads are spawned and tasks are queued, but illustrates how feedback
+   * jobs communicate with the main loop and the special case of threads
+   * running out of pool.
+   *
+   * @image html ecore_thread_feedback.png
+   * @image rtf ecore_thread_feedback.png
+   * @image latex ecore_thread_feedback.eps width=\textwidth
+   *
    * See an overview example in @ref ecore_thread_example_c.
    *
    * @ingroup Ecore_Group