* Major changes on IOStatus update / propagation

[bbtk.git] / kernel / src / bbtkAtomicBlackBox.h

diff --git a/kernel/src/bbtkAtomicBlackBox.h b/kernel/src/bbtkAtomicBlackBox.h
index 34d85078ccb7528fabc8e1ece6fdb693be19e22f..9a00b95c555e4e2e6eab1b4662712eb961d22b52 100644 (file)
--- a/kernel/src/bbtkAtomicBlackBox.h
+++ b/kernel/src/bbtkAtomicBlackBox.h
@@ -2,8 +2,8 @@
   Program:   bbtk
   Module:    $RCSfile: bbtkAtomicBlackBox.h,v $
   Language:  C++
-  Date:      $Date: 2008/11/25 11:17:13 $
-  Version:   $Revision: 1.6 $
+  Date:      $Date: 2008/12/08 12:53:39 $
+  Version:   $Revision: 1.7 $
 =========================================================================*/
 
 /* ---------------------------------------------------------------------
@@ -130,15 +130,11 @@ namespace bbtk
     //==================================================================   
     /// Recursive pipeline processing in backward direction 
     /// (recursion is in backward direction however execution always goes forward).
-    /// 
-    /// \returns The final status of the box (UPTODATE or MODIFIED)
-    ///
-    /// First checks that re-processing is needed (either Status==MODIFIED or InputProcessMode==Always)
-    /// then : 
-    /// - updates its inputs by calling bbUpdateInputs (which recursively calls bbBackwardUpdate on upstream boxes)
-    /// - calls bbProcess which here simply calls the user callback bbUserProcess which does the actual processing. 
-    ///    bbProcess is overloaded in WxBlackBox to handle widget creation and show
-    virtual IOStatus bbBackwardUpdate(Connection::Pointer caller);
+    /// - updates its inputs by calling bbUpdateInputs (which recursively calls bbBackwardUpdate on amont boxes if needed)
+    /// - if the return value of bbUpdateInputs is not UPTODATE 
+    ///    - calls bbProcess
+    ///    - calls bbComputePostProcessStatus
+    virtual void bbBackwardUpdate(Connection::Pointer caller);
     //==================================================================
 
     //==================================================================