[flexotask-commits] SF.net SVN: flexotask:[131] trunk/flexotask/src/com/ibm/realtime/flexotask/ scheduling/FlexotaskScheduler.java

[<jsa...@us...>]

Revision: 131
          http://flexotask.svn.sourceforge.net/flexotask/?rev=131&view=rev
Author:   jsauerbach
Date:     2009-02-12 23:41:53 +0000 (Thu, 12 Feb 2009)

Log Message:
-----------
Fix some comments.

Modified Paths:
--------------
    trunk/flexotask/src/com/ibm/realtime/flexotask/scheduling/FlexotaskScheduler.java

Modified: trunk/flexotask/src/com/ibm/realtime/flexotask/scheduling/FlexotaskScheduler.java
===================================================================
--- trunk/flexotask/src/com/ibm/realtime/flexotask/scheduling/FlexotaskScheduler.java	2009-02-11 19:05:19 UTC (rev 130)
+++ trunk/flexotask/src/com/ibm/realtime/flexotask/scheduling/FlexotaskScheduler.java	2009-02-12 23:41:53 UTC (rev 131)
@@ -44,7 +44,7 @@
   /**
    * Determine if an FlexotaskTemplate can be scheduled
    * @param toSchedule the specification to be checked.  This has already been found consistent and
-   *   type-valid by the main validator, which has also checked that no method violates exotask rules.
+   *   type-valid by the main validator, which has also checked that no method violates Flexotask rules.
    * @param schedulingData information that the scheduler may need to schedule the graph but
    *   that is not provided as timing information at graph specification time (for example, WCETs)
    * @return true if the specification is schedulable, false otherwise
@@ -56,15 +56,18 @@
    * @param toSchedule the specification to schedule.  This has already been found valid by the
    *   main validator and schedulable by this scheduler.
    * @param instantiationMap the map from FlexotaskTemplateElement elements within the
-   *   specification to the actual Runnables representing those elements in the FlexotaskTemplate being
+   *   specification to the actual Runnables representing those elements in the FlexotaskGraph being
    *   constructed
    * @param schedulingData information that the scheduler may need to schedule the graph but
    *   that is not provided as timing information within the graph (for example, WCETs)
    * @param threadFactory the FlexotaskThreadFactory to use in creating any threads that will
    *   actually call the Runnables in the instantiation map.  Important:  these runnables may
    *   ONLY be called by threads created by this thread factory.
-   * @param initializationMap the map from FlexotaskTemplateElement elements within the specification
-   *   to the initialization parameters, one of the uses is to transfer file descriptors to trigger actors.
+   * @param initializationMap the map from names of elements within the specification
+   *   to the initialization parameters, if any.  Note that this map uses names as keys, not the elements.
+   *   This allows the scheduler to inspect runtime information being
+   *   passed to individual Flexotasks.  For example, a reactive scheduler can share a file descriptor number with
+   *   an I/O task.
    * @return a new FlexotaskRunner for this set of Runnables under this specification
    * @throws FlexotaskValidationException if a failure occurs during scheduling.
    */


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.